You can use Rancher to create a cluster hosted in Microsoft Azure Kubernetes Service (AKS).

Prerequisites in the Microsoft Azure Portal

Obtain the following information from the Microsoft Azure Portal by completing how to Create Service Principal for Azure AD.

  • Your Subscription ID.
  • Your Tenant ID.
  • A Client ID and Client Secret.

Create the AKS Cluster

Use Rancher to set up and configure your Kubernetes cluster.

  1. From the Clusters page, click Add Cluster.

  2. Choose Azure Kubernetes Service.

  3. Enter a Cluster Name.

  4. Use Member Roles to configure user authorization for the cluster.

    • Click Add Member to add users that can access the cluster.
    • Use the Role drop-down to set permissions for each user.

  5. Use Cluster Options to choose the version of Kubernetes, what network provider will be used and if you want to enable project network isolation. To see more cluster options, click on Show advanced options.

  6. Complete the Account Access form using the output from your Service Principal. This information is used to authenticate with Azure.

  7. Use Nodes to provision each node in your cluster and choose a geographical region.

    Microsoft Documentation: How to create and use an SSH public and private key pair

  8. Click Create.

  9. Review your options to confirm they’re correct. Then click Create.


  • Your cluster is created and assigned a state of Provisioning. Rancher is standing up your cluster.
  • You can access your cluster after its state is updated to Active.
  • Active clusters are assigned two Projects, Default (containing the namespace default) and System (containing the namespaces cattle-system,ingress-nginx,kube-public and kube-system, if present).