Quickstart: Set up Azure Kubernetes Service on Azure Stack HCI using Windows Admin Center

Applies to: Azure Stack HCI, Windows Server 2019 Datacenter

In this quickstart, you set up Azure Kubernetes Service on Azure Stack HCI using Windows Admin Center. To instead use PowerShell, see Set up with PowerShell.

Setting up involves the following tasks:

  • Set up Windows Admin Center
  • Set up an Azure Kubernetes Service host on the system you want to deploy the Kubernetes cluster to

Before getting started, make sure you have satisfied all the prerequisites on the system requirements page.

Setting up Windows Admin Center

The AKS on Azure Stack HCI extension for Windows Admin Center is natively available as part of the Windows Admin Center MSI. You can install Windows Admin Center either on a Windows 10 machine or on a server. If you have already installed Windows Admin Center, make sure your version is 2103.2 or later. You can check your Windows Admin Center version by clicking on the question mark on the top right hand corner.

Checks that you have the latest version of Windows Admin Center

Setting up an Azure Kubernetes Service host

You need to set up an Azure Kubernetes Service host on your Azure Stack HCI cluster before deploying AKS workload clusters. Setting up an AKS host is also referred to as setting up the platform services or management cluster.

Picture of an architecture diagram that highlights the platform services portion.

This system can be a Windows Server 2019 Datacenter cluster, a single node Windows Server 2019 Datacenter, or a 2-4 node Azure Stack HCI cluster.

Note

Setting up Azure Kubernetes Service hosts on two independent systems with the intention of merging them during Kubernetes cluster creation is not a supported scenario.

This set up can be done using the new Azure Kubernetes Service tool. This tool will install and download the necessary packages, as well as create an AKS host cluster that provides core Kubernetes services and orchestrates application workloads.

Now that we've verified our system settings, let's get started:

  1. Select Set up to launch the Setup wizard.

  2. Review the prerequisites for the machine you are running Windows Admin Center on, the cluster you're connected to, as well as the network. Additionally, make sure you're signed into an Azure account on Windows Admin Center and that the Azure subscription you're planning on using is not expired. You must have the Owner role on the subscription you are planning on using. When you're finished, select Next.

    Warning

    Make sure you have configured at least one external virtual switch before proceeding past this step, or you will not be able to successfully set up your Azure Kubernetes Service host.

  3. On the System checks page of the wizard, take any required actions, such as connecting your Windows Admin Center gateway to Azure. When connecting your Windows Admin Center gateway to Azure, be sure to create a new Azure Active Directory application. This step checks that Windows Admin Center and the system that will host Azure Kubernetes Service have the proper configurations to continue. When you're finished taking action, select Next.

  4. Ensure system connectivity through CredSSP in the Connectivity step. CredSSP lets Windows Admin Center delegate the user's credentials from the gateway to a target server for remote authentication. CredSSP needs to be enabled to set up Azure Kubernetes Service. After you've enabled CredSSP, select Next.

  5. Configure the machine that will host Azure Kubernetes Service in the Host configuration step. We recommend you select automatically download updates in this section. This step of the wizard asks you to configure the following details:

    • Host details, such as a name for the AKS host cluster and an image directory where VM images will be stored. The image directory must point to a shared storage path or an SMB share that is accessible by the host machine.
    • VM networking, which will apply to all Linux and Windows VMs (nodes) that are created to run containers and orchestrate container management. This includes the fields for the internet connected virtual switch, virtual LAN identification enablement, IP address allocation method, and Cloudagent IP. Cloudagent IP can be used to provide a static IP address to the CloudAgent service. This is applicable regardless of your IP address allocation selection. For additional details, see Kubernetes node networking. If you have selected the static IP address allocation method, there are a few additional fields that must be specified:
      • Subnet prefix, an IP address range that does not conflict with other addresses
      • Gateway, the gateway through which packets will be routed outside the machine
      • DNS servers, the comma-separated list of IP addresses for the DNS servers. Use a minimum of one and a maximum of three addresses.
      • Kubernetes node IP pool start, the pool start range for IP addresses used by Kubernetes clusters
      • Kubernetes node IP pool end, the pool end range for IP addresses used by Kubernetes clusters
    • Load balancer settings, which define the pool of addresses used for external services. If you have selected the static IP configuration in the VM Networking section, the address pool start and end must be within the subnet range specified in that section.

    Illustrates the Host configuration step of the Azure Kubernetes Service host wizard.

    Select Next after you're finished.

  6. On the Azure Registration page of the wizard, provide details about the subscription, resource group, and region you wish to use for this service. Your resource group will need to be in the East US, Southeast Asia, or West Europe region.

    Windows Admin Center requires permissions to access resources in your organization that only an admin can grant. Click View in Azure to view your Windows Admin Center gateway in Azure and confirm you have been granted admin consent for the following:

    • Azure Service Management - user_impersonation
    • Microsoft Graph - Application.ReadWrite.All
    • Microsoft Graph - Directory.AccessAsUser.All

    If you've been granted permissions, you'll see the permissions in green under Status as shown below:

    Illustrates that status is granted for the Windows Admin Center gateway.

    If you haven't been granted permissions, you may need the Azure subscription owner to manually grant admin consent.

    To add permissions:

    1. Click Add a permission in the top left corner.
    2. Select Microsoft Graph, and then select Delegated permissions.
    3. Search for Application.ReadWrite.All, and if necessary, expand the Application dropdown box.
    4. Search for Directory.AccessAsUser.All, and if necessary, expand the Directory dropdown box.
    5. Select the checkbox and then click Add permissions.

    You can also remove permissions that aren't required for AKS on Azure Stack HCI. To remove permissions before granting admin consent:

    1. Select the ... to the right of the permission that shouldn't be granted.
    2. Select Remove permission.

    Once permissions are correct, click Grant admin consent for <user>, and to confirm the permissions, click Yes. Permissions can be revoked at any time as needed.

    When you're done, your permissions may look something like this:
    Illustrates that status is granted for the Windows Admin Center gateway

    When you're finished, select Next.

  7. Review all of your selections in the Review + create step. If you're satisfied with your selections, select Next: new cluster to begin host setup.

  8. On the Setup progress page, you can watch the progress of your host setup. At this point, you are welcome to open Windows Admin Center in a new tab and continue your management tasks.

  9. If the deployment succeeds, select Finish, and you will be presented with a management dashboard where you can create and manage your Kubernetes clusters.

    Illustrates the Azure Kubernetes Services on Azure Stack HCI management dashboard.

Next steps

In this quickstart, you installed Windows Admin Center and configured an Azure Kubernetes Service host on the system you are going to deploy your Kubernetes clusters to. You are now ready to go ahead with creating a Kubernetes cluster in Windows Admin Center.