Edit

Quickstart: Create a local Kubernetes cluster on AKS hybrid using Windows Admin Center

  • Article

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 checked the system requirements. You can access the 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. You can find this dashboard in the Azure Kubernetes Service tool if you're connected to the system that has an Azure Kubernetes Service host deployed on it. Follow these steps and then proceed to the Use the Create Kubernetes cluster wizard section:

  1. Connect to the system where you want 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 Add cluster under the Kubernetes cluster heading as shown in the following image:

    Screenshot showing the Azure Kubernetes Service tool dashboard.

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 hosts 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 AKS hybrid cluster that you used during the setup process. You must have completed the host setup for this system using the Azure Kubernetes Service tool. When you're finished, select Next.

    Screenshot showing Basics cluster creation pane.

  3. This step is mandatory. Configure node pools to run your workloads on the Node pools page. You can add any number of Windows node pools and Linux node pools. If you enabled Azure Arc integration earlier in this wizard, 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 must 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 selecting 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 becomes 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 is shown at the top of this page.

  7. When 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. For more information about AKS hybrid, and to learn how to deploy and manage Linux applications on AKS hybrid, continue to the following tutorial: