Container Service for Kubernetes:ECIポッド注釈

機能と関連ドキュメント

注釈

例

説明

複数のゾーンを設定してポッドを作成

k8s.aliyun.com/eci-vswitch

vsw-bp1xpiowfm5vo8o3c ****

vSwitch IDを指定します。 複数のvSwitch IDを指定して、十分なリソースが存在するゾーンにポッドを確実に作成できます。

k8s.aliyun.com/eci-schedule-strategy

VSwitchOrdered

マルチゾーンスケジューリングポリシーを設定します。 有効な値：

• VSwitchOrdered: 指定されたゾーンのリソースは、vSwitchが指定された順序に基づいてスケジュールされます。

• VSwitchRandom: 指定されたゾーンのリソースはランダムにスケジュールされます。

• 複数の仕様を指定したポッドの作成

• ポッドを作成するvCPUの数とメモリサイズの指定

• ECSインスタンスタイプを指定してポッドを作成

k8s.aliyun.com/eci-use-specs

2-4Gi、4-8Gi、ecs.c6.xlarge

ポッドの1つ以上の仕様を指定します。 仕様は、vCPUの数とメモリサイズの組み合わせにすることができます。 仕様は、ECS (Elastic Compute Service) インスタンスのインスタンスタイプでもあります。

k8s.aliyun.com/eci-gpu-driver-version

テスラ=525.85.12

GPUドライバーのバージョンを指定します。

GPU高速化エラスティックコンテナインスタンスを作成するときに、GPUドライバーとCUDAの複数のバージョンをサポートするGPU高速化ECSインスタンスファミリーを指定した場合、このアノテーションを設定してドライバーとCUDAのバージョンを指定できます。

特定のECSインスタンスファミリーを指定または除外してポッドを作成

k8s.aliyun.com/eci-instance-family

"ecs.c6、ecs.g6"

vCPUとメモリの仕様を指定して、ポッドを作成するときに特定のECSインスタンスファミリーを指定または除外します。

特定の世代のECSインスタンスファミリーを指定または除外してポッドを作成

k8s.aliyun.com/eci-instance-generation

「6,5」

vCPUとメモリの仕様を指定して、ポッドを作成するときにECSインスタンスファミリーの特定の世代を指定または除外します。

ポッドを作成する計算カテゴリの指定

k8s.aliyun.com/eci-compute-category

経済

さらに、vCPUとメモリの仕様を指定してポッドを作成するときに計算カテゴリを指定します。

• 有効な値: economyとgeneral。

• 複数の計算カテゴリを指定できます。 システムは、計算カテゴリの指定された順序に基づいて、ポッドのカテゴリを選択します。

プリエンプティブエラスティックコンテナインスタンスの作成

k8s.aliyun.com/eci-spot-strategy

SpotAsPriceGo

プリエンプティブルインスタンスの入札ポリシーを指定します。 有効な値：

• SpotWithPriceLimit: インスタンスは、1時間あたりの最大料金を指定するプリエンプティブルインスタンスとして作成されます。 この入札ポリシーを使用する場合は、e k8s.aliyun.com/eci-spot-price-limit注釈を指定する必要があります。

• SpotAsPriceGo: インスタンスは、購入時の市場価格が自動的に入札価格として使用されるプリエンプティブルインスタンスとして作成されます。

k8s.aliyun.com/eci-spot-price-limit

「0.5」

プリエンプティブルインスタンスの最大時間料金を指定します。 この値は、小数点以下3桁まで正確です。

このアノテーションは、n k8s.aliyun.com/eci-spot-strategyがSpotWithPriceLimitに設定されている場合にのみ有効です。

k8s.aliyun.com/eci-spot-duration

"0"

プリエンプティブルインスタンスの保護期間を指定します。 単位：時間。 デフォルト値は 1 です。 0の値は、保護期間がないことを示す。

k8s.aliyun.com/eci-spot-fallback

"true"

プリエンプティブルインスタンス仕様の要件を満たすインベントリリソースが不十分な場合に、従量課金インスタンスを自動的に作成するかどうかを指定します。 デフォルト値：false

伸縮性保証のプライベートプールを使用してポッドを作成

k8s.aliyun.com/eci-privatepool-matchcriteria

「オープン」

