為您的 Amazon EKS 資源加上標籤 - Amazon EKS

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

為您的 Amazon EKS 資源加上標籤

您可以使用標籤協助您管理 Amazon EKS 資源。本主題提供標籤功能的概觀,並展示您如何建立標籤。

注意

標籤是一種與 Kubernetes 標籤和註釋分開的中繼資料類型。如需有關這些其他中繼資料類型的詳細資訊,請參閱 Kubernetes 文件中的下列章節:

標籤基本概念

標籤是您指派給 AWS 資源的標籤。每個標籤皆包含索引鍵與選用

您可以使用標籤將的 AWS 資源分類。例如,您可以依用途、擁有者或環境來分類資源。當您有許多相同類型的資源時,您可以依據先前指派給特定資源的標籤來快速識別該資源。例如,您可以為 Amazon EKS 叢集定義一組標籤,協助您追蹤每個叢集的擁有者和堆疊層級。建議您為每個資源類型設計一組一致的標籤金鑰。然後,就可以根據您新增的標籤來搜尋和篩選資源。

新增標籤後,您可以隨時編輯標籤索引鍵和值,或從資源移除標籤。如果您刪除資源,也會刪除任何該資源的標籤。

標籤對 Amazon EKS 來說不具有任何語意意義,並會嚴格解譯為字元字串。您可以將標籤的值設為空白字串。不過,您無法將標籤的值設為 null。若您將與現有標籤具有相同鍵的標籤新增到該資源,則新值會覆寫早前的值。

如果使用 AWS Identity and Access Management (IAM),您可以控制您的 AWS 帳戶中的哪些使用者具有管理標籤的許可。

標記您的  資源

以下 Amazon EKS 資源支援標籤:

  • 叢集

  • 受管節點群組

  • Fargate 描述檔

您可以使用以下項目標記這些資源:

  • 如果使用 Amazon EKS 主控台,則可以隨時將標籤套用到新資源或現有資源。您可以在相關資源頁面使用 Tags (標籤) 索引標籤進行此操作。如需詳細資訊,請參閱透過主控台使用標籤

  • 如果使用 eksctl,則可以在使用 --tags 選項建立時將標籤套用到資源。

  • 如果使用 AWS CLI、Amazon EKS API 或 AWS 開發套件,則可以在相關 API 動作上使用 tags 參數,將標籤套用到新資源。您也可以使用 TagResource API 動作將標籤套用到現有資源。如需詳細資訊,請參閱TagResource

當您使用某些資源建立動作時,您也可以在建立資源的同時為資源指定標籤。如果在建立資源時無法套用標籤,則無法建立資源。此機制可確保您要標記的資源是以您指定的標籤建立,不然就根本不會建立。如果您在建立資源時標記資源,則不需要在建立資源之後執行自訂標記指令碼。

標籤不會傳播到與您建立的資源相關聯的其他資源。例如,Fargate 設定檔標籤不會傳播到與 Fargate 設定檔相關聯的其他資源,例如與設定檔一起排程的 Pods。

標籤限制

以下限制適用於標籤:

  • 資源最多可與 50 個標籤建立關聯。

  • 單一資源的標籤索引鍵不能重複。每個標籤索引鍵都必須是唯一的,而且只能有一個值。

  • 索引鍵的長度上限是 128 個 UTF-8 字元。

  • 索引鍵的長度上限是 256 個 UTF-8 字元。

  • 如果多個 AWS 服務 和資源使用您的標記結構描述,請限制您使用的字元類型。某些服務可能對允許的字元設有限制。通常允許的字元為:字母、數字和空格,以及下列字元:+ - = . _ : / @

  • 標籤鍵與值皆區分大小寫。

  • 請勿使用 aws:AWS: 或任何大小寫組合作為索引鍵或值的字首。因為僅預留給 AWS 使用。您不可編輯或刪除具此字首的標籤金鑰或值。具有此前綴的標籤不會計入您的 tags-per-resource限制。

標記您的資源以便計費

當您將標籤套用到 Amazon EKS 叢集時,您可以在成本與用量報告中使用標籤來分配成本。成本與用量報告中的計量資料會顯示所有 Amazon ECS 叢集的用量。如需詳細資訊,請參閱《AWS Billing 使用者指南》中的 AWS 成本與用量報告

