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 # 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 # 2 vCPU をリクエストします。
        memory: "4Gi" # 4 GiB のメモリをリクエストします。
        ephemeral-storage: "30Gi" # 30 GiB のストレージをリクエストします。

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

適用範囲

• この機能は、汎用およびパフォーマンス拡張コンピューティングクラスの CPU Pod のみをサポートします。

• アノテーションでサポートされる最大仕様は 64 vCPU と 512 GiB のメモリであり、「汎用コンピューティングクラスの仕様」で説明されている制限に従います。

使用方法

Pod の 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 を定義していない場合、ACS はアノテーションの値を厳密に遵守し、デフォルトの仕様 (例：2 vCPU と 4 GiB のメモリ) にはフォールバックしません。

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

4. アノテーションの値がすべてのコンテナーの .resources.limits の合計を超える場合、ACS はアノテーションの値をターゲット仕様として使用します。

   複数コンテナーの Pod では、最初のコンテナーがプライマリコンテナーとして識別されます。アノテーションの値と現在の limits の合計との差分は、プライマリコンテナーの .resources.limits (および必要に応じて .resources.requests) に割り当てられ、Pod の総リソースがターゲット仕様と一致するようになります。

例

たとえば、アノテーションを alibabacloud.com/pod-required-spec: "2-4Gi" に設定し、コンテナーの .resources.requests または .resources.limits の合計が 1 vCPU と 2 GiB のメモリである場合、ACS は Pod の起動時に 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 # 1 vCPU をリクエストします。
        memory: "2Gi" # 2 GiB のメモリをリクエストします。
        ephemeral-storage: "30Gi" # 30 GiB のストレージをリクエストします。
      limits:
        cpu: 2 # 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 # 1 vCPU をリクエストします。
        memory: "2Gi" # 2 GiB のメモリをリクエストします。
        ephemeral-storage: "30Gi" # 30 GiB のストレージをリクエストします。
      limits:
        cpu: 2 # 2 vCPU をリクエストします。
        memory: "4Gi" # 4 GiB のメモリをリクエストします。
        ephemeral-storage: "30Gi" # 30 GiB のストレージをリクエストします。

仕様の自動調整

仕様を指定しない場合、GPU コンテナー Pod は GPU タイプに基づいて最小の Pod 仕様を使用します。たとえば、2 vCPU、2 GiB のメモリ、および 1 つの GPU カードです。

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