システムがプライベートプールと一致する一致モードを指定します。 有効な値：

• Open: システムは、インスタンスを開いているプライベートプールと照合します。

• ターゲット: この一致モードを使用する場合は、プライベートプールIDを指定する必要があります。 ターゲットプライベートプールを使用してポッドを作成する場合は、このマッチングモードを使用する必要があります。

k8s.aliyun.com/eci-privatepool-id

eap-2ze1g68k2melxkkl ****

プライベートプールID (elasticity assurance ID) を指定します。 プライベートプールIDは、ECSコンソールの [リソース予約] ページの [リソース予約] または [プライベートプール] タブで取得できます。

• Targetにt k8s.aliyun.com/eci-privatepool-matchcriteriaを指定する場合は、このアノテーションを設定する必要があります。

• [開く] にt k8s.aliyun.com/eci-privatepool-matchcriteriaした場合、このアノテーションは無効です。

ポッドの障害処理ポリシーの設定

k8s.aliyun.com/eci-fail-strategy

フェイルバック

Elastic Container Instanceベースのポッドの障害処理ポリシーを指定します。 有効な値：

• fail-back: ポッドの作成に失敗すると、システムは自動的にポッドの再作成を試みます。

• フェールオーバー: フェールオーバーの効果は、フェールバックの効果と同じです。

• fail-fast: ポッドの作成に失敗すると、システムはエラーを直接報告します。

Elastic Container Instanceベースのポッドの最大保留期間の指定

k8s.aliyun.com/eci-max-pending-minute

"30"

ポッドの最大保留期間を指定します。 最大保留期間が経過すると、システムは自動的にポッドを終了します。

値は10から1440までの整数でなければなりません。 単位は分です。 デフォルト値: 240

Elastic Containerインスタンスベースのポッドのホストの設定

k8s.aliyun.com/eci-custom-hosts

"[{\" ホスト \":\" example.com\",\" ip\":\" 100.100.XX.XX\"},{\" ホスト \":\" aliyundoc.com\",\" ip\":\" 100.100.XX.XX\"}]"

ポッドのホスト (/etc/hosts) を設定します。

カスタムタグをポッドにバインド

k8s.aliyun.com/eci-custom-tags

"env:test、name:alice"

タグ文字列を指定します。 最大3つのタグをバインドできます。 タグキーとタグ値はコロン (:) で区切ります。 複数入力する場合は、コンマ (,) で区切ります。

ポッドへのRAMロールの割り当て

k8s.aliyun.com/eci-ram-role-name

AliyunECIContainerGroupRole

ポッドが他のAlibaba Cloudサービスにアクセスするために引き受けることができるRAMロールをバインドします。

機能と関連ドキュメント

注釈

例

説明

ImageCachesを使用したポッドの作成の高速化

k8s.aliyun.com/eci-auto-imc

"true"

イメージキャッシュを自動的に一致させるかどうかを指定します。

k8s.aliyun.com/imc-perfect-match

"true"

ポッド内のすべてのコンテナーイメージがイメージキャッシュと完全に一致するかどうかを指定します。

k8s.aliyun.com/imc-match-count-request

"2"

イメージキャッシュと完全に一致させるポッド内のコンテナーイメージの数を指定します。

k8s.aliyun.com/eci-imc-id

imc-2zebxkiifuyzzlhl ****

イメージキャッシュのIDを指定します。

シークレットを使用せずにContainer Registryインスタンスからイメージをプルする

k8s.aliyun.com/acr-instance-ids

cri-j36zhodptmyq ****

Alibaba Cloud Container Registry Enterprise EditionインスタンスのIDを指定します。 シークレットを使用せずに、インスタンスからイメージをプルできます。

ポッドのリージョンとは異なるリージョンにあるContainer Registry Enterprise EditionインスタンスのIDを指定できます。 この場合、Enterprise EditionインスタンスのリージョンIDとEnterprise EditionインスタンスのIDのプレフィックスを付ける必要があります。 例: "cn-beijing:cri-j36zhodptmyq ****"

k8s.aliyun.com/acr-service-arns

acs:ram::1609982529 ******:role/role-assume

Elastic Container Instanceリソースが属するAlibaba CloudアカウントのRAMロールのAlibaba Cloudリソース名 (ARN) を指定します。

