すべてのプロダクト
Search
ドキュメントセンター

Container Compute Service:Pod アノテーションリファレンス

最終更新日:Jul 02, 2026

Container Compute Service (ACS) Pod にアノテーションを追加して、ネットワーク、イメージのプル動作、スケジューリング、OS 設定を構成します。このリファレンスでは、サポートされているすべてのアノテーションをカテゴリ別に一覧表示します。

Pod 設定用のアノテーション

Pod または Deployment の作成時に、これらのアノテーションを metadata.annotations に設定します。

Pod 設定の例

apiVersion: v1
kind: Pod
metadata:
  name: annotation-pod
  annotations:
    # Pod が作成されるゾーンを制御するために、1 つ以上の vSwitch ID を指定します
    network.alibabacloud.com/vswitch-ids: "vsw-foo"
    # Pod の起動時に EIP を自動的にアタッチします
    network.alibabacloud.com/pod-with-eip: "true"
spec:
  ...

Deployment 設定の例

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

ネットワーク

パラメータ

説明

network.alibabacloud.com/vswitch-ids

"vsw-slw1*,vsw-lkjwo*"

Pod の vSwitch ID。複数の ID を指定して、ゾーン間で Pod を作成します。詳細については、「Pod の vSwitch とセキュリティグループの指定」をご参照ください。

重要
  • vSwitch とアフィニティの両方が設定されている場合、ACS は指定された vSwitch を使用し、アフィニティ設定を無視します。

  • Pod が WaitForFirstConsumer バインディングモードの PersistentVolumeClaim (PVC) を使用する場合、スケジューラーが PVC ゾーンを vSwitch と一致させ、Pod が Pending 状態のままになるのを防ぐために、Pod のアフィニティ設定でターゲットゾーンも指定する必要があります。詳細については、「ノードアフィニティスケジューリング」をご参照ください。

network.alibabacloud.com/security-group-ids

"sg-sljwo*,sg-lwirp*"

Pod のセキュリティグループ ID。複数の ID を指定して、複数のセキュリティグループをアタッチします。

network.alibabacloud.com/custom-dnsconfig

{"servers":["20.1.xx.xx","30.1.xx.xx"],"searches":["xx.com","yy.com"],"options":["ndots:2","edns0"]}

Pod のカスタム DNS 設定。詳細については、「アノテーションを使用したカスタム DNS の設定」をご参照ください。

alibabacloud.com/enable-network-policy-agent

"true"

Pod の NetworkPolicy を有効にします。デフォルト: false。詳細については、「ACS クラスターでのネットワークポリシーの使用」をご参照ください。

EIP 設定

Elastic IP アドレス (EIP) を Pod にアタッチするには、次のアノテーションを使用します。詳細については、「アノテーションを使用した Pod への EIP のアタッチ」をご参照ください。

パラメータ

説明

network.alibabacloud.com/pod-with-eip

"true"

EIP を自動的に作成して Pod にアタッチするかどうかを指定します。有効な値: true または false

network.alibabacloud.com/pod-eip-instanceid

"eip-bp14q***"

既存の EIP を使用します。EIP のインスタンス ID を入力します。詳細については、「EIP の申請」をご参照ください。

network.alibabacloud.com/eip-bandwidth

"5"

EIP の最大帯域幅 (単位:Mbit/s)。

network.alibabacloud.com/eip-internet-charge-type

"PayByTraffic"

EIP データ転送の課金方法。有効な値: PayByTraffic (デフォルト) | PayByBandwidth。詳細については、「EIP の課金方法」をご参照ください。

network.alibabacloud.com/eip-instance-charge-type

"PrePaid"

EIP インスタンスの課金方法。有効な値: PrePaid (サブスクリプション) | PostPaid (従量課金)。詳細については、「サブスクリプション」および「従量課金」をご参照ください。

network.alibabacloud.com/eip-common-bandwidth-package-id

"cbwp-slex***"

Pod の EIP を既存の Internet Shared Bandwidth インスタンスにアタッチします。

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***"

EIP の割り当て元となる IP アドレスプール。詳細については、「IP アドレスプール」をご参照ください。

network.alibabacloud.com/eip-resource-group-id

N/A

EIP のリソースグループ。詳細については、「EIP の申請」をご参照ください。

network.alibabacloud.com/eip-name

N/A

EIP の名前。

network.alibabacloud.com/eip-description

N/A

EIP の説明。

network.alibabacloud.com/eip-security-protection-types

N/A

EIP に適用するセキュリティサービス。複数の値をコンマ (,) で区切ります。詳細については、「EIP の申請」をご参照ください。

network.alibabacloud.com/pod-eip-release-strategy

"Never"

Pod 削除時の Pod の EIP のリリースポリシー。有効な値:

  • Follow (デフォルト): Pod が削除されると EIP はリリースされます。

  • Never: EIP は保持されます。不要になった場合は手動で削除してください。

  • Go スタイルの期間: たとえば、5m30s は、Pod が削除されてから 5 分 30 秒後に EIP を削除します。

