Use Azure Kubernetes Service on Azure Stack Hub in the portal

You can use the Azure Stack Hub user portal, in the Azure Kubernetes Service (AKS), to discover, create, scale, upgrade, and delete AKS clusters.

Verify your resource providers

You will need to have the Microsoft.ContainerService resource provider available for your subscription. To find the services available in your subscription:

  1. Sign in to the Azure Stack user portal. Select All services > Resource Explorer in the General group.

    Check for the Microsoft.ContainerService resource provider.

  2. In the Resource Explorer, find the Microsoft.ContainerService.

    Check for the Microsoft.ContainerService in the Resource explorer.

  3. If your subscription doesn't have Microsoft.ContainerService, you will need to have your cloud operator add the resource provider to your subscription, or you will need to subscribe to a subscription with the provider. Contact your cloud operator.

Discover available AKS clusters

  1. In the Azure Stack tenant portal, find All Services, and select Kubernetes services.

    This is the Azure Stack tenant portal.

  2. Verify that all clusters that you have created appear in Kubernetes service:

    Verify the clusters that you have created in the portal.

  3. Verify that you can view the details of any of the clusters:

    The portal contains the details of the AKS clusters.

Create cluster

  1. In Kubernetes services, select Add.

    You can select select add in the portal to add a cluster.

  2. Follow the steps to create an AKS cluster. The first step collects the basic cluster properties:

    Create an AKS cluster.

    Use a version of Kubernetes 1.20 or greater. For more information, see Applications deployed to AKS clusters fail to access persistent volumes.

  3. In Node pools you can see that only a single node pool is allowed in Azure Stack Hub:

    Open the Node pools blade.

  4. In Authentication, provide the service principal (SPN). The SPN won't be automatically generated as in Azure. Select the Configure service principal link and add the service principal. You can find the instructions to create one.

    Add the service principle.

  5. In Networking, select Azure CNI, and then continue to create the cluster.

    Add Azure CNI for networking

Scale cluster

  1. In cluster details, select Node pools, then select the node pool and select Scale

    Select scale cluster.

  2. In the scale panel on the right, select the new node count

    Select new node count.

Delete cluster

  1. In the overview for the AKS cluster, find and select Delete as in the image below.

    You can review the details of your cluster in the portal.

  2. Verify the cluster is deleted. Also, check that the associated resource group is deleted. In Resource groups, look for a resource group with the following pattern <…>_clustername_location. If a resource can't be found, it was properly deleted.

Next steps

Learn about AKS on Azure Stack Hub

  • Last updated on