このアノテーションは、RAMロールを使用してリソースを作成する場合に必要です。

k8s.aliyun.com/acr-user-arns

acs:ram::1298452580 ******:role/role-acr

Container Registryインスタンスが属するAlibaba CloudアカウントのRAMロールのARNを指定します。

このアノテーションは、Elastic Container instanceリソースのAlibaba Cloudアカウントとは異なるAlibaba Cloudアカウントに属するContainer Registryインスタンスからイメージをプルする場合に必要です。

自己管理イメージリポジトリからイメージを取得

k8s.aliyun.com/plain-http-registry

港 *** .pre.com、192.168。XX.XX:5000、reg *** .test.com:80

自己管理イメージリポジトリのアドレスを設定します。 HTTPプロトコルを使用する自己管理イメージリポジトリ内のイメージを使用してポッドを作成する場合、この注釈をインスタンスに追加する必要があります。 このように、Elastic Container Instanceは、デフォルトのHTTPSプロトコルではなくHTTPプロトコルを介してイメージをプルします。 これは、異なるプロトコルによって引き起こされるイメージプル障害を防止する。

k8s.aliyun.com/insecure-registry

港 *** .pre.com、192.168。XX.XX:5000、reg *** .test.com:80

自己管理イメージリポジトリのアドレスを設定します。 自己署名証明書を使用する自己管理イメージリポジトリ内のイメージを使用してポッドを作成する場合、証明書の認証をスキップするには、この注釈をインスタンスに追加する必要があります。 これにより、証明書認証の失敗によるイメージプルの失敗を防ぎます。

機能と関連ドキュメント

注釈

例

説明

DataCacheを使用したポッドの作成

k8s.aliyun.com/eci-data-cache-bucket

default

DataCacheの格納に使用するバケットを指定します。 DataCachesを使用してポッドを作成する場合は、このアノテーションを設定する必要があります。

k8s.aliyun.com/eci-data-cache-pl

PL1

DataCacheに基づいて作成されるディスクのパフォーマンスレベルを指定します。 デフォルトでは、PL1拡張SSD (ESSD) が使用されます。

k8s.aliyun.com/eci-data-cache-provisionedIops

「40000」

k8s.aliyun.com/eci-data-cache-burstingEnabled

"true"

機能と関連ドキュメント

注釈

例

説明

ポッドへのセキュリティグループの割り当て

k8s.aliyun.com/eci-security-group

sg-bp1dktddjsg5nktv ****

セキュリティグループのIDを指定します。 次の要件を満たす必要があります。

• 最大5つのセキュリティグループを割り当てることができます。

• 割り当てられたセキュリティグループは、同じ仮想プライベートクラウド (VPC) に属している必要があります。

• 割り当てられたセキュリティグループは同じタイプである必要があります。

EIPをelasticコンテナインスタンスに関連付ける

k8s.aliyun.com/eci-eip-instanceid

eip-bp1q5n8cq4p7f6dzu ****

elastic IPアドレス (EIP) のIDを指定します。

k8s.aliyun.com/eci-with-eip

"true"

elasticコンテナインスタンスを作成し、EIPをインスタンスに関連付けるときにEIPを自動的に作成するかどうかを指定します。

k8s.aliyun.com/eip-bandwidth

"5"

EIPの最大帯域幅を指定します。 単位は、Mbit/s です。 既定値：5

k8s.aliyun.com/eip-common-bandwidth-package-id

cbwp-2zeukbj916scmj51m ****

インスタンスに関連付ける既存のEIP帯域幅プランのIDを指定します。 詳細については、「」をご参照ください。インターネット共有帯域幅とは何ですか?

k8s.aliyun.com/eip-isp

BGP

EIPのラインタイプを指定します。 このアノテーションは、従量課金EIPにのみ適用されます。 有効な値：

• BGP: BGP (マルチISP) ライン

• BGP_PRO: BGP (マルチISP) プロライン

詳細については、「What is an EIP」トピックの「Line type」セクションをご参照ください。

k8s.aliyun.com/eip-internet-charge-type

帯域幅課金

EIPの計測方法を指定します。 有効な値：

• PayByBandwidth：帯域幅課金