イメージ

パラメータ

説明

registry.alibabacloud.com/plain-http-registry

"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"

平文の HTTP を使用するレジストリ。イメージリポジトリが HTTPS ではなく HTTP を使用する場合のプルの失敗を防ぐために、これを設定します。複数のエントリはコンマで区切ります。詳細については、「セルフマネージドイメージリポジトリの使用」をご参照ください。

registry.alibabacloud.com/insecure-registry

"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"

自己署名証明書を持つレジストリ。証明書検証をスキップし、プルの失敗を防ぐために、これを設定します。複数のエントリはコンマで区切ります。

スケジューリング

機能

パラメータ

説明

Pod マルチゾーンスケジューリングポリシー

scheduling.alibabacloud.com/schedule-strategy

"VSwitchOrdered"

マルチゾーンのスケジューリングポリシー。有効な値:

  • VSwitchOrdered: リストされている順序で vSwitch 間で Pod をスケジューリングします。

  • VSwitchRandom: ランダムな順序で vSwitch 間で Pod をスケジューリングします。

Pod 障害処理ポリシー

scheduling.alibabacloud.com/fail-strategy

"fail-back"

Pod の障害処理ポリシー。有効な値:

  • fail-back: 障害から自動的に回復します。Pod の作成に失敗した場合、システムは自動的に再作成を試みます。

  • fail-over: 障害時に Pod を転送します。これは fail-back と同じ効果があります。

  • fail-fast: Pod の作成に失敗した場合、すぐにエラーが報告されます。

Pod の最大保留期間

scheduling.alibabacloud.com/max-pending-minute

"10"

Pod が Pending 状態に留まることができる最大期間。タイムアウト期間を超えると、システムは自動的にインスタンスを終了します。

値は 10-1440 の範囲の整数である必要があります。単位は分です。最小期間は 10 分、最大は 1 日です。デフォルト値は 4 時間です。

カウントダウンは、サンドボックスの作成が開始されたときに始まります。まだサンドボックスの作成段階に達していない Pod は、このタイムアウトの影響を受けません。

オペレーティングシステム

パラメータ

値の例

説明

alibabacloud.com/os-kernel-config

{"transparentHugepageEnabled": "madvise","transparentHugepageShmemEnabled": "advise"}

Pod の OS の透過的ヒュージページ設定。サポートされるコンピューティングクラス: GPU および GPU-HPN。サブパラメータ:

  • transparentHugepageEnabled/sys/kernel/mm/transparent_hugepage/enabled にマッピングされます。有効な値:

    • always

    • madvise

    • never

  • transparentHugepageShmemEnabled/sys/kernel/mm/transparent_hugepage/shmem_enabled にマッピングされます。有効な値:

    • always

    • within_size

    • advise

    • never

    • deny

    • force

ACS によって追加されるアノテーション

説明

ACS は、Pod の作成後にこれらのアノテーションを Pod に書き込みます。これらのアノテーションは、Elastic Network Interface (ENI) や EIP の割り当てなど、実行時の割り当て結果を反映します。これらのアノテーションは設定または変更できません。

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。複数の vSwitch を指定した場合、実際に使用されたものが表示されます。

EIP 割り当て

パラメータ

値の例

説明

network.alibabacloud.com/allocated-eip-id

"eip-bp1m***"

割り当てられた EIP の ID。

network.alibabacloud.com/allocated-eip-address

"116.62.***"

割り当てられた EIP の IP アドレス。

リソース仕様

パラメータ

値の例

説明

alibabacloud.com/pod-use-spec

"2.5-5Gi"

正規化された CPU とメモリの仕様。フォーマットは {xxvCPU}-{xxGiB} です。

alibabacloud.com/pod-gpu-use-spec

"1"

正規化された GPU カード数。

alibabacloud.com/pod-ephemeral-storage

"30Gi"

GiB 単位の正規化されたエフェメラルストレージサイズ。

スケジューリング結果

パラメータ

値の例

説明

topology.kubernetes.io/region

"cn-hangzhou"

Pod が実行されているリージョン。

topology.kubernetes.io/zone

"cn-hangzhou-i"

Pod が実行されているゾーン。

その他の metadata

パラメータ

値の例

説明

alibabacloud.com/instance-id

"acs-sdsf***"

ACS Pod のインスタンス ID。

alibabacloud.com/request-id

"6925D4B7-***"

Pod 作成 API リクエストのリクエスト ID。

レガシーアノテーションの互換性

以下のレガシーアノテーションは、後方互換性のためにサポートされています。新しい Deployment では、以下に記載されている、推奨される代替アノテーションを使用してください。

レガシーアノテーション

推奨される代替

k8s.aliyun.com/eci-eip-instanceid

network.alibabacloud.com/pod-eip-instanceid

k8s.aliyun.com/eip-charge-type

network.alibabacloud.com/eip-internet-charge-type