Deploy a managed Kubernetes Cluster (AKS).

by holgerj
Last updated: 25/08/2020

This ARM template demonstrates the deployment of an AKS instance with advanced networking features into an existing virtual network. Additionally, the chosen Service Principal is assigned the Network Contributor role against the subnet that contains the AKS cluster.

This Azure Resource Manager (ARM) template was created by a member of the community and not by Microsoft. Each ARM template is licensed to you under a licence agreement by its owner, not Microsoft. Microsoft is not responsible for ARM templates provided and licensed by community members and does not screen for security, compatibility or performance. Community ARM templates are not supported under any Microsoft support programme or service, and are made available AS IS without warranty of any kind.


Parameter Name Description
resourceName The name of the Managed Cluster resource.
location The Azure location of the AKS resource.
dnsPrefix Optional DNS prefix to use with hosted Kubernetes API server FQDN.
osDiskSizeGB Disk size (in GB) to provision for each of the agent pool nodes. This value ranges from 0 to 1023. Specifying 0 will apply the default disk size for that agentVMSize.
agentCount The number of agent nodes for the cluster. Production workloads have a recommended minimum of 3.
agentVMSize The size of the Virtual Machine.
existingServicePrincipalObjectId Oject ID against which the Network Contributor roles will be assigned on the subnet
existingServicePrincipalClientId Client ID (used by cloudprovider)
existingServicePrincipalClientSecret The Service Principal Client Secret.
osType The type of operating system.
kubernetesVersion The version of Kubernetes.
enableHttpApplicationRouting boolean flag to turn on and off of http application routing
networkPlugin Network plugin used for building Kubernetes network.
maxPods Maximum number of pods that can run on a node.
enableRBAC boolean flag to turn on and off of RBAC
builtInRoleType Built-in role to assign
existingVirtualNetworkName Name of an existing VNET that will contain this AKS deployment.
existingVirtualNetworkResourceGroup Name of the existing VNET resource group
existingSubnetName Subnet name that will contain the App Service Environment
serviceCidr A CIDR notation IP range from which to assign service cluster IPs.
dnsServiceIP Containers DNS server IP address.
dockerBridgeCidr A CIDR notation IP for Docker bridge.

Use the template


New-AzResourceGroup -Name <resource-group-name> -Location <resource-group-location> #use this command when you need to create a new resource group for your deployment
New-AzResourceGroupDeployment -ResourceGroupName <resource-group-name> -TemplateUri
Installing and configuring Azure PowerShell

Command line

az group create --name <resource-group-name> --location <resource-group-location> #use this command when you need to create a new resource group for your deployment
az group deployment create --resource-group <my-resource-group> --template-uri
Installing and configuring the Azure cross-platform command-line interface