| title | description | author | ms.author | ms.service | ms.topic | ms.date | ms.custom |
|---|---|---|---|---|---|---|---|
Draft extension for Azure Kubernetes Service (AKS) (preview) |
Install and use Draft on your Azure Kubernetes Service (AKS) cluster using the Draft extension. |
qpetraroia |
qpetraroia |
container-service |
article |
5/02/2022 |
devx-track-azurecli, build-spring-2022, event-tier1-build-2022 |
Draft is an open-source project that streamlines Kubernetes development by taking a non-containerized application and generating the Dockerfiles, Kubernetes manifests, Helm charts, Kustomize configurations, and other artifacts associated with a containerized application. Draft can also create a GitHub Action workflow file to quickly build and deploy applications onto any Kubernetes cluster.
Draft has the following commands to help ease your development on Kubernetes:
- draft create: Creates the Dockerfile and the proper manifest files.
- draft setup-gh: Sets up your GitHub OIDC.
- draft generate-workflow: Generates the GitHub Action workflow file for deployment onto your cluster.
- draft up: Sets up your GitHub OIDC and generates a GitHub Action workflow file, combining the previous two commands.
- If you don't have an Azure subscription, create a free account before you begin.
- Install the latest version of the Azure CLI and the aks-preview extension.
- If you don't have one already, you need to create an AKS cluster and an Azure Container Registry instance.
[!INCLUDE preview features callout]
# Install the aks-preview extension
az extension add --name aks-preview
# Update the extension to make sure you have the latest version installed
az extension update --name aks-preview
To create a Dockerfile, Helm chart, Kubernetes manifest, or Kustomize files needed to deploy your application onto an AKS cluster, use the draft create command:
az aks draft create
You can also run the command on a specific directory using the --destination flag:
az aks draft create --destination /Workspaces/ContosoAir
To use Draft, you have to register your application with GitHub using draft setup-gh. This step only needs to be done once per repository.
az aks draft setup-gh
After you create your artifacts and set up GitHub OIDC, you can generate a GitHub Action workflow file, creating an action that deploys your application onto your AKS cluster. Once your workflow file is generated, you must commit it into your repository in order to initiate the GitHub Action.
az aks draft generate-workflow
You can also run the command on a specific directory using the --destination flag:
az aks draft generate-workflow --destination /Workspaces/ContosoAir
draft up is a single command to accomplish GitHub OIDC setup and generate a GitHub Action workflow file for deployment. It effectively combines the draft setup-gh and draft generate-workflow commands, meaning it's most commonly used when getting started in a new repository for the first time, and only needs to be run once. Subsequent updates to the GitHub Action workflow file can be made using draft generate-workflow.
az aks draft up
You can also run the command on a specific directory using the --destination flag:
az aks draft up --destination /Workspaces/ContosoAir
Web Application Routing is the easiest way to get your web application up and running in Kubernetes securely, removing the complexity of ingress controllers and certificate and DNS management while offering configuration for enterprises looking to bring their own. Web Application Routing offers a managed ingress controller based on nginx that you can use without restrictions and integrates out of the box with Open Service Mesh to secure intra-cluster communications.
To set up Draft with Web Application Routing, use az aks draft update and pass in the DNS name and Azure Key Vault-stored certificate when prompted:
az aks draft update
You can also run the command on a specific directory using the --destination flag:
az aks draft update --destination /Workspaces/ContosoAir