Pod アノテーション - Container Compute Service - Alibaba Cloud ドキュメントセンター

Alibaba Cloud Container Service for Kubernetes (ACK) クラスタに Pod を作成する際に、Pod にアノテーションを追加して、いくつかの拡張機能を有効化および構成できます。このトピックでは、ACK クラスタの Pod に追加できるアノテーションについて説明します。

ACS Pod の作成時に追加できるアノテーション

Pod アノテーションでサポートされているキーと値を構成して、関連する機能と構成を有効にできます。例：

Pod 構成例

apiVersion: v1
kind: Pod
metadata:
  name: annotation-pod
  annotations:
    network.alibabacloud.com/vswitch-ids: "vsw-foo"
spec:
  ...

デプロイメント構成例

apiVersion: apps/v1
kind: Deployment
metadata:
  name: foo
  ...
spec:
  ...
  template:
    metadata:
      annotations:
        network.alibabacloud.com/vswitch-ids: "vsw-foo"
    ...

ネットワーク

機能	パラメーター	例	説明
Pod の vSwitch とセキュリティグループを指定する	network.alibabacloud.com/vswitch-ids	"vsw-slw1*,vsw-lkjwo*"	vSwitch の ID を指定します。複数の vSwitch を指定して、複数のゾーンに Pod を作成できます。重要 Pod に vSwitch とアフィニティルールの両方が指定されている場合、ACK は優先的に vSwitch に基づいてリソースを作成します。アフィニティルールは無視されます。重要 Pod が WaitForFirstConsumer タイプの PVC を使用する場合は、Pod のアフィニティ設定で対応するゾーンを指定する必要があります。スケジューラは、Pod が保留状態になった場合に備えて、PVC のゾーンが vSwitch のゾーンと同じであることを保証します。詳細については、「ノードアフィニティスケジューリング」をご参照ください。
Pod の vSwitch とセキュリティグループを指定する	network.alibabacloud.com/security-group-ids	"sg-sljwo*,sg-lwirp*"	セキュリティグループの ID を指定します。複数のセキュリティグループを指定できます。
アノテーションを追加してカスタム DNS サーバーを構成する	network.alibabacloud.com/custom-dnsconfig	{"servers":["20.1.xx.xx","30.1.xx.xx"],"searches":["xx.com","yy.com"],"options":["ndots:2","edns0"]}	カスタム DNS サーバー構成を指定します。
ACK クラスタでネットワークポリシーを使用する	alibabacloud.com/enable-network-policy-agent	"true"	ACK Pod のネットワークポリシーを有効にします。デフォルト値は `false` です。
Pod に独立した EIP をマウントする	network.alibabacloud.com/pod-with-eip	"true"	EIP を自動的に作成し、Pod に関連付けるかどうかを指定します。有効な値： `true`：EIP を自動的に作成し、Pod に関連付けます。 `false`：EIP を自動的に作成したり、Pod に関連付けたりしません。
	network.alibabacloud.com/pod-eip-instanceid	"eip-bp14q***"	使用する EIP の ID (例：eip-bp14q***) を指定します。詳細については、「EIP を申請する」をご参照ください。
	k8s.aliyun.com/eci-eip-instanceid (Elastic Container Instance と互換性あり)	"eip-bp14q***"
	network.alibabacloud.com/eip-bandwidth	"5"	EIP の最大帯域幅を指定します。単位：Mbit/s。
	network.alibabacloud.com/eip-internet-charge-type	"PayByTraffic"	EIP の課金方法を指定します。有効な値： `paybytraffic` (デフォルト)：トラフィック課金。 `PayByBandwidth`：帯域幅課金。 EIP の課金についての詳細は、「課金概要」をご参照ください。
	k8s.aliyun.com/eip-charge-type (以前のバージョンと互換性あり)	"PayByTraffic"
	network.alibabacloud.com/eip-instance-charge-type	"PrePaid"	EIP の課金方法を指定します。有効な値： `PrePaid`：サブスクリプション。 `PostPaid`：従量課金。詳細については、「サブスクリプション」および「従量課金」をご参照ください。
	network.alibabacloud.com/eip-common-bandwidth-package-id	"cbwp-slex***"	使用するインターネット共有帯域幅インスタンスを指定します。
	network.alibabacloud.com/eip-isp	"BGP"	EIP の回線タイプを指定します。有効な値： `BGP`：BGP (マルチ ISP) 回線。 `BGP_PRO`：BGP (マルチ ISP) Pro 回線。詳細については、「EIP を申請する」をご参照ください。
	network.alibabacloud.com/eip-public-ip-address-pool-id	"pippool-dlsw***"	IP アドレスプールを指定します。詳細については、「IP アドレスプールを作成および管理する」をご参照ください。
	network.alibabacloud.com/eip-resource-group-id		EIP が属するリソースグループを指定します。詳細については、「EIP を申請する」をご参照ください。
	network.alibabacloud.com/eip-name		EIP の名前を指定します。詳細については、「EIP を申請する」をご参照ください。
	network.alibabacloud.com/eip-description		EIP の説明を指定します。詳細については、「EIP を申請する」をご参照ください。
	network.alibabacloud.com/eip-security-protection-types		EIP を保護するために使用されるセキュリティサービスを指定します。複数のセキュリティサービスはコンマ (`,`) で区切ります。詳細については、「EIP を申請する」をご参照ください。
	network.alibabacloud.com/pod-eip-release-strategy	"Never"	EIP リリースポリシーを指定します。有効な値： `Follow` (デフォルト値)：EIP に関連付けられている Pod のライフサイクルに従います。 `Never`：EIP をリリースしません。EIP が不要になった場合は、Pod に関連付けられている EIP を手動でリリースする必要があります。 EIP の有効期限を設定します。たとえば、`5m30s` は、Pod が削除されてから 5 分 30 秒後に EIP がリリースされることを示します。Go で記述された時間式がサポートされています。

