Quickstart: Create a local Kubernetes cluster on Azure Stack HCI and Windows Server using Windows Admin Center

Applies to: Azure Stack HCI and Windows Server

After you have set up your Azure Kubernetes Service (AKS) host, you can use Windows Admin Center to create a local Kubernetes cluster. To use PowerShell instead, see Create a Kubernetes cluster with PowerShell.

Before proceeding to the Create Kubernetes cluster wizard, make sure you have Set up Azure Kubernetes Service and check the system requirements. You can access the Create Kubernetes cluster wizard through the Azure Kubernetes Service host dashboard.

Create a local Kubernetes cluster in the Azure Kubernetes Service host dashboard

You can create a local Kubernetes cluster through the Azure Kubernetes Service host dashboard. This dashboard can be found in the Azure Kubernetes Service tool if you're connected to the system that has an Azure Kubernetes Service host deployed on it. Follow the steps below and then proceed to the Use the Create Kubernetes cluster wizard section:

  1. Connect to the system where you wish to create your Kubernetes cluster and then navigate to the Azure Kubernetes Service tool. This system should already have an Azure Kubernetes Service host set up.

  2. Select the Add cluster button under the Kubernetes cluster heading as shown in the image below:

    Illustrates the Azure Kubernetes Service tool dashboard that appears after you set up an Azure Kubernetes Service host.

Use the Create Kubernetes cluster wizard

This section describes how to use the Create Kubernetes cluster wizard through the Azure Kubernetes Service tool.

  1. Review the prerequisites for the system that will host the Kubernetes cluster and Windows Admin Center. When you're finished, select Next.

  2. On the Basics page, configure information about your Kubernetes cluster. The Azure Kubernetes Service host field requires the fully qualified domain name of the Azure Stack HCI and Windows Server cluster that you used during the setup process. You must have completed the host setup for this system through the Azure Kubernetes Service tool. When you're finished, select Next.

    Illustrates the Basics page of the Kubernetes cluster wizard.

  3. Configure node pools to run your workloads on the Node pools page. This step is mandatory. You may add any number of Windows node pools and Linux node pools. If you enabled Azure Arc integration earlier in this wizard, you need to configure a Linux node pool with at least one Linux worker node. However, if you disabled Azure Arc integration earlier, then any node pool addition allows you to proceed to the next step. You can also set maximum pod counts and node taints when configuring node pools. Both of these settings are optional. For more information on the available taint settings, see New-AksHciCluster.

    Screenshot that illustrates the Node pools page of the Kubernetes cluster wizard where you can configure maximum pod counts and taints.

    When you're finished, select Next.

  4. In the Authentication step, select whether you'd like to enable Active Directory authentication. If you choose to enable this feature, you'll need to provide information such as your API Server service principal name, a Keytab file, and a cluster admin group or user name. When you're finished, select Next.

  5. Specify your network configuration on the Networking page. You can either select an existing virtual network or create a new one by clicking on Add network interface. If you select the Flannel container network interface (CNI), keep in mind that only Windows or hybrid clusters are supported. Once Flannel is set, it can't be changed, and the cluster won't support any network policy. If the Calico CNI is selected, it isn't needed to support Calico Network Policy and Calico will be the default option for your network policy under Security. When complete, select Next: Review + Create.

    The following image illustrates the static IP configuration settings:

    Illustrates the Networking, static page of the Kubernetes cluster wizard.

    The following image illustrates the DHCP configuration settings:

    Illustrates the Networking, DHCP page of the Kubernetes cluster wizard.

  6. Review your selections on the Review + create page. When you're satisfied, select Create to begin deployment. Your deployment progress will be shown at the top of this page.

  7. After your deployment is complete, the Next steps page details how to manage your cluster. If you chose to disable the Azure Arc integration in the previous step, some of the information and instructions on this page may not be available or functional.

    Illustrates the successful completion of the Kubernetes cluster.

Next steps

In this quickstart, you deployed a Kubernetes cluster. To learn more about Azure Kubernetes Service on Azure Stack HCI and Windows Server and walk through how to deploy and manage Linux applications on AKS on Azure Stack HCI and Windows Server, continue to the following tutorial: