Skip to main content
Skip table of contents

Create a new AKS Cluster from the DKP UI

These pages refer to DKP Enterprise and DKP Gov Advanced products.

The DKP user interface allows you to provision an AKS cluster from your browser quickly and easily.


Create an AKS Infrastructure Provider

Before provisioning a cluster via the UI, first create an AKS infrastructure provider to hold your AKS credentials:

  1. Log in to the Azure command line:

    az login
  2. Create an Azure Service Principal (SP) by running the following command:

    az ad sp create-for-rbac --role contributor --name "$(whoami)-konvoy" --scopes=/subscriptions/$(az account show --query id -o tsv)
  3. Select Infrastructure Providers from the Dashboard menu.

  4. Select Add Infrastructure Provider.

  5. Choose a workspace. If you are already in a workspace, the provider is automatically created in that workspace.

  6. Select Microsoft Azure.

  7. Add a Name for your Infrastructure Provider.

  8. Take the id output from the log in command above and put it into the Subscription ID field.

  9. Take the tenant used in Step 2 and put it into the Tenant ID field.

  10. Take the appId used in Step 2 and put it into the Client ID field.

  11. Take the password used in Step 2 and put it into the Client Secret field.

  12. Select Save.

Provision an AKS Cluster

Follow these steps to provision an AKS cluster:

  1. From the top menu bar, select your target workspace.

  2. Select Clusters > Add Cluster.

  3. Choose Create Cluster.

  4. Enter the Cluster Name.

  5. From Select Infrastructure Provider, choose the provider created in the prerequisites section.

  6. In order to create a Kubernetes Version, run the command below in the az cli, and then select the version of AKS you want to use.

    az aks get-versions -o table --location <location>
  7. Select a data center location or specify a custom location.

  8. Edit your worker Node Pools, as necessary. You can choose the Number of Nodes, the Machine Type, and for the worker nodes, you can choose a Worker Availability Zone.

  9. Add any additional Labels or Infrastructure Provider Tags, as necessary.

  10. Validate your inputs, then select Create.

It can take up to 15 minutes for your cluster to appear in the Provisioned status.

You are then redirected to the Clusters page, where you’ll see your new cluster in the Provisioning status. Hover over the status to view the details.

Access an AKS Cluster

After the cluster is successfully attached (managed), you can retrieve a custom kubeconfig file from the UI using your DKP UI administrator credentials.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.