k8s-extension-install

page_type	languages	products
sample	terraform`	azure-kubernetes-service azure-marketplace

Azure Kubernetes Service (AKS) Terraform sample

This sample provides a Terraform configuration to deploy kubernetes application azure-vote on Azure Kubernetes Service (AKS).

Prerequisites

• Terraform
• Azure CLI

Prepare the environment

• Initialize Terraform in the current directory by running the following command:

  terraform init

• There are 2 example tfvars files in the current directory. You can use them to deploy the application with different configurations.

  • azure-vote-without-config.tfvars - Deploy the application with default configuration for azure-vote.
  • azure-vote-with-config.tfvars - Deploy/update the application with custom configuration for azure-vote.

• Before you test run the sample tfvars files, you need to update the followings in the tfvars files:

  • cluster_name - The name of the AKS cluster.
  • resource_group_name - The name of the resource group where AKS cluster is located.
  • subscription_id - The subscription ID where AKS cluster is located.

Deploy the application

• Deploy the application with default configuration for azure-vote.

  terraform apply -var-file="azure-vote-without-config.tfvars"

• Deploy/update the application with custom configuration for azure-vote.

    terraform apply -var-file="azure-vote-with-config.tfvars"

Clean up the resources

• To clean up the resources, run the following command to delete the azure-vote application from your AKS cluster:

  terraform destroy -var-file="azure-vote-without-config.tfvars"

  or

  terraform destroy -var-file="azure-vote-with-config.tfvars"

Limitations

• Once you have deployed the application with configurations settings, you cannot use terraform to delete 1 of the existing configurations. You can instead use Azure portal (under Kubernetes service ->Extensions + applications) to remove the particular configuration settings.