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"
...ネットワーク
パラメータ | 例 | 説明 |
|
| Pod の vSwitch ID。複数の ID を指定して、ゾーン間で Pod を作成します。詳細については、「Pod の vSwitch とセキュリティグループの指定」をご参照ください。 重要
|
|
| Pod のセキュリティグループ ID。複数の ID を指定して、複数のセキュリティグループをアタッチします。 |
|
| Pod のカスタム DNS 設定。詳細については、「アノテーションを使用したカスタム DNS の設定」をご参照ください。 |
|
| Pod の NetworkPolicy を有効にします。デフォルト: |
EIP 設定
Elastic IP アドレス (EIP) を Pod にアタッチするには、次のアノテーションを使用します。詳細については、「アノテーションを使用した Pod への EIP のアタッチ」をご参照ください。
パラメータ | 例 | 説明 |
|
| EIP を自動的に作成して Pod にアタッチするかどうかを指定します。有効な値: |
|
| 既存の EIP を使用します。EIP のインスタンス ID を入力します。詳細については、「EIP の申請」をご参照ください。 |
|
| EIP の最大帯域幅 (単位:Mbit/s)。 |
|
| EIP データ転送の課金方法。有効な値: |
|
| EIP インスタンスの課金方法。有効な値: |
|
| Pod の EIP を既存の Internet Shared Bandwidth インスタンスにアタッチします。 |
|
| EIP の回線タイプ。有効な値: |
|
| EIP の割り当て元となる IP アドレスプール。詳細については、「IP アドレスプール」をご参照ください。 |
| N/A | EIP のリソースグループ。詳細については、「EIP の申請」をご参照ください。 |
| N/A | EIP の名前。 |
| N/A | EIP の説明。 |
| N/A | EIP に適用するセキュリティサービス。複数の値をコンマ ( |
|
| Pod 削除時の Pod の EIP のリリースポリシー。有効な値:
|
イメージ
パラメータ | 例 | 説明 |
|
| 平文の HTTP を使用するレジストリ。イメージリポジトリが HTTPS ではなく HTTP を使用する場合のプルの失敗を防ぐために、これを設定します。複数のエントリはコンマで区切ります。詳細については、「セルフマネージドイメージリポジトリの使用」をご参照ください。 |
|
| 自己署名証明書を持つレジストリ。証明書検証をスキップし、プルの失敗を防ぐために、これを設定します。複数のエントリはコンマで区切ります。 |
スケジューリング
機能 | パラメータ | 例 | 説明 |
Pod マルチゾーンスケジューリングポリシー | scheduling.alibabacloud.com/schedule-strategy | "VSwitchOrdered" | マルチゾーンのスケジューリングポリシー。有効な値:
|
Pod 障害処理ポリシー | scheduling.alibabacloud.com/fail-strategy | "fail-back" | Pod の障害処理ポリシー。有効な値:
|
Pod の最大保留期間 | scheduling.alibabacloud.com/max-pending-minute | "10" | Pod が Pending 状態に留まることができる最大期間。タイムアウト期間を超えると、システムは自動的にインスタンスを終了します。 値は カウントダウンは、サンドボックスの作成が開始されたときに始まります。まだサンドボックスの作成段階に達していない Pod は、このタイムアウトの影響を受けません。 |
オペレーティングシステム
パラメータ | 値の例 | 説明 |
|
| Pod の OS の透過的ヒュージページ設定。サポートされるコンピューティングクラス: GPU および GPU-HPN。サブパラメータ:
|
ACS によって追加されるアノテーション
ACS は、Pod の作成後にこれらのアノテーションを Pod に書き込みます。これらのアノテーションは、Elastic Network Interface (ENI) や EIP の割り当てなど、実行時の割り当て結果を反映します。これらのアノテーションは設定または変更できません。
ENI 割り当て
パラメータ | 値の例 | 説明 |
|
| 割り当てられた ENI の ID。 |
|
| ENI が属する VPC の ID。 |
|
| ENI が割り当てられた vSwitch の ID。複数の vSwitch を指定した場合、実際に使用されたものが表示されます。 |
EIP 割り当て
パラメータ | 値の例 | 説明 |
|
| 割り当てられた EIP の ID。 |
|
| 割り当てられた EIP の IP アドレス。 |
リソース仕様
パラメータ | 値の例 | 説明 |
|
| 正規化された CPU とメモリの仕様。フォーマットは |
|
| 正規化された GPU カード数。 |
|
| GiB 単位の正規化されたエフェメラルストレージサイズ。 |
スケジューリング結果
パラメータ | 値の例 | 説明 |
|
| Pod が実行されているリージョン。 |
|
| Pod が実行されているゾーン。 |
その他の metadata
パラメータ | 値の例 | 説明 |
|
| ACS Pod のインスタンス ID。 |
|
| Pod 作成 API リクエストのリクエスト ID。 |
レガシーアノテーションの互換性
以下のレガシーアノテーションは、後方互換性のためにサポートされています。新しい Deployment では、以下に記載されている、推奨される代替アノテーションを使用してください。
レガシーアノテーション | 推奨される代替 |
|
|
|
|