Skip to content

Files

Latest commit

6c3ab1b · May 31, 2017

History

History
47 lines (32 loc) · 2.41 KB

install.md

File metadata and controls

47 lines (32 loc) · 2.41 KB

Dependencies

  • Draft will need a running Kubernetes cluster to deploy your app. Minikube is a great free option.
  • Draft expects Helm to be installed on your Kubernetes cluster. Download helm v2.4.x and do a helm init first, as described in Installing Helm.
  • Draft needs to push images to a Docker registry, so you'll need to configure Draft with your Docker registry credentials. If don't already have one, you can create a Docker registry for free on either Dockerhub.com or Quay.io.
  • An ingress controller installed within your Kubernetes cluster with a wildcard domain pointing to it. Review the Ingress Guide for more information about what Draft expects and how to set up an ingress controller.

Install Draft

Because Draft is currently experimental, there is no stable release out yet and users are expected to be using the latest build of Draft for testing. Canary releases of the Draft client can be found at the following links:

Unpack the Draft binary and add it to your PATH.

Configure Draft

To install the server-side of Draft, use draft init with your ingress' basedomain and credentials to let Draft communicate with a Docker registry by using the following command:

$ draft init --set registry.url=docker.io,registry.org=changeme,registry.authtoken=changeme,basedomain=changeme

The auth token field follows the format of Docker's X-Registry-Auth header. For credential-based logins such as Docker Hub and Quay, use:

$ echo '{"username":"jdoe","password":"secret","email":"[email protected]"}' | base64

For token-based logins such as Google Container Registry and Amazon ECR, use:

$ echo '{"registrytoken":"9cbaf023786cd7"}' | base64

Take Draft for a Spin

Once you've completed the above steps, you're ready to climb aboard and explore the Getting Started Guide - you'll soon be sailing!