Skip to content

Commit 6189bab

Browse files
fleet conceptual docs update
1 parent a33c5c1 commit 6189bab

File tree

5 files changed

+65
-69
lines changed

5 files changed

+65
-69
lines changed

articles/kubernetes-fleet/concept-fleet.md

Lines changed: 0 additions & 69 deletions
This file was deleted.
Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
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+
[ ![Diagram that shows relationship between Fleet and Azure Kubernetes Service clusters.](./media/conceptual-fleet-aks-relationship.png) ](./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).
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)