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

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

Prerequisites

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

  • Read the conceptual overview of this feature, 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 for Fleet resources, and if applicable, member cluster resources:

  • Fleet permissions:

    • 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

  • If joining AKS member clusters:

    • Microsoft.ContainerService/managedClusters/read
    • Microsoft.ContainerService/managedClusters/write
    • Microsoft.ContainerService/managedClusters/listClusterUserCredential/action

  • If joining 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 unique name for the Fleet resource.

      • Region: Select the region where you want to create the Fleet resource.

      • Hub cluster mode: Leave the default selection of With hub cluster if you want to use Fleet Manager for Kubernetes object propagation and multi-cluster load balancing along with update orchestration. Select Without hub cluster if you want to use Fleet Manager only for update orchestration.

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

  5. Select Next: Member clusters.

  6. On the Member clusters tab, select Add to add an existing cluster as a member cluster to the Fleet Manager. You can add multiple member clusters to the Fleet Manager.

  7. Select Review + create > Create to create the Fleet resource.

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

Next steps

  • Last updated on