Azure Kubernetes Fleet Manager 成员群集标签

适用于: ✔️ 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'
		}
	}
}

后续步骤