AKS Install

If not already done, refer to Get Started section of the documentation for:

• Resource Requirements

• Install Overview

• Prerequisites for Install

DKP Prerequisites

Before starting the DKP installation, verify that you have:

• An x86_64-based Linux or macOS machine with a supported version of the operating system.

• A Self-managed Azure cluster, if used Day 1-Basic Install for Azure instructions, your cluster was created using --self-managed flag and therefore is already a self-managed cluster.

• Download the dkp binary for Linux, or macOS. To check which version of DKP you installed for compatibility reasons, run the dkp version -h command (dkp version).

• Docker version 18.09.2 or later.

• kubectl for interacting with the running cluster.

• The Azure CLI.

• A valid Azure account used to sign in to the Azure CLI.

• All Resource requirements

AKS Prerequisites

Follow these steps:

1. Log in to Azure:

   az login

   CODE

    

   [
     {
       "cloudName": "AzureCloud",
       "homeTenantId": "a1234567-b132-1234-1a11-1234a5678b90",
       "id": "b1234567-abcd-11a1-a0a0-1234a5678b90",
       "isDefault": true,
       "managedByTenants": [],
       "name": "Mesosphere Developer Subscription",
       "state": "Enabled",
       "tenantId": "a1234567-b132-1234-1a11-1234a5678b90",
       "user": {
         "name": "user@azuremesosphere.onmicrosoft.com",
         "type": "user"
       }
     }
   ]
   

   CODE

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

   NOTE: If an SP with the name exists, this command will rotate the password.

   az ad sp create-for-rbac --role contributor --name "$(whoami)-konvoy" --scopes=/subscriptions/$(az account show --query id -o tsv)

   CODE

    

   {
     "appId": "7654321a-1a23-567b-b789-0987b6543a21",
     "displayName": "azure-cli-2021-03-09-23-17-06",
     "password": "Z79yVstq_E.R0R7RUUck718vEHSuyhAB0C",
     "tenant": "a1234567-b132-1234-1a11-1234a5678b90"
   }
   

   CODE

3. Set the required environment variables:

   export AZURE_SUBSCRIPTION_ID="<id>"       # b1234567-abcd-11a1-a0a0-1234a5678b90
   export AZURE_TENANT_ID="<tenant>"         # a1234567-b132-1234-1a11-1234a5678b90
   export AZURE_CLIENT_ID="<appId>"          # 7654321a-1a23-567b-b789-0987b6543a21
   export AZURE_CLIENT_SECRET="<password>"   # Z79yVstq_E.R0R7RUUck718vEHSuyhAB0C
   

   CODE

4. Base64 encode the same environment variables:

   export AZURE_SUBSCRIPTION_ID_B64="$(echo -n "${AZURE_SUBSCRIPTION_ID}" | base64 | tr -d '\n')"
   export AZURE_TENANT_ID_B64="$(echo -n "${AZURE_TENANT_ID}" | base64 | tr -d '\n')"
   export AZURE_CLIENT_ID_B64="$(echo -n "${AZURE_CLIENT_ID}" | base64 | tr -d '\n')"
   export AZURE_CLIENT_SECRET_B64="$(echo -n "${AZURE_CLIENT_SECRET}" | base64 | tr -d '\n')"
   

   CODE

5. Check to see what version of Kubernetes is available in your region. When deploying with AKS, you must declare the version of Kubernetes you want to use by running the following command, substituting <your-location> for the Azure region you're deploying to:

   az aks get-versions -o table --location <your-location>

   CODE

6. Set the version of Kubernetes you chose. The version listed in the command is an example:

   export KUBERNETES_VERSION=1.24.6

   CODE

Next Step:

AKS: Create Image