给您的 Amazon EKS 资源加标签 - Amazon EKS
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

给您的 Amazon EKS 资源加标签

为了帮助您管理 Amazon EKS 资源,您可以使用标签 为每个资源分配您自己的元数据。本主题概述了标签函数并说明如何创建标签。

有关标签的基本知识

标签是为 AWS 资源分配的标记。每个标签都包含您定义的一个 和一个可选

标签可让您按用途、所有者或环境等对 AWS 资源进行分类。在您具有相同类型的许多资源时,可以根据分配给资源的标签快速识别特定资源。例如,您可以为 Amazon EKS 集群定义一组标签,以帮助您跟踪每个集群的拥有者和堆栈级别。我们建议您为每个资源类型设计一组一致的标签键。然后,您可以根据添加的标签搜索和筛选资源。

标签不会自动分配至您的资源。添加标签后,您可以编辑标签键和值,还可以随时删除资源的标签。如果删除资源,资源的所有标签也会被删除。

标签对 Amazon EKS 没有任何语义意义,应严格按字符串进行解析。您可以将标签的值设为空的字符串,但是不能将其设为空值。如果您添加的标签的键与该资源上现有的标签相同,则新值将覆盖之前的值。

您可以使用 AWS 管理控制台、AWS CLI 或 Amazon EKS API 标记新的或现有的集群资源。您只能使用 eksctl 标记新的集群资源。

如果您使用 AWS Identity and Access Management (IAM),则可以控制 AWS 账户中的哪些用户有权管理标签。

给您的 资源加标签

您可以标记新的或现有的 Amazon EKS 集群和托管节点组。

如果您使用的是 Amazon EKS 控制台,则可以随时将标签应用于新的或现有的资源。为此,您可以使用相关资源页面上的 Tags (标签) 选项卡。如果您使用的是 eksctl,则可以在使用 --tags 选项创建资源时对其应用标签。

如果您使用的是 Amazon EKS API、AWS CLI 或 AWS 开发工具包,则可以使用相关 API 操作上的 tags 参数将标签应用于新资源。您可以使用 TagResource API 操作将标签应用于现有资源。有关更多信息,请参阅 TagResource

某些资源创建操作允许您在创建资源时为其指定标签。如果在创建资源时无法应用标签,则无法创建资源。此机制确保您要在创建时标记的资源是使用指定标签创建的,或者根本不创建资源。如果您在创建时标记资源,则无需在创建资源后运行自定义标记脚本。

下表描述了可以标记的 Amazon EKS 资源和可在创建时标记的资源。

Amazon EKS 资源标记支持
资源 支持标签 支持标签传播 支持在创建时进行标记(Amazon EKS API、AWS CLI、AWS 开发工具包和 eksctl

Amazon EKS 集群

否。集群标签不传播到与集群关联的任何其他资源。

Amazon EKS 托管节点组

否。托管节点组标签不会传播到与节点组关联的任何其他资源。

Amazon EKS Fargate 配置文件

否。Fargate 配置文件标签不会传播到与 Fargate 配置文件关联的任何其他资源,例如使用配置文件调度的 pod。

标签限制

下面是适用于标签的基本限制:

  • 每个资源的最大标签数 – 50

  • 对于每个资源,每个标签键都必须是唯一的,每个标签键只能有一个值。

  • 最大键长度 – 128 个 Unicode 字符(采用 UTF-8 格式)

  • 最大值长度 – 256 个 Unicode 字符(采用 UTF-8 格式)

  • 如果您的标记方案针对多个 AWS 服务和资源使用,请记得其他服务可能对允许使用的字符有限制。通常允许使用的字符包括可用 UTF-8 格式表示的字母、数字和空格,以及以下字符:+ - = . _ : / @。

  • 标签键和值区分大小写。

  • 请不要使用 aws:AWS: 或任何大写或小写组合(如键或值的前缀)。这些保留仅供 AWS 使用。您无法编辑或删除带此前缀的标签键或值。具有此前缀的标签不计入每个资源的标签数限制。

通过控制台使用标签

通过使用 Amazon EKS 控制台,您可以管理与新的或现有的集群和托管节点组关联的标签。

当您在 Amazon EKS 控制台中选择特定资源页面时,它会显示这些资源列表。例如,如果您从导航面板中选择 Clusters (集群),则控制台会显示 Amazon EKS 集群列表。当您从支持标签的其中一个列表中选择资源(例如,特定集群)时,可以在 Tags (标签) 选项卡上查看和管理其标签。

在创建时为单个资源添加标签

您可以在创建 Amazon EKS 集群、托管节点组和 Fargate 配置文件时向其添加标签。有关更多信息,请参阅创建 Amazon EKS 集群

为单个资源添加和删除标签

Amazon EKS 允许您直接从资源的页面中添加或删除与集群相关的标签。

添加或删除单个资源上的标签

  1. 在 Amazon EKSeks/home#/clustershttps://console.amazonaws.cn/ 处打开 控制台。

  2. 从导航栏中,选择要使用的区域。

  3. 在导航面板中,选择 Clusters

  4. 选择特定集群。选择 Configuration (配置) 选项卡。在 Tags (标签) 选项卡上,选择 Manage tags (管理标签)

  5. Update tags (更新标签) 页面上,根据需要添加或删除标签。

    • 添加标签 — 选择 Add Tag (添加标签),然后指定各个标签的键和值。

    • 删除标签 — 选择 Remove tag (删除标签)

  6. 为要添加或删除的每个标签重复此过程,然后选择 Update (更新) 以完成操作。

通过 CLI、API 或 eksctl 使用标签

使用以下 AWS CLI 命令或 Amazon EKS API 操作来添加、更新、列出和删除资源的标签。您只能使用 eksctl 将标签添加到新资源。

Amazon EKS 资源标记支持
任务 AWS CLI 适用于 Windows PowerShell 的 AWS 工具 API 操作

添加或覆盖一个或多个标签。

tag-resource

Add-EKSResourceTag

TagResource

删除一个或多个标签。

untag-resource

Remove-EKSResourceTag

UntagResource

以下示例说明如何使用 AWS CLI 标记或取消标记资源。

示例 1:标记现有集群

以下命令标记现有集群。

aws eks tag-resource --resource-arn <resource_ARN> --tags <team>=<devs>

示例 2:取消标记现有集群

以下命令从现有集群删除标签。

aws eks untag-resource --resource-arn <resource_ARN> --tag-keys <tag_key>

示例 3:列出资源的标签

以下命令列出与现有资源关联的标签。

aws eks list-tags-for-resource --resource-arn <resource_ARN>

某些资源创建操作允许您在创建资源时指定标签。以下操作支持在创建资源时进行标记。

任务 AWS CLI 适用于 Windows PowerShell 的 AWS 工具 API 操作 eksctl

创建集群

create-cluster

New-EKSCluster

CreateCluster

create cluster

创建托管节点组*

create-nodegroup

New-EKSNodegroup

CreateNodegroup

create nodegroup

创建 Fargate 配置文件

create-fargate-profile

New-EKSFargateProfile

CreateFargateProfile.html

create fargateprofile

*如果您希望在创建托管节点组时也为 Amazon EC2 实例添加标签,请使用启动模板创建托管节点组。有关更多信息,请参阅标记 Amazon EC2 实例。如果您的实例已存在,您可以手动标记实例。有关更多信息,请参阅 中的标记您的资源Amazon EC2 用户指南(适用于 Linux 实例)。