Skip to content

Latest commit

 

History

History
107 lines (68 loc) · 3.1 KB

install.md

File metadata and controls

107 lines (68 loc) · 3.1 KB
Raw

Install Guide

Get started with Draft in three easy steps:

  1. Install CLI tools for Helm, Kubectl, Minikube and Draft
  2. Boot Minikube and install Tiller
  3. Deploy your first application

Dependencies

In order to get started, you will need to have the following:

  • the latest release of minikube
  • the latest release of kubectl
  • the latest release of Helm
  • the latest release of Docker
  • A Docker repository for storing your images

All of the dependencies (except Docker) can be installed by the following:

$ brew cask install minikube

Docker can be installed following the Docker for Mac guide.

Install Draft

Afterwards, fetch the latest release of Draft.

Installing Draft via Homebrew can be done using

$ brew tap azure/draft
$ brew install draft

Canary releases of the Draft client can be found at the following links:

It can also be installed with

$ brew install draft-canary

Alternative downloads:

Unpack the Draft binary and add it to your PATH.

Now that Draft has been installed, we can set up Draft by running this command:

$ draft init

It will prepare DRAFT_HOME with a default set of packs, plugins and other directories required to get working with Draft.

Boot Minikube

At this point, you can boot up minikube!

$ minikube start
...
Kubectl is now configured to use the cluster.

Now that the cluster is up and ready, minikube automatically configures kubectl, the command line tool for Kubernetes, on your machine with the appropriate authentication and endpoint information.

$ kubectl cluster-info
Kubernetes master is running at https://192.168.99.100:8443

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

Install Helm

Install Helm, the Kubernetes Package Manager, in your cluster. Helm manages the lifecycle of an application in Kubernetes, and it is also how Draft deploys an application to Kubernetes.

Installing Helm and setting it up is quite simple:

$ helm init

Wait for Helm to come up and be in a Ready state. You can use kubectl -n kube-system get deploy tiller-deploy --watch to wait for tiller to come up.

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!

Advanced Setup

For more advanced users, advanced setup documentation is also provided for

  • running Tiller in a Kubernetes cluster with RBAC enabled
  • running Tiller in a namespace other than kube-system