AWS 產生的成本配置標籤,尤其是 aws:eks:cluster-name,可讓您依 Cost Explorer 中的個別 Amazon EKS 叢集列出 Amazon EC2 執行個體成本明細。但是,此標籤不會擷取控制平面費用。標籤會自動新增至參與 Amazon EKS 叢集的 Amazon EC2 執行個體中。無論執行個體是使用 Amazon EKS 受管節點群組、Karpenter 或直接使用 Amazon EC2 佈建,都會發生此行為。此特定標籤不會計入 50 個標籤限制。若要使用標籤,帳戶擁有者必須在 AWS Billing 主控台中啟用該標籤,或使用 API 啟用。若 AWS Organizations 管理帳戶擁有者啟用此標籤,也會針對所有組織成員帳戶啟用該標籤。

您也可以根據具有相同標籤索引鍵值的資源來整理您的帳單資訊。例如,您可以使用特定應用程式名稱來標記數個資源,然後整理帳單資訊。這樣一來,您就可以查看該應用程式跨數項服務的總成本。如需有關使用標籤設定成本分配報告的詳細資訊,請參閱《AWS Billing 使用者指南》中的每月成本分配報告

注意

如果您剛啟用報告,當月資料會在 24 小時之後提供檢視。

Cost Explorer 是可作為 AWS 免費方案的一部分使用的報告工具。您可以使用 Cost Explorer 檢視過去 13 個月的 Amazon EKS 資源圖表。您還可以預測未來三個月可能花費的金額。您可以查看在一段時間內的 AWS 資源支出模式。例如,您可以用它來找出需進一步調查的領域,以及查看您可用來了解成本的趨勢。您也可以指定資料的時間範圍,以及根據天或月檢視時間資料。

透過主控台使用標籤

您可以使用 Amazon EKS 主控台,管理與新的或現有的叢集和受管節點群組相關聯的標籤。

當您在 Amazon EKS 主控台中選取資源限定頁面時,該頁面會顯示那些資源的清單。例如,若您從左側導航窗格選取 Clusters (叢集),主控台會顯示 Amazon EKS 叢集的清單。當您從支援標籤的其中一個清單選取資源時 (例如,特定的叢集),您便可以在 Tags (標籤) 索引標籤上檢視和管理其標籤。

您也可以使用 AWS Management Console 中的 Tag Editor (標籤編輯器),其提供了一種統一的方法來管理標籤。有關更多資訊,請參閱 AWS 標籤編輯器使用者指南中的使用標籤編輯器標記您的 AWS 資源

在建立資源時新增標籤

在建立 Amazon EKS 叢集、受管節點群組和 Fargate 描述檔時,您可以將標籤新增至其中。如需詳細資訊,請參閱建立 Amazon EKS 叢集

在資源上新增和刪除標籤

您可以直接從資源的頁面新增或刪除與叢集相關聯的標籤。

在個別資源上新增或刪除標籤
  1. 在以下網址開啟 Amazon EKS 主控台:https://console.aws.amazon.com/eks/home#/clusters

  2. 在導覽列中選取要使用的 AWS 區域。

  3. 在左側導覽窗格中選擇 Clusters (叢集)。

  4. 選擇特定叢集。

  5. 選擇 Tags (標籤) 索引標籤,然後選擇 Manage tags (管理標籤)。

  6. Manage tags (管理標籤) 頁面上,視需要新增或刪除標籤。

    • 若要新增標籤,請選擇 Add tag (新增標籤)。然後指定每個標籤的索引鍵和值。

    • 若要移除標籤,請選擇 Remove tag (移除標籤)。

  7. 針對您要新增或刪除的每個標籤重複此程序。

  8. 選擇 Update (更新) 以完成操作。

透過 CLI、API 或 eksctl 使用標籤

使用下列 AWS CLI 命令或 Amazon EKS API 操作來新增、更新、列出及刪除資源的標籤。您只能使用 eksctl 新增標籤,同時使用一個命令建立新資源。

Amazon EKS 資源的標記支援
任務 AWS CLI AWS Tools for Windows PowerShell 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 AWS Tools for Windows PowerShell 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 執行個體。如果您的執行個體已經存在,則可以手動為執行個體加上標籤。如需詳細資訊,請參閱《適用於 Linux 執行個體的 Amazon EC2 使用者指南》中的為您的資源加上標籤