Container Compute Service:ACS Pod インスタンスの概要

ACS Pod 仕様正規化ロジック

たとえば、.resources.requests または .resources.limits の累積値が 2 vCPU および 3.5 GiB メモリの場合、ACS は起動時に Pod の仕様を自動的に 2 vCPU および 4 GiB メモリに正規化します。追加リソースは最初のコンテナーに適用され、Pod には alibabacloud.com/pod-use-spec=2-4Gi アノテーションが付与されます。リソース宣言の例を以下に示します。

apiVersion: v1 
kind: Pod
metadata:
  labels:
    app: nginx
    alibabacloud.com/compute-class: general-purpose
    alibabacloud.com/compute-qos: default
  name: nginx
spec:
  containers:
  - name: nginx
    image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
    ports:
    - containerPort: 80
    resources:
      requests:
        cpu: 2 # CPU を 2 vCPU として宣言
        memory: "3.5Gi" # メモリを 3.5 GiB として宣言
        ephemeral-storage: "30Gi" # ストレージスペースを 30 GiB として宣言

正規化後のリソース宣言：

apiVersion: v1 
kind: Pod
metadata:
  annotations:
    alibabacloud.com/pod-use-spec: "2-4Gi"
  labels:
    app: nginx
    alibabacloud.com/compute-class: general-purpose
    alibabacloud.com/compute-qos: default
  name: nginx
spec:
  containers:
  - name: nginx
    image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
    ports:
    - containerPort: 80
    resources:
      requests:
        cpu: 2 # CPU を 2 vCPU として宣言
        memory: "4Gi" # メモリを 4 GiB として宣言
        ephemeral-storage: "30Gi" # ストレージスペースを 30 GiB として宣言

アノテーションを使用した Pod 仕様の指定

適用範囲

• 汎用およびコンピュート最適化インスタンス CPU Pod のみをサポートします。

• アノテーションでサポートされる最大仕様は 64 vCPU/512 GiB で、「汎用コンピュートタイプ仕様」と一致します。

使用方法

Quality of Service（QoS） が Burstable（.resources.limits > .resources.requests）に設定されたワークロードの場合、alibabacloud.com/pod-required-spec: "X-YGi" アノテーションを使用して、対象となる Pod リソース仕様を宣言します。フォーマットは必ず <CPU>-<Memory> である必要があります。ここで、CPU はコア数で指定し（例：「2」は 2 vCPU を意味します）、メモリは GiB 単位で指定します（例：「4Gi」は 4 GiB を意味します）。詳細なスナップおよび使用ルールは以下のとおりです。

1. リソース仕様フォーマットが無効な場合（たとえば、単位が欠落している、Mi を使用している、順序が逆になっているなど）、Pod の作成は失敗します。

2. アノテーションを設定してもコンテナーの .resources が定義されていない場合、システムはアノテーションに厳密に従って正規化を行い、デフォルト仕様（例：2 vCPU/4 GiB）に戻ることはありません。

3. アノテーションで宣言された値が、すべてのコンテナーの .resources.requests の合計よりも小さい場合、Pod の作成は失敗します。

4. アノテーションで宣言された値が、すべてのコンテナーの .resources.limits の合計を超える場合、システムはアノテーションで宣言された値を Pod の対象正規化仕様として使用します。

   マルチコンテナー Pod では、最初のコンテナーがプライマリコンテナーとして指定されます。アノテーションで宣言された値と limits の合計（宣言値－現在の limits 合計）との差分は、まずプライマリコンテナーの .resources.limits（必要に応じて .resources.requests も調整）に割り当てられ、全体の Pod リソースを対象仕様に合わせます。

使用例

たとえば、alibabacloud.com/pod-required-spec: "2-4Gi" を設定し、コンテナーの .resources.requests または .resources.limits の累積値が 1 vCPU および 2 GiB メモリの場合、ACS は起動時に Pod の仕様を自動的に 2 vCPU および 4 GiB メモリに正規化します。追加リソースは最初のコンテナーに適用され、Pod には alibabacloud.com/pod-use-spec=2-4Gi アノテーションが付与されます。

リソース宣言の例を以下に示します。

ここでは、.resources.limits.memory は 3.5 GiB です。

apiVersion: v1 
kind: Pod
metadata:
  labels:
    app: nginx
    alibabacloud.com/compute-class: general-purpose
    alibabacloud.com/compute-qos: default
  annotations:
    alibabacloud.com/pod-required-spec: "2-4Gi"
  name: nginx
spec:
  containers:
  - name: nginx
    image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
    ports:
    - containerPort: 80
    resources:
      requests:
        cpu: 1 # CPU を 1 vCPU として宣言
        memory: "2Gi" # メモリを 2 GiB として宣言
        ephemeral-storage: "30Gi" # ストレージスペースを 30 GiB として宣言
      limits:
        cpu: 2 # CPU を 2 vCPU として宣言
        memory: "3.5Gi" # メモリを 3.5 GiB として宣言
        ephemeral-storage: "30Gi" # ストレージスペースを 30 GiB として宣言

正規化後のリソース宣言：

ここでは、.resources.limits.memory は 3.5 GiB から 4 GiB に正規化されています。

apiVersion: v1 
kind: Pod
metadata:
  annotations:
    alibabacloud.com/pod-required-spec: "2-4Gi"
    alibabacloud.com/pod-use-spec: "2-4Gi"
  labels:
    app: nginx
    alibabacloud.com/compute-class: general-purpose
    alibabacloud.com/compute-qos: default
  name: nginx
spec:
  containers:
  - name: nginx
    image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
    ports:
    - containerPort: 80
    resources:
      requests:
        cpu: 1 # CPU を 1 vCPU として宣言
        memory: "2Gi" # メモリを 2 GiB として宣言
        ephemeral-storage: "30Gi" # ストレージスペースを 30 GiB として宣言
      limits:
        cpu: 2 # CPU を 2 vCPU として宣言
        memory: "4Gi" # メモリを 4 GiB として宣言
        ephemeral-storage: "30Gi" # ストレージスペースを 30 GiB として宣言

自動仕様正規化

リソースリクエストまたは制限を指定しない場合、GPU コンテナ Pod は GPU タイプに基づいてサポートされている最小仕様（例：2 vCPU、2 GiB メモリ、1 枚の GPU カード）を選択します。

ACS は、サポートされていない仕様を自動的に正規化します。正規化後、コンテナーの .resources.requests は変更されませんが、Pod の正規化された仕様は alibabacloud.com/pod-use-spec アノテーションに表示されます。コンテナーで指定されたリソース制限（resources.limits）が Pod の正規化された仕様を超える場合、ACS はコンテナーのリソース制限を Pod の仕様に合わせて設定します。