Amazon EKS リソースのタグ付け - Amazon EKS

英語の翻訳が提供されている場合で、内容が矛盾する場合には、英語版がオリジナルとして取り扱われます。翻訳は機械翻訳により提供されています。

Amazon EKS リソースのタグ付け

管理の手助けをするため Amazon EKS 独自のメタデータを各リソースに割り当てることができます。 タグ. このトピックでは、タグ機能の概要を説明し、タグの作成方法を示します。

タグの基本

タグとは、AWS リソースに付けるラベルです。タグはそれぞれ、1 つのキーとオプションの 1 つので構成されており、どちらもお客様側が定義します。

タグを使用すると、 AWS リソースを目的、所有者、環境などで分類できます。同じ型のリソースが多い場合に、割り当てたタグに基づいて特定のリソースをすばやく識別できます。たとえば、Amazon EKS クラスターに一連のタグを定義して、各クラスターの所有者とスタックレベルを追跡できます。リソースタイプごとに一貫した一連のタグキーを考案することをお勧めします。追加したタグに基づいてリソースを検索およびフィルタリングできます。

タグは自動的にはリソースに割り当てられません。タグを追加したら、いつでもタグキーと値は編集でき、タグはリソースからいつでも削除できます。リソースを削除すると、リソースのタグも削除されます。

タグには、Amazon EKS に関連する意味はなく、完全に文字列として解釈されます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。そのリソース上の既存のタグと同じキーを持つタグを追加すると、新しい値が以前の値を上書きします。

新しいクラスタ リソースまたは既存のクラスタ リソースを AWS マネジメントコンソール、 AWS CLI、または Amazon EKS API。を使用して、新しいクラスタ リソースにのみタグを付けることができます。 eksctl.

以下を使用する場合: AWS Identity and Access Management (IAM)、 AWS アカウントにはタグを管理する権限があります。

リソースのタグ付け

新規または既存の Amazon EKS クラスターおよびマネージド型ノードグループにタグを付けることができます。

_を使用している場合 Amazon EKS いつでも新規または既存のリソースにタグを適用できます。これは、 タグ 関連リソースページのタブ 使用している場合、 eksctlを使用すると、リソースが --tags オプション。

_を使用している場合 Amazon EKS API、 AWS CLI、または AWS 新しいリソースにタグを適用できます。 tags 関連 API アクションのパラメータ。タグは、 TagResource APIアクション。詳細については、「TagResource」を参照してください。

リソース作成アクションによっては、リソースの作成時にリソースのタグを指定できます。リソースの作成中にタグを適用できない場合、そのリソースは作成できません。このメカニズムにより、作成時にタグを付けることを意図したリソースが、指定されたタグで作成されるか、まったく作成されないかのいずれかになります。作成時にリソースをタグ付けする場合、リソースの作成後にカスタムタグ付けスクリプトを実行する必要はありません。

次の表は、 Amazon EKS 作成時にタグ付けできるリソースとタグ付けできるリソースです。

Amazon EKS リソースのタグ付けのサポート
Resource タグをサポート タグの伝播をサポート 作成のタグ付けをサポート(Amazon EKS API、 AWS CLI、 AWS SDK、および eksctl)

Amazon EKS クラスター

あり

いいえ。クラスタータグは、クラスターに関連付けられた他のリソースには伝達されません。

あり

Amazon EKS マネージド型ノードグループ

あり

いいえ。マネージド型ノードグループタグは、ノードグループに関連付けられた他のリソースには伝達されません。

あり

Amazon EKS Fargate プロファイル

あり

いいえ。Fargate プロファイルタグは、Fargate プロファイルに関連付けられた他のリソース (このプロファイルでスケジュールされているポッドなど) には伝播されません。

あり

タグの制限

タグには以下のような基本制限があります。

  • リソースあたりのタグの最大数 – 50

  • タグキーは、リソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。

  • キーの最大長 – 128 文字 (Unicode) (UTF-8)

  • 値の最大長 – 256 文字 (Unicode) (UTF-8)

  • 複数の AWS サービス間およびリソース間でタグ付けスキーマを使用する場合、他のサービスでも許可される文字に制限が適用されることがあるのでご注意ください。一般的に使用が許可される文字は、UTF-8 で表現できる文字、数字、スペース、および +、-、=、.、_、:、/、@。

  • タグのキーと値では大文字と小文字が区別されます。

  • 使用禁止 aws:AWS:、またはキーまたは値のプレフィックスなどの大文字または小文字の組み合わせ。これらは、 AWS 使用。このプレフィックスが含まれるタグのキーや値を編集したり削除したりすることはできません。このプレフィックスを持つタグは、リソースあたりのタグ数の制限時には計算されません。

コンソールでのタグの処理

新規または既存のクラスターおよびマネージド型ノードグループに関連付けられたタグは、Amazon EKS コンソールを使用して管理することができます。

Amazon EKS コンソールでリソース固有のページを選択すると、リソースリストが表示されます。たとえば、 クラスター コンソールに、 Amazon EKS クラスタ。タグをサポートするこれらのリスト(たとえば、特定のクラスタ)のいずれかからリソースを選択すると、 タグ タブ。

作成時に個々のリソースにタグを追加する

タグを次の場所に追加できます。 Amazon EKS クラスタ、管理ノードグループ、および Fargate プロファイルを作成します。詳細については、Amazon EKS クラスターの作成 を参照してください。

個々のリソースでのタグの追加と削除

Amazon EKS では、クラスターに関連付けられたタグをリソースのページから直接追加または削除できます。

個々のリソースのタグを追加または削除するには

  1. https://console.aws.amazon.com/eks/home#/clusters にある Amazon EKS コンソールを開きます。

  2. ナビゲーションバーから、使用するリージョンを選択します。

  3. ナビゲーション パネルで、 クラスター.

  4. 特定のクラスターを選択し、下にスクロールして、[Manage tags (タグの管理)] を選択します。

  5. [Update tags (タグの更新)] ページで、必要に応じてタグを追加または削除します。

    • タグ — を追加するには、[Add Tag (タグの追加)] を選択して、各タグのキーと値を指定します。

    • タグ — を削除するには、[Remove tag (タグの削除)] を選択します。

  6. 追加または削除するタグごとにこのプロセスを繰り返し、[Update (更新)] を選択して終了します。

CLI、API、または eksctl

リソースのタグの追加、更新、リスト表示、および削除には、次の AWS CLI コマンドまたは Amazon EKS API オペレーションを使用します。使用できるのは eksctl タグを新しいリソースに追加します。

Amazon EKS リソースのタグ付けのサポート
タスク AWS CLI AWS Tools for Windows PowerShell API アクション

1 つ以上のタグを追加、または上書きします。

tag-resource

Add-EKSResourceTag

TagResource

1 つ以上のタグを削除します。

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