Scroll Top

Setting up Kubernetes Cluster on Azure Container Service (AKS)

kubernetes cluster on azure

In this post, we’ll take you through the basics of setting up a Kubernetes Cluster on Azure Container Service (AKS), the Microsoft cloud service to manage your hosted Kubernetes environment. By the end of it, you’ll have a one node cluster up and running in AKS.

Install Azure CLI

You will need the Azure CLI version 2.0.21 or later installed and configured. Run az --version to find the version. If you need to install or upgrade, see Install Azure CLI.

To manage a Kubernetes cluster, you will need to install kubectl, the Kubernetes command-line client. You can install it by running the following command
coderiseio$ az aks install-cli
Downloading client to /usr/local/bin/kubectl from

Login to Microsoft Azure account

Sign in to your Microsoft Azure Portal or use Azure CLI command (recommended) i.e.
coderiseio$ az login

Create Kubernetes Cluster on Azure

For GUI, navigate to Azure Container Service(AKS) , click Create and follow prompts.

kubernetes cluster on Azure

But we will be using Azure CLI going forward 🙂

Create resource group for you cluster:
coderiseio$ az group create –name k8sResourceGroup –location eastus
“id”: “/subscriptions/bxxxxx-6xxx-4xxx-bxxx-kxxxx/resourceGroups/k8sResourceGroup”,
“location”: “eastus”,
“managedBy”: null,
“name”: “k8sResourceGroup”,
“properties”: {
“provisioningState”: “Succeeded”
“tags”: null
Next, Create Cluster by running the following command:
coderiseio$ az aks create –resource-group k8sResourceGroup –name crK8sCluster –node-count 1 –generate-ssh-keys
“agentPoolProfiles”: [
“count”: 1,
“dnsPrefix”: null,
“fqdn”: null,
“name”: “nodepool1”,
“osDiskSizeGb”: null,
“osType”: “Linux”,
“ports”: null,
“storageProfile”: “ManagedDisks”,
“vmSize”: “Standard_D1_v2”,
“vnetSubnetId”: null

“dnsPrefix”: “crK8sClust-k8sResourceGroup-bxxx”,
“fqdn”: “”,
“id”: “/subscriptions/bxxx-xxx-xxx-xxx/resourcegroups/k8sResourceGroup/providers/Microsoft.ContainerService/managedClusters/crK8sCluster”,
“kubernetesVersion”: “1.7.7”,
“linuxProfile”: {
“adminUsername”: “azureuser”,
“ssh”: {
“publicKeys”: [
“keyData”: “ssh-rsa AXXXX…\n”
“location”: “eastus”,
“name”: “crK8sCluster”,
“provisioningState”: “Succeeded”,
“resourceGroup”: “k8sResourceGroup”,
“servicePrincipalProfile”: {
“clientId”: “4xxx-xxx-xxx-xxx-xxx1”,
“keyVaultSecretRef”: null,
“secret”: null
“tags”: null,
“type”: “Microsoft.ContainerService/ManagedClusters”

Connect to the Cluster

Configure kubectl cli to point to your cluster
coderiseio$ az aks get-credentials –name crK8sCluster –resource-group k8sResourceGroup
Merged “crK8sCluster” as current context in /Users/coderiseio/.kube/config
Now, you should now be able to verify and view nodes in your cluster
coderiseio$ kubectl get nodes
NAME                       STATUS    ROLES     AGE       VERSION
aks-nodepool1-83619260-0   Ready     agent     14m       v1.7.7
That’s it! You are all set and ready to use your new Kubernetes cluster in AKS.

in the next post, we will demonstrate how to run applications in your new Kubernetes cluster on Azure.



Microsoft Docs

Related Posts

Comments (1)

[…] Setting up Kubernetes Cluster on Azure Container Service January 3, 2018 […]

Leave a comment