4.5 KiB
Install Guide for Minikube
Get started with Draft in three easy steps:
- Install CLI tools for Helm, Kubectl, Minikube and Draft
- Boot Minikube and install Tiller
- Deploy your first application
Note: This document uses a local image repository with minikube. To use Draft directly with a container registry service like https://hub.docker.com or another registry service, see the configuration steps in Drafting in the Cloud.
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 appropriate path in the Install Docker guide.
NOTE for Linux: Some distributions will require sudo for Docker usage. For this situation, you can either use sudo, or follow the instructions to manage docker as a non-root user. The choice is yours.
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:
Unpack the Draft binary and add it to your PATH.
Now that Draft has been installed, 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. For those who prefer to work in an enforced RBAC environment, be sure to follow the Helm Secure Configuration instructions.
The default installation of Helm 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 (the server side of Helm).
Configure Docker
For Minikube environments, configure Draft to build images directly using Minikube's Docker daemon, making the build process quick and redeployments speedy. To do this, run
$ eval $(minikube docker-env)
NOTE: You will be warned that no image registry has been set when you build and deploy your first application. Since docker builds on Minikube are immediately picked up by the Kubelet, you don't require a container registry and thus can safely disable this warning by following the instructions to do so.
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!
Cloud Setup
For more advanced users, Cloud installation documentation is also provided for
- configuring for remote image registries and Cloud providers
- running Tiller in a Kubernetes cluster with RBAC enabled
- running Tiller in a namespace other than kube-system