github.com/SupersunnySea/draft@v0.16.0/docs/quickstart.md (about) 1 # Quickstart Guide 2 3 This guide covers how you can quickly get started using Draft 4 5 ## Prerequisites 6 7 The following prerequisites are required for successful use of Draft. 8 9 1. A Kubernetes cluster and the `kubectl` CLI tool 10 2. Installation of [Helm](https://github.com/Kubernetes/helm) on your Kubernetes cluster 11 3. Installing and configuring Draft on your laptop 12 13 ### Install Kubernetes or have access to a cluster 14 - If you don't already have a running Kubernetes cluster, consider downloading and installing [Minikube](https://github.com/kubernetes/minikube) which can help you get a Kubernetes cluster running on your local machine 15 - You can download and configure the `kubectl` binary using the directions [here](https://kubernetes.io/docs/tasks/tools/install-kubectl/) 16 17 ### Install and configure Helm 18 - Helm is a package manager for Kubernetes. It allows you to install and manage packages of Kubernetes manifests, more commonly known as "charts", on your Kubernetes cluster. 19 - Download the Helm binary using [Homebrew](https://brew.sh/) via `brew install kubernetes-helm` or the [official releases page](https://github.com/kubernetes/helm/releases). 20 - Once you have Helm on your machine and a running Kubernetes cluster, run the following command: 21 ```console 22 $ helm init 23 ``` 24 25 ### Install and configure Draft 26 27 #### Standalone Binary 28 29 Download the latest release of Draft from the [latest releases page](https://github.com/Azure/draft/releases/latest), unpack the binary and place it somewhere on your $PATH. 30 31 For example, for the v0.14.1 release, this can be done via 32 33 ```console 34 $ wget https://azuredraft.blob.core.windows.net/draft/draft-v0.14.1-linux-amd64.tar.gz 35 $ wget https://azuredraft.blob.core.windows.net/draft/draft-v0.14.1-linux-amd64.tar.gz.sha256 36 ``` 37 38 Make sure to verify the contents have not been tampered with: 39 40 ```console 41 $ cat draft-v0.14.1-linux-amd64.tar.gz.sha256 42 $ shasum -a 256 draft-v0.14.1-linux-amd64.tar.gz 43 ``` 44 45 Then unpack it and place it on your $PATH: 46 47 ```console 48 $ tar -xzvf draft-v0.14.1-linux-amd64.tar.gz 49 $ sudo mv linux-amd64/draft /usr/local/bin/draft 50 ``` 51 52 Test it's working with 53 54 ```console 55 $ draft version 56 ``` 57 58 #### Homebrew 59 60 To install Draft on MacOS using [Homebrew](https://brew.sh/): 61 62 ```console 63 $ brew tap azure/draft 64 $ brew install azure/draft/draft 65 ``` 66 67 #### Chocolatey 68 69 To install Draft on Windows using [Chocolatey](https://chocolatey.org/): 70 71 ```console 72 $ choco install draft 73 ``` 74 75 IMPORTANT: this package is [currently being maintained by the community](https://chocolatey.org/packages/draft) and not by any of the core maintainers. Always make sure to verify the security and contents of any untrusted package from the internet you are not familiar with. 76 77 #### GoFish 78 79 To install Draft on Windows/MacOS/Linux using [GoFish](https://gofi.sh): 80 81 ```console 82 $ gofish install draft 83 ``` 84 85 #### Configure Draft 86 87 Once you've installed Draft, set it up on your machine by running: 88 89 ```console 90 $ draft init 91 $ eval $(minikube docker-env) 92 ``` 93 94 The `eval $(minikube docker-env)` command allows Draft to build images directly using Minikube's Docker daemon which lets you skip having to set up a remote/external container registry. 95 96 Congratulations! You're all set! Check out the [Getting Started](getting-started.md) page to see how to use Draft with a sample application.