Quickstart: Create an Azure Kubernetes Fleet Manager and join member clusters using the Azure portal

Applies to: ✔️ Fleet Manager ✔️ Fleet Manager with hub cluster

Get started with Azure Kubernetes Fleet Manager by using the Azure portal to create a Fleet Manager and join supported Kubernetes clusters as members.

Before you begin

If you don't have an Azure trail subscription, create a trial subscription before you begin.

  • Read the conceptual overview of Fleet Manager, which provides an explanation of fleets and member clusters referenced in this document.

  • An Azure account with an active subscription. Create an account.

  • An identity (user or service principal) with the following permissions:

    • Fleet Manager:
      • Microsoft.ContainerService/fleets/read
      • Microsoft.ContainerService/fleets/write
      • Microsoft.ContainerService/fleets/members/read
      • Microsoft.ContainerService/fleets/members/write
      • Microsoft.ContainerService/fleetMemberships/read
      • Microsoft.ContainerService/fleetMemberships/write
    • AKS member clusters:
      • Microsoft.ContainerService/managedClusters/read
      • Microsoft.ContainerService/managedClusters/write
      • Microsoft.ContainerService/managedClusters/listClusterUserCredential/action
    • Arc-enabled Kubernetes member clusters:
      • Microsoft.Kubernetes/connectedClusters/read
      • Microsoft.KubernetesConfiguration/extensions/read
      • Microsoft.KubernetesConfiguration/extensions/write
      • Microsoft.KubernetesConfiguration/extensions/delete

  • Clusters you wish to join as members to Fleet must use supported versions of their respective platforms: see AKS cluster version support policy and Azure Arc-enabled Kubernetes validation.

Create a Fleet Manager resource

  1. Sign in to the Azure portal.

  2. On the Azure portal home page, select Create a resource.

  3. In the search box, enter Kubernetes Fleet Manager and select Create > Kubernetes Fleet Manager from the search results.

  4. On the Basics tab, configure the following options:

    • Under Project details:

      • Subscription: Select the Azure subscription that you want to use.
      • Resource group: Select an existing resource group or select Create new to create a new resource group.

    • Under Fleet details:

      • Name: Enter a name for the Fleet Manager.
      • Region: Select the region where you want to create the Fleet Manager.
      • Hub cluster mode: Select one of the following options based on features you require:
        • With hub cluster multi-cluster Kubernetes resource placement, Managed Fleet Namespaces, DNS load balancing, and cluster upgrades.
        • Without hub cluster safe multi-cluster Kubernetes and node image upgrades, cluster observability.

      Screenshot of the Create Fleet Manager basics tab in the Azure portal.

  5. Select Next: Member clusters.

  6. Select + Add to add existing clusters, filtering the cluster list by using the search box.

    Screenshot of the Create Fleet Manager add member cluster dialog in the Azure portal.

  7. Select Add to add the selected clusters and close the list.

  8. In the member list:

    • A Name is generated for the member cluster to uniquely identify it within Fleet Manager. Modify the generated name if necessary.
    • Enter an update group for the member cluster so the cluster can be safely updated when the group is included in a Fleet Manager update strategy.

    Screenshot of the Create Fleet Manager add member cluster name and update group options in the Azure portal.

  9. Select Next: Advanced.

  10. On the Advanced tab, configure the following options:

    • Select Private hub access to provision a private hub cluster:
      • Virtual network: Select an existing Azure virtual network or select Create new to create a new virtual network.
      • Cluster subnet: Select a virtual network subnet for the hub cluster node.
      • API server subnet: Select a virtual network subnet for the hub cluster's API server integration.
    • Select an existing user-assigned managed identity or select Create new to create a new user-assigned managed identity to be used by Fleet Manager.
    • Optionally, create one or more Managed Fleet Namespaces to provision with the Fleet Manager.

    Screenshot of the Create Fleet Manager advanced tab in the Azure portal.

  11. Select Next: Tags and define any Azure resource tags to apply to the new Fleet Manager.

  12. Select Review + create > Create to create the Fleet Manager.

It takes a few minutes to create the Fleet Manager. When your deployment is complete, you can navigate to your resource by selecting Go to resource.

Next steps

  • Last updated on