|
| 1 | +--- |
| 2 | +title: "Azure Kubernetes Fleet Manager and member clusters" |
| 3 | +description: This article provides a conceptual overview of Azure Kubernetes Fleet Manager and member clusters. |
| 4 | +ms.date: 03/04/2024 |
| 5 | +author: shashankbarsin |
| 6 | +ms.author: shasb |
| 7 | +ms.service: kubernetes-fleet |
| 8 | +ms.topic: conceptual |
| 9 | +--- |
| 10 | + |
| 11 | +# Azure Kubernetes Fleet Manager and member clusters |
| 12 | + |
| 13 | +Azure Kubernetes Fleet Manager (Fleet) solves at-scale and multi-cluster problems for Kubernetes clusters. This document provides a conceptual overview of fleet and its relationship with its member Kubernetes clusters. Right now Fleet supports joining AKS clusters as member clusters. |
| 14 | + |
| 15 | +[  ](./media/conceptual-fleet-aks-relationship.png#lightbox) |
| 16 | + |
| 17 | +## Fleet scenarios |
| 18 | + |
| 19 | +A fleet is an Azure resource you can use to group and manage multiple Kubernetes clusters. Currently fleet supports the following scenarios: |
| 20 | + * Create a Fleet resource and group AKS clusters as member clusters. |
| 21 | + * Orchestrate latest or consistent Kubernetes version and node image upgrades across multiple clusters by using update runs, stages, and groups |
| 22 | + * Create Kubernetes resource objects on the Fleet resource's hub cluster and control their propagation to member clusters (preview). |
| 23 | + * Export and import services between member clusters, and load balance incoming L4 traffic across service endpoints on multiple clusters (preview). |
| 24 | + |
| 25 | +## What are member clusters? |
| 26 | + |
| 27 | +You can join Azure Kubernetes Service (AKS) clusters to a fleet as member clusters. Member clusters must reside in the same Microsoft Entra tenant as the fleet. But they can be in different regions, different resource groups, and/or different subscriptions. |
| 28 | + |
| 29 | +## What is a hub cluster (preview)? |
| 30 | + |
| 31 | +[!INCLUDE [preview features note](./includes/preview/preview-callout.md)] |
| 32 | + |
| 33 | +Certain scenarios of fleet such as update runs don't require a Kubernetes API and thus don't require a hub cluster. Fleet can be created without the hub cluster for such scenarios. In this mode, Fleet just acts as a grouping entity in Azure Resource Manager. |
| 34 | + |
| 35 | +For other scenarios such as Kubernetes resource propagation, a hub cluster is required. This hub cluster is a special AKS cluster whose lifecycle (creation, upgrades, deletion) is managed by the fleet resource. |
| 36 | + |
| 37 | + |
| 38 | +The following table lists the differences between a fleet without hub cluster and a fleet with hub cluster: |
| 39 | + |
| 40 | +| Feature Dimension | Without hub cluster | With hub cluster (preview) | |
| 41 | +|-|-|-| |
| 42 | +| Hub cluster hosting (preview) | :x: | :white_check_mark: | |
| 43 | +| Member cluster limit | Up to 100 clusters | Up to 20 clusters | |
| 44 | +| Update orchestration across multiple clusters | :white_check_mark: | :white_check_mark: | |
| 45 | +| Kubernetes resource object propagation (preview) | :x: | :white_check_mark: | |
| 46 | +| Multi-cluster L4 load balancing (preview) | :x: | :white_check_mark: | |
| 47 | + |
| 48 | +Upon the creation of a fleet, a hub cluster is automatically created in the same subscription as the fleet under a managed resource group named as `FL_*`. |
| 49 | + |
| 50 | +To improve reliability, hub clusters are locked down by denying any user initiated mutations to the corresponding AKS clusters (under the Fleet-managed resource group `FL_*`) and their underlying Azure resources like VMs (under the AKS-managed resource group `MC_FL_*`) via Azure deny assignments. |
| 51 | + |
| 52 | +Hub clusters are exempted from Azure policies to avoid undesirable policy effects upon hub clusters. |
| 53 | + |
| 54 | +## Billing |
| 55 | + |
| 56 | +The fleet resource is currently free of charge. If your fleet contains a hub cluster, the hub cluster is a standard tier AKS cluster created in the fleet subscription and paid by you. |
| 57 | + |
| 58 | +## FAQs |
| 59 | + |
| 60 | +### Can I change a fleet without hub cluster to a fleet with hub cluster? |
| 61 | +No during hub cluster preview, to be supported once hub clusters become generally available. |
| 62 | + |
| 63 | +## Next steps |
| 64 | + |
| 65 | +* [Create a fleet and join member clusters](./quickstart-create-fleet-and-members.md). |
0 commit comments