适用于: ✔️ Fleet Manager ✔️ 带中心群集的 Fleet Manager
通过成员群集标签,可以在 Azure Kubernetes Fleet Manager 中描述和选择群集。 使用标签按位置、环境或应用程序团队等属性标识群集。 然后,可以使用这些属性将资源部署到目标位置、对群集进行分组以更新,并定义分阶段发布,而无需列出单个群集名称。
本文介绍成员群集标签的工作原理以及如何使用它们来管理集群组。
成员标签的用途
将启用了 AKS 或 Arc 的 Kubernetes 群集添加到机群时,Fleet Manager 将创建一个充当该群集代理的Azure成员群集资源。 成员群集标签是与此资源关联的键值对。 它们描述机群成员,而不是标记群集中的节点或工作负荷。
如果机群具有中心群集,则 Fleet Manager 会在中心群集上创建 Kubernetes MemberCluster 自定义资源,以表示已加入的群集,并将标签应用于该群集。 资源放置使用此自定义资源来标识和选择目标群集。
默认标签
Fleet Manager 会自动将服务定义的标签添加到每个成员群集。 这些标签描述群集的Azure标识和位置,因此可以使用 Fleet Manager 已维护的信息选择群集。
| 标签 | Description |
|---|---|
fleet.azure.com/location |
群集的 Azure 区域,例如 chinanorth3。 |
fleet.azure.com/resource-group |
包含群集的Azure资源组。 |
fleet.azure.com/subscription-id |
群集的Azure订阅 ID。 |
fleet.azure.com/cluster-name |
基础 AKS 或已启用 Arc 的 Kubernetes 群集的名称。 |
fleet.azure.com/member-name |
Fleet Manager 中成员群集资源的名称。 |
服务定义的标签是只读的。 添加自定义标签以描述默认标签未涵盖的属性。
自定义标签
自定义标签描述组织和操作群集的方式。 例如,可以将以下标签应用于成员群集:
| Key | 示例值 | Purpose |
|---|---|---|
environment |
production |
区分生产群集与测试群集或暂存群集。 |
team |
payments |
确定负责群集的团队。 |
update-ring |
canary |
确定用于早期更新或推出阶段的群集。 |
成员群集可以有多个标签,因此你可以以不同的方式为不同的任务选择它。 在舰队中使用一致的键和值,以便选择器与要管理的群集匹配。
选择、分组和排序群集
标签选择器根据其标签键和值匹配群集。 例如,environment=production 的选择器会选择具有该标签的成员。 添加对 team=payments 的要求会将选择范围缩小到由付款团队拥有的生产集群。
将标签用于以下管理任务:
- 更新协调: 为更新策略中的阶段和组选择群集。 基于标签的更新分组处于预览状态。 有关详细信息,请参阅 使用成员标签对群集进行分组。
- 跨群集网络成员身份: 设置成员标签以控制群集是否是跨群集网络的成员。 有关详细信息,请参阅 配置和使用跨群集网络。
- 资源放置: 选择接收 Kubernetes 资源的成员群集。 有关详细信息,请参阅 资源放置。
- 资源分阶段发布: 为资源部署选择每个发布阶段的群集。 有关详细信息,请参阅 资源分配发布策略。
对于发布和策略,标签本身不会定义执行顺序。 在更新或推出策略中配置顺序,并使用标签来标识每个阶段中的群集。 例如,将标记为 update-ring=canary 的群集放在较早阶段,将标记为 update-ring=production 的群集放在较后阶段。
与中心群集进行标签同步
对于具有中心群集的机群,自定义成员标签在Azure成员资源与相应的MemberCluster自定义资源之间进行同步。 通过 Azure CLI、门户或 ARM 模板应用的标签会复制到中心上的 MemberCluster 资源。 不能直接管理中心群集上的 MemberCluster 资源上的标签。
管理成员群集标签
可以通过Azure门户、Azure CLI或Azure 资源管理器(ARM)模板和Bicep来管理自定义标签。
在 Azure 门户中,打开 Fleet Manager,选择 设置>成员群集,选择一个成员群集,然后选择 编辑标签。 添加或更改标签键值对,然后选择“ 应用”。
对于脚本和自动化,请使用 az fleet member create 或 az fleet member update 与 --labels 参数配合使用。 以下示例设置前面引入的自定义标签。 将资源组、机队和成员名称替换为自己的值。
az fleet member update \
--resource-group myFleetResourceGroup \
--fleet-name myFleet \
--name myMember \
--labels "environment=production team=payments update-ring=canary"
对于声明性管理,请在 ARM 模板或 Bicep 文件中的 Microsoft.ContainerService/fleets/members 里,在 properties.labels 资源上定义自定义标签。 以下Bicep示例为现有车队的成员设置相同的标签。 将其部署到机队的资源组,并提供机队名称、成员名称以及 AKS 或已启用 Arc 的 Kubernetes 群集的完整 Azure 资源 ID。 在模板中包括你管理的任何其他成员特性,例如 group。 有关资源架构,请参阅Fleet 成员 ARM 和 Bicep 参考。
param fleetName string
param memberName string
param clusterResourceId string
resource fleet 'Microsoft.ContainerService/fleets@2024-04-01' existing = {
name: fleetName
}
resource member 'Microsoft.ContainerService/fleets/members@2026-06-01' = {
parent: fleet
name: memberName
properties: {
clusterResourceId: clusterResourceId
labels: {
'environment': 'production'
'team': 'payments'
'update-ring': 'canary'
}
}
}