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

Applies to: Azure Stack HCI, Windows Server 2019 Datacenter

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

Before proceeding to the Kubernetes cluster create wizard, make sure you have Set up Azure Kubernetes Service and check the system requirements if you haven't already. The Kubernetes cluster create wizard can be reached through the All Connections page or the Azure Kubernetes Service host dashboard.

Creating a Kubernetes cluster from the All Connections page

There are two ways to create a Kubernetes cluster in Windows Admin Center. One of these options is to do so from the All Connections page. Follow these steps, then proceed to the Kubernetes cluster create wizard section:

  1. To begin creating a Kubernetes cluster in Windows Admin Center, press the Add button on the gateway screen.

  2. In the Add or create resources panel, under Kubernetes cluster (preview), select Create new to launch the Kubernetes cluster wizard. While the “Add” button under Kubernetes clusters is present in the public preview, it is nonfunctional. At any point during the Kubernetes cluster create process, you may exit the wizard, but note that your progress won't be saved.

    Illustrates the Add or create resources blade in Windows Admin Center, which now includes the new tile for Kubernetes clusters.

Creating a Kubernetes cluster from the Azure Kubernetes Service host dashboard

You may also create a Kubernetes cluster through the Azure Kubernetes Service host dashboard. This dashboard can be found in the Azure Kubernetes Service tool when you are connected to the system that is using an Azure Kubernetes Service host. Follow these steps, then proceed to the Kubernetes cluster create wizard section:

  1. Connect to the system where you wish to create your Kubernetes cluster and 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.

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

The Kubernetes cluster create wizard

You've reached the Kubernetes cluster create wizard through the All Connections page or the Azure Kubernetes Service tool. Let's get started:

  1. Review the prerequisites for the system that will host the Kubernetes cluster and those for Windows Admin Center. When finished, select Next.
  2. On the Basics page, configure information about your cluster, such as Azure Arc integration, Azure Kubernetes Service host information, and primary node pool size. The Azure Kubernetes Service host field requires the fully qualified domain name of the Azure Stack HCI or Windows Server 2019 Datacenter cluster that you used when walking through the setup page. You must have completed the host setup for this system through the Azure Kubernetes Service tool. In public preview, the node count is not editable and will default to 2, but node size can be configured for larger workloads. When complete, select Next.

Illustrates the Basics page of the Kubernetes cluster wizard.

  1. You may configure additional node pools to run your workloads on the Node pools page. During public preview, you may add up to one Windows node pool and one Linux node pool (in addition to the system node pool). If you'd like to enable Azure Arc integration later in this wizard, you will need at least one Linux node pool that is not the primary node pool. When you're finished, select Next.

  2. Specify your network configuration on the Networking page. If you select "Advanced," you can customize the address range used when creating a virtual network for nodes in the cluster. If you select "Basics," virtual networks for nodes in the cluster will be created with a default address range. The Network Settings (load balancer, network policy, and HTTP application routing) cannot be changed in public preview. When complete, select Next.

    Illustrates the Networking page of the Kubernetes cluster wizard.

  3. On the Integration page, connect your cluster with additional services, such as persistent storage. You are required to configure persistent storage on this page. In public preview, the persistent storage location will default to the storage location selected during host setup. This field is currently not editable. When you're finished, select Next.

  4. 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.

  5. After your deployment is complete, the Next steps page details how to manage your cluster. This page also contains your SSH Key. 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.

Important

We recommend saving your SSH Key in a secure, accessible location.

Next steps

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