イメージ

機能	パラメーター	例	説明
セルフマネージドイメージリポジトリからイメージをプルする	registry.alibabacloud.com/plain-http-registry	"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"	HTTP プロトコルを使用するセルフマネージドイメージリポジトリからイメージをプルする場合は、このパラメーターを指定する必要があります。これにより、異なるプロトコルが原因でイメージのプルが失敗することを防ぎます。
セルフマネージドイメージリポジトリからイメージをプルする	registry.alibabacloud.com/insecure-registry	"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"	自己署名証明書を使用するセルフマネージドイメージリポジトリからイメージをプルする場合は、このパラメーターを指定して証明書の認証をスキップする必要があります。これにより、証明書の認証エラーによって発生するイメージのプルエラーを防ぎます。

スケジューリング

機能	パラメーター	例	説明
Pod QoS ベースの再スケジューリングポリシー	alpha.alibabacloud.com/compute-qos-strategy	"best-effort-to-default"	compute-qos 再スケジューリングポリシーを指定します。値を `best-effort-to-default` に設定すると、BestEffort Pod が優先されます。BestEffort Pod が不足している場合は、デフォルトの Pod がデプロイされます。重要このアノテーションを使用する場合、`alibabacloud.com/compute-qos` ラベルを追加する必要はありません。このラベルがすでに追加されている場合は、ラベルの値が優先されます。

ACK によって自動的に追加されるアノテーション

説明

以下のアノテーション情報は、Elastic Network Interface (ENI) や EIP の割り当て結果など、ACK 関連機能の処理後に生成された結果です。これらのアノテーションを設定または変更することはできません。

機能	パラメーター	例	説明
ENI 割り当て情報	network.alibabacloud.com/allocated-eni-id	"eni-esdxs***"	割り当てられた ENI の ID を示します。
	network.alibabacloud.com/vpc-id	"vpc-sljwo***"	ENI が属する VPC の ID を示します。
	network.alibabacloud.com/vswitch-id	"vsw-lskdw***"	ENI が属する vSwitch の ID を示します。ACK Pod の作成時に複数の vSwitch を指定した場合、使用されている vSwitch が表示されます。
EIP 割り当て情報	network.alibabacloud.com/allocated-eip-id	"eip-bp1m***"	割り当てられた EIP の ID を示します。
EIP 割り当て情報	network.alibabacloud.com/allocated-eip-address	"116.62.***"	割り当てられた EIP の IP アドレスを示します。
リソース仕様	alibabacloud.com/pod-use-spec	"2.5-5Gi"	ACK Pod の CPU とメモリの仕様を示します。仕様は xxvCPU-xxGiB 形式です。
	alibabacloud.com/pod-gpu-use-spec	"1"	仕様調整後の ACK Pod の GPU 数を示します。
	alibabacloud.com/pod-ephemeral-storage	"30Gi"	仕様調整後の ACK Pod の一時記憶領域のサイズを示します。単位：GiB。
スケジューリング結果	topology.kubernetes.io/region	"cn-hangzhou"	ACK Pod が属するリージョンを示します。
スケジューリング結果	topology.kubernetes.io/zone	"cn-hangzhou-i"	ACK Pod が属するゾーンを示します。
その他のメタデータ情報	alibabacloud.com/instance-id	"acs-sdsf***"	ACK Pod のインスタンス ID を示します。
その他のメタデータ情報	alibabacloud.com/request-id	"6925D4B7-***"	リクエスト ID を示します。