• PayByTraffic：トラフィック課金

EIPの課金の詳細については、「課金の概要」をご参照ください。

k8s.aliyun.com/eip-public-ip-address-pool-id

pippool-bp187arfugi543y1s ****

IPアドレスプールのIDを指定します。 EIPはIPアドレスプールから割り当てられます。 詳細については、「IPアドレスプールの作成と管理」をご参照ください。

Elastic Container InstanceベースのポッドへのIPv6アドレスの割り当て

k8s.aliyun.com/eci-enable-ipv6

"true"

ポッドにIPv6アドレスを割り当てるかどうかを指定します。

k8s.aliyun.com/eci-ipv6-bandwidth-enable

"true"

インスタンスのIPv6アドレス経由のインターネットアクセスを有効にするかどうかを指定します。

k8s.aliyun.com/eci-ipv6-bandwidth

100M

IPv6アドレスのピークパブリック帯域幅を指定します。

ポッドのプライベートIPアドレスの指定

k8s.aliyun.com/eci-private-ip-address

"172.16.0.1"

ポッドのプライベートIPアドレスを指定します。 IPv4 アドレスのみがサポートされています。 IPアドレスがアイドルであることを確認します。

固定IPアドレスを使用するようにElastic Container Instanceベースのポッドを設定する

k8s.aliyun.com/eci-fixed-ip

"true"

固定IPアドレスを使用するようにポッドを設定するかどうかを指定します。

k8s.aliyun.com/eci-fixed-ip-retain-hour

"24"

固定IPアドレスが有効になっているポッドが解放され、固定IPアドレスがアイドルになった後の固定IPアドレスの保持期間を指定します。 単位：時間。

アノテーションを設定しない場合、固定IPアドレスはデフォルトで48時間保持されます。

ポッドの受信帯域幅と送信帯域幅の制限

kubernetes.io/ingress-bandwidth

40M

インバウンド帯域幅を指定します。

kubernetes.io /出力帯域幅

20M

アウトバウンド帯域幅を指定します。

ポッドのカスタムDNSサーバーの構成

k8s.aliyun.com/eci-custom-dnsconfig

{\"ネームサーバー \":\"20.1.xx.xx,20.1.xx.xx\",\"searches\":\"xx.com,xx.eee\",\"options\":\"ndots:2,edns0\"}

ハイブリッドクラウドのシナリオでは、ポッドのドメインネームシステム (DNS) サーバーを指定し、DNSサーバーを使用して内部ドメイン名を解決します。

機能と関連ドキュメント

注釈

例

説明

一时ストレージスペースの容量を増やす

k8s.aliyun.com/eci-extra-ephemeral-storage

50Gi

一時記憶領域のサイズを指定します。

一時的なストレージスペースを暗号化するEncrypt the temporary storage space

k8s.aliyun.com/eci-ephemeral-storage-options

"{\" 暗号化された \":\" true\"}"

一時記憶領域のパラメーターを指定します。 "{\" encrypted\":\" true\"}"} の値は、一時的なストレージスペースに対して暗号化機能が有効になっていることを示します。

一時保管スペースが不足しているポッドを自動的に削除する

k8s.aliyun.com/eci-eviction-enable

"true"

一時保存領域が不足しているポッドを自動的に削除するかどうかを指定します。

機能と関連ドキュメント

注釈

例

説明

ポッドのNTPサービスの設定

k8s.aliyun.com/eci-ntp-server

100.100.*.*

ネットワークタイムプロトコル (NTP) サーバのIPアドレスを指定します。

機能と関連ドキュメント

注釈

例

説明

Simple Log Service CRDを使用したログの収集

k8s.aliyun.com/eci-sls-enable

"false"

ログ収集機能を有効にするかどうかを指定します。

Simple Log Service CRD (カスタムリソース定義) を使用してログを収集するときに、特定のポッドのログを収集したくない場合は、アノテーションをfalseに設定して、ログ収集機能を無効にできます。 これにより、システムがLogtailを自動的に作成するときのリソースの浪費を防ぎます。

機能と関連ドキュメント

注釈

例

説明

コアダンプファイルの表示

k8s.aliyun.com/eci-core-pattern

/pod/data/dump/core

コアダンプファイルを格納するディレクトリを指定します。