Prerequisites

This guide assumes that your machine has the following tools installed:

  • az (2.51 or later)

  • kubectl (1.27 or later)

  • docker (as a non-root user)

  • terraform (1.0.0 or later)

  • anjuna-azure-cli (version 1.14.0002)

Azure permissions

This guide requires that you have a Contributor role in Azure, and can access the following services:

  • Azure Kubernetes Services (AKS)

  • Azure Container Registry (ACR)

  • Azure Storage Accounts

  • Azure Compute Galleries (also known as Shared Image Galleries)

Configure the environment and cluster access

If the Anjuna Kubernetes Toolset is not installed to your cluster, follow the cluster setup instructions in the Installing the Anjuna Kubernetes Toolset to your cluster section. This is required to proceed.

Refer to Verify the installation to verify if the Anjuna Kubernetes Toolset is correctly installed to your cluster.

Once the Anjuna Kubernetes Toolset is installed, you can configure your environment using the scripts included in the installer bundle. The scripts will use the Terraform output to set environment variables that are needed by anjuna-k8s-cli.

Configure your environment by running the following commands:

$ cd "${WORKSPACE}"
$ source ${WORKSPACE}/iac/azure/shared/env.sh
$ source ${WORKSPACE}/iac/azure/cluster/env.sh

Then, configure kubectl to point to your cluster. For example, to use the cluster provisioned by Terraform, run:

$ az aks get-credentials \
  --resource-group "${AZURE_AKS_RG}" \
  --name "${AZURE_CLUSTER_NAME}"