協助改善此頁面
想要為此使用者指南做出貢獻嗎? 捲動至此頁面底部,然後選取 [編輯此頁面於] GitHub。您的貢獻將有助於使我們的用戶指南更適合所有人。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用標籤整理 Amazon EKS 資源
您可以使用標籤協助您管理 Amazon EKS 資源。本主題提供標籤功能的概觀,並展示您如何建立標籤。
標籤基本概念
標籤是指派給 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:eks:cluster-name
別是 AWS 產生的成本分配標籤可讓您在 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,它提供了管理標籤的統一方式。若要取得更多AWS 資訊,請參閱〈標籤編輯器使用指南〉中的〈使用AWS 標籤編輯器標記資源
在建立資源時新增標籤
在建立 Amazon EKS 叢集、受管節點群組和 Fargate 描述檔時,您可以將標籤新增至其中。如需詳細資訊,請參閱 創建一個 Amazon EKS 群集。
在資源上新增和刪除標籤
您可以直接從資源的頁面新增或刪除與叢集相關聯的標籤。
在個別資源上新增或刪除標籤
-
在以下網址開啟 Amazon EKS 主控台:https://console.aws.amazon.com/eks/home#/clusters
。 -
在導覽列上,選取 AWS 區域 要使用的。
-
在左側導覽窗格中選擇 Clusters (叢集)。
-
選擇特定叢集。
-
選擇 Tags (標籤) 索引標籤,然後選擇 Manage tags (管理標籤)。
-
在 Manage tags (管理標籤) 頁面上,視需要新增或刪除標籤。
-
若要新增標籤,請選擇 Add tag (新增標籤)。然後指定每個標籤的索引鍵和值。
-
若要移除標籤,請選擇 Remove tag (移除標籤)。
-
-
針對您要新增或刪除的每個標籤重複此程序。
-
選擇 Update (更新) 以完成操作。
透過 CLI、API 或 eksctl
使用標籤
使用下列 AWS CLI 命令或 Amazon EKS API 操作來新增、更新、列出和刪除資源的標籤。您只能使用 eksctl
新增標籤,同時使用一個命令建立新資源。
Amazon EKS 資源的標記支援 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
任務 | AWS CLI | AWS Tools for Windows PowerShell | API 動作 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
新增或覆寫一或多個標籤。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
刪除一或多個標籤。 |
下列範例示範如何使用 AWS CLI來標記或取消標記資源。
範例 1:標記現有的叢集
以下命令標記現有的叢集。
aws eks tag-resource --resource-arn
resource_ARN
--tagsteam
=devs
範例 2:取消標記現有的叢集
以下命令從現有的叢集刪除標籤。
aws eks untag-resource --resource-arn
resource_ARN
--tag-keystag_key
範例 3:列出資源的標籤
以下命令列出與現有資源相關聯的標籤。
aws eks list-tags-for-resource --resource-arn
resource_ARN
當您使用某些資源建立動作時,您可以在建立資源的同時指定標籤。下列動作支援在建立資源時指定標籤。
任務 | AWS CLI | AWS Tools for Windows PowerShell | API 動作 | eksctl |
---|---|---|---|---|
建立叢集 |
|
|||
建立受管節點群組* |
|
|||
建立 Fargate 設定檔 |
|
* 如果還想在建立受管節點群組時為 Amazon EC2 執行個體加上標籤,請使用啟動範本建立受管節點群組。如需詳細資訊,請參閱 標記 Amazon EC2 實例。如果您的執行個體已經存在,則可以手動為執行個體加上標籤。如需詳細資訊,請參閱 Amazon EC2 使用者指南中的標記資源。