ECI Pod へのカスタムタグのアタッチ - Elastic Container Instance

タグは、Elastic Container Instance (ECI) リソースのグループ化、検索、管理に役立つキーと値のペアです。ECI Pod にカスタムタグをアタッチすることで、タグによるコスト分析、バッチ操作、リソースのフィルタリングが可能になります。

前提条件

開始する前に、以下の前提条件を満たしていることを確認してください。

ECI が有効化された ACK クラスター
クラスター内で Kubernetes ワークロードを作成または更新する権限

ECI カスタムタグの仕組み

Alibaba Cloud タグは、Kubernetes ラベルとは異なる、クラウドリソースレベルのメタデータです。Kubernetes ラベルがクラスター内でのスケジューリングやオブジェクトの選択を制御するのに対し、Alibaba Cloud タグはプラットフォーム全体でリソース管理やコスト分析に適用されます。ECI は、Pod のアノテーションを使用して、作成時に基盤となる ECI インスタンスにカスタムタグを渡します。

Container Service for Kubernetes (ACK) が ECI Pod を作成すると、以下のタグが自動的にバインドされます。

タグキー	値
`ManagedBy`	クラスターのタイプ
`ClusterId`	クラスター ID
`NameSpace`	クラスターの Namespace
`OwnerReferenceKind`	ワークロードのタイプ (例：Deployment、Job)
`OwnerReferenceName`	ワークロードの名前 (例：Deployment 名、Job 名)
`PodName`	Pod の名前

制限事項

制約	詳細
Pod あたりのカスタムタグの最大数	3
タグのフォーマット	`key:value` — キーと値をコロン (`:`) で区切ります
複数のタグ	`,`タグをカンマ (、) で区切ります。例：`env:test,name:alice`
アノテーションが有効になるタイミング	Pod の作成時にのみ有効です。既存の Pod にアノテーションを追加または変更しても効果はありません。
アノテーションの配置場所	Pod の spec の `metadata` セクションに配置する必要があります。Deployment の場合は、`spec.template.metadata` の下にアノテーションを追加します。

Pod へのカスタムタグの追加

Pod のメタデータに k8s.aliyun.com/eci-custom-tags アノテーションを追加します。

以下の例では、2 つのカスタムタグ (env:test と name:alice) を Deployment によって作成される Pod にバインドします。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test
  labels:
    app: test
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      name: nginx-test
      labels:
        app: nginx
        alibabacloud.com/eci: "true"   # この Pod を ECI にルーティングします
      annotations:
        k8s.aliyun.com/eci-custom-tags: "env:test,name:alice"  # カスタムタグ
    spec:
      containers:
      - name: nginx
        image: registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
        ports:
        - containerPort: 80

タグの確認

Pod が作成された後、以下のいずれかの方法でタグを確認します。

kubectl： Pod に対して kubectl describe を実行し、Annotations セクションを確認します。カスタムタグは k8s.aliyun.com/eci-custom-tags の値として表示されます。

ECI コンソール： Elastic Container Instance コンソールの [コンテナグループ] ページに移動し、各 Pod にバインドされているタグを表示します。