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.