Container Service for Kubernetes:eci-profile の設定

仕組み

Pod が作成されると、ack-virtual-node は kube-system 名前空間にある eci-profile という名前の ConfigMap を読み取り、その data セクションの設定を Pod に適用します。

eci-profile は、次の 3 つの機能を提供します：

• ECI Scheduler：Mutating Webhook を使用して、Pod のラベルまたは名前空間のラベルに基づいて Pod を ECI にルーティングします。これにより、個々の Pod の YAML ファイルにスケジューリングディレクティブを追加する必要がなくなります。

• ECI Effect：一致した Pod にアノテーションとラベルを自動的に挿入し、Elastic Compute Service (ECS) インスタンスタイプの指定、イメージキャッシュの有効化、Network Time Protocol (NTP) サービスの設定などの高度な ECI 機能を有効にします。サポートされているアノテーションの完全なリストについては、「ECI Pod Annotation」をご参照ください。

• ホットアップデート：eci-profile (クラスター IP アドレス、ハイブリッドクラウド、ログ収集、vSwitch) への設定変更は、新しく作成された Pod に対して即座に有効になります。ack-virtual-node の再起動は不要です。既存の Pod は、ローリングアップデート後にのみ変更が適用されます。

前提条件

開始する前に、次のことを確認してください：

• クラスター内の ack-virtual-node アドオンが最新バージョンであること。更新するには、「コンポーネントの管理」をご参照ください。

• クラスターで Mutating Webhook が有効になっていること (ECI Scheduler に必要です)。ACK Serverless クラスターでは、Pod は自動的に ECI にスケジューリングされるため、ECI Scheduler は不要です。

注意事項

• eci-profile を更新すると、新しく作成された ECI Pod は更新された設定をすぐに使用します。既存の Pod は、ローリングアップデート後にのみ更新された設定を使用します。

• セレクターに namespaceSelector も objectSelector も設定せず、effect を設定した場合、その effect 設定は ECI にスケジューリングされるすべての Pod に適用されます。

• 複数のセレクターが 1 つの Pod に一致する場合、それらは順番に評価されます。先に一致したセレクターのアノテーションとラベルが、後に一致したセレクターのものより優先されます。既存の Pod のアノテーションとラベルは、effect によって挿入されるものよりも常に優先されます。

eci-profile の表示

次のコマンドを実行して、現在の eci-profile ConfigMap を表示します：

kubectl get cm -n kube-system eci-profile -o yaml

ConfigMap の data セクションには、次の 2 種類の設定が含まれています：

デフォルトの eci-profile は次のようになります：

apiVersion: v1
data:
  enableClusterIp: "true"
  enableHybridMode: "false"
  enableLinuxArm64Node: "false"
  enableLogController: "false"
  enablePVCController: "false"
  enablePrivateZone: "false"
  enableReuseSSLKey: "false"
  featureGates: "WaitForFirstConsumer=false"
  securityGroupId: sg-2zeeyaaxlkq9sppl****
  selectors: ""
  slsMachineGroup: ""
  vSwitchIds: vsw-2ze23nqzig8inprou****,vsw-2ze94pjtfuj9vaymf****
  vpcId: vpc-2zeghwzptn5zii0w7****
kind: ConfigMap
metadata:
  creationTimestamp: "2023-01-11T08:28:14Z"
  name: eci-profile
  namespace: kube-system
  resourceVersion: "356"
  uid: b345fa8c-919e-41fc-a981-57864b1a****

eci-profile の編集

次のいずれかの方法を使用して eci-profile を編集します。

kubectl

kubectl edit configmap eci-profile -n kube-system

ACK コンソール

1. Container Service for Kubernetes (ACK) コンソールにログインします。

2. [クラスター] ページで、目的のクラスターの名前をクリックします。

3. 左側のナビゲーションペインで、[構成 > ConfigMaps] を選択します。

4. [Namespace] ドロップダウンリストから [kube-system] を選択します。

5. eci-profile を見つけ、[アクション] 列の [YAML の編集] をクリックします。

セレクターの設定

セレクターは、どの Pod を ECI にルーティングするか (ECI Scheduler)、およびそれらの Pod にどのアノテーションまたはラベルを挿入するか (ECI Effect) を定義します。Pod が作成されると、システムは各セレクターを順番に評価し、一致するルールを適用します。

各セレクターは、次のフィールドをサポートしています：

• name (必須)：セレクターの一意の名前。

• namespaceSelector (任意)：名前空間のラベルに基づいて Pod を照合します。matchLabels の下にラベルを指定します。複数のラベルは AND ロジックを使用します。

• objectSelector (任意)：Pod のラベルに基づいて Pod を照合します。matchLabels の下にラベルを指定します。複数のラベルは AND ロジックを使用します。

• effect (任意)：一致した Pod に挿入するアノテーションとラベル。挿入された値は、既存の Pod のアノテーションやラベルを上書きしません。

data:
  selectors: |
    [
      {
        "name": "selector-demo1",         # 必須。一意のセレクター名。
        "namespaceSelector": {            # 任意。名前空間のラベルで照合。
          "matchLabels": {                # 複数のラベル間では AND ロジック。
            "eci": "true"
          }
        },
        "objectSelector": {               # 任意。Pod のラベルで照合。
          "matchLabels": {                # 複数のラベル間では AND ロジック。
            "eci": "true"
          }
        },
        "effect": {                       # 任意。挿入するアノテーションとラベル。
          "annotations": {
            "k8s.aliyun.com/eci-use-specs": "ecs.c6.xlarge"
          },
          "labels": {
            "created-by-eci": "true"
          }
        }
      },
      {
        "name": "selector-demo2",
        "objectSelector": {
          "matchLabels": {
            "eci": "test"
          }
        }
      }
    ]

kubectl get mutatingwebhookconfigurations -o yaml vk-webhook

設定例

data:
  selectors: |
    [
      {
        "name": "eci-selector",
        "namespaceSelector": {
          "matchLabels": {
            "type": "eci"
          }
        },
        "objectSelector": {
          "matchLabels": {
            "created-by-eci": "true"
          }
        }
      }
    ]

data:
  selectors: |
    [
      {
        "name": "gpu-namespace-selector",
        "namespaceSelector": {
          "matchLabels": {
            "gpu": "true"
          }
        },
        "effect": {
          "annotations": {
            "k8s.aliyun.com/eci-use-specs": "ecs.gn6v-c8g1.2xlarge"
          },
          "labels": {
            "gpu": "test"
          }
        }
      }
    ]

data:
  selectors: |
    [
      {
        "name": "autoimc-object-selector",
        "objectSelector": {
          "matchLabels": {
            "imc": "auto"
          }
        },
        "effect": {
          "annotations": {
            "k8s.aliyun.com/eci-auto-imc": "true"
          }
        }
      }
    ]

クラスターレベルパラメーターの更新

data セクションの次のパラメーターは、クラスターレベルのデフォルトです。Pod が Pod レベルのオーバーライドなしで作成された場合、eci-profile の値が使用されます。すべてのパラメーターはホットアップデートをサポートしており、変更は ack-virtual-node を再起動することなく即座に有効になります。

これらのパラメーターは、Pod レベルの設定で上書きされない場合にのみ適用されます。

featureGates: WaitForFirstConsumer について

WaitForFirstConsumer が "true" に設定されている場合：

• この設定を有効にする前に、csi-provisioner アドオンが最新バージョンである必要があります。

• PersistentVolume (PV) とバックエンドストレージは、Pod がスケジューリングされた後にのみ作成されます。StorageClass で指定されたゾーンとリージョンは使用されなくなり、代わりにスケジューリングされた Pod のノードのゾーンとリージョンがストレージリソースの作成に使用されます。これにより、コンピューティングリソースが優先的にスケジューリングされるようになります。

詳細については、「ボリュームバインディングモード」をご参照ください。

完全な data セクションの例：

data:
  enableClusterIp: "true"
  enableHybridMode: "false"
  enableLinuxArm64Node: "false"
  enableLogController: "false"
  enablePVCController: "false"
  enablePrivateZone: "false"
  enableReuseSSLKey: "false"
  securityGroupId: sg-2zeeyaaxlkq9sppl****
  selectors: ""
  slsMachineGroup: ""
  vSwitchIds: vsw-2ze23nqzig8inprou****,vsw-2ze94pjtfuj9vaymf****
  vpcId: vpc-2zeghwzptn5zii0w7****