:eci-profileの設定

eci-プロファイルの特徴

Container Service for Kubernetes (ACK) でElastic Container Instanceを使用するには、virtual Kubeletテクノロジと統合されたack-Virtual-nodeコンポーネントをデプロイする必要があります。 これにより、次の問題が発生する可能性があります。

• ポッドをElastic Container Instanceで実行するようにスケジュールするには、上位層のビジネスのYAMLファイルを変更する必要があります。

• Elastic Container Instanceの特定の高度な機能を有効にするには、上位層のビジネスのYAMLファイルを変更する必要があります。

上記の問題は、O&Mジョブとビジネスジョブの境界線を曖昧にしています。 これらの問題を回避するために、Elastic Container Instanceはeci-profile設定ファイルを提供します。 eci-プロファイルは次の機能を提供します。

• ECIスケジューラ

  実ノードと仮想ノードがデプロイされているシナリオでは、ポッドラベル、名前空間ラベル、およびElastic Container Instanceベースのスケジューリングを設定することで、KubernetesポッドをElastic Container Instanceで実行するようにスケジュールできます。 これらの設定を実行するには、クラスター内の既存のリソースを変更する必要があります。 この変更により、システムに脆弱性が生じる可能性があります。

  この問題に対処するために、ECI Schedulerは、Webhookの変化に基づく新しいスケジューリングメカニズムを提供します。 eci-profileでは、セレクターを設定できます。 次に、システムは、セレクターで指定されたポッドラベルまたは名前空間ラベルに基づいてポッドをフィルター処理します。 ポッドまたはその名前空間に対応するラベルがセレクターで指定されている場合、ポッドは自動的にElastic Container Instanceで実行されるようにスケジュールされます。

• ECI効果

  Elastic Container Instanceの一部の機能を有効にするには、ポッドにアノテーションまたはラベルを追加する必要があります。 これらの機能の例としては、ECS (Elastic Compute Service) のインスタンスタイプの指定、イメージキャッシュの有効化、NTP (Network Time Protocol) サービスの設定などがあります。 詳細については、「ECIポッド注釈」をご参照ください。

  ECI Effectは、ポッドにアノテーションとラベルを自動的に追加できます。 eci-profileでセレクターを設定するときに追加するフィルター条件と注釈とラベルを指定できます。 セレクターでフィルター条件を満たすポッドは、Elastic Container Instanceで実行されるように自動的にスケジュールされます。 指定されたアノテーションとラベルがポッドに追加されます。

• ホットアップデート

  eci-profileには、クラスターIPアドレス、ハイブリッドクラウド、ログ収集、およびvSwitchの設定が含まれます。 要件に基づいて設定を更新できます。

  • 設定を更新するためにack-virtual-nodeコンポーネントを再起動する必要はありません。

  • 更新された設定は、新しく作成されたElastic Container Instanceポッドにすぐに適用されますが、既存のElastic Container Instanceポッドには、ポッドでローリングリリースが実行された後にのみ適用されます。

注意事項

• eci-profileを設定するときは、クラスター内のack-virtual-nodeコンポーネントが最新バージョンであることを確認してください。 ack-virtual-nodeの更新方法については、「システムコンポーネントのアップグレード」をご参照ください。

• ECIスケジューラ機能を使用する場合は、変化するwebhooksを有効にする必要があります。 ACKサーバーレスクラスターのポッドは、エラスティックコンテナインスタンスで実行されるように自動的にスケジュールされます。 ポッドをスケジュールするためにECIスケジューラを使用する必要はありません。

設定の説明

システムがポッドを作成するとき、システムはkube-system名前空間のeci-profile構成ファイル (eci-profileという名前のConfigMap) を読み取ります。 次に、システムは構成ファイルのdataセクションの構成に基づいてポッドを作成します。 kubectl get cm -n kube-system eci-profile -o yamlコマンドを実行すると、eci-profileのYAMLファイルを表示できます。 eci-profilesのYAMLファイルテンプレート:

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のdataセクションの設定を変更して、セレクターを設定したり、その他の必要なパラメーターを更新したりできます。

次のいずれかの方法を使用して、eci-profileを変更できます。

• kubectl editコマンドを実行します。

  kubectl edit configmap eci-profile -n kube-system

• Container Service for Kubernetes (ACK) コンソールを使用します。

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

  2. [クラスター] ページで、管理するクラスターを見つけ、クラスターの名前をクリックします。

  3. クラスター管理ページの左側のナビゲーションウィンドウで、[設定]> [設定] を選択します。

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

  5. eci-profileを見つけて、対応する操作列で [YAMLの編集] をクリックします。

セレクターの設定

selectorsパラメーターには、ECI SchedulerとECI Effectの設定が含まれます。 システムがポッドを作成すると、システムはセレクタに基づいてポッドを照合します。 ポッドまたはその名前空間に対応するラベルがセレクターに含まれている場合、ポッドは自動的にElastic Container Instanceで実行されるようにスケジュールされるか、Elastic Container Instanceの高度な機能を有効にするために指定されたアノテーションとラベルが追加されます。

セレクターパラメーターには複数のセレクターを設定できます。 各セレクターの名前を指定する必要があります。 要件に基づいて、各セレクタの次の情報を指定することもできます。

• namespaceSelector: 一致する名前空間ラベル。

• objectSelector: 一致するポッドのラベル。

• effect: ポッドに動的に追加する注釈とラベル。

セレクタの設定テンプレート:

data:
  selectors: |
    [
      {
        "name": "selector-demo1", # The name of the selector. This is a required parameter.
        "namespaceSelector": {    # The namespace filter. This is an optional parameter based on namespace labels.
          "matchLabels": {        # The namespace labels to match. The logical relationship among multiple labels is AND.
            "eci": "true"
          }
        },
        "objectSelector": {       # The object filter. This is an optional parameter based on pod labels.
          "matchLabels": {        # The pod labels to match. The logical relationship among multiple labels is AND.
            "eci": "true"
          }
        },
        "effect": {               # The annotations and labels to dynamically add to the pods. This is an optional parameter.
          "annotations": {
            "k8s.aliyun.com/eci-use-specs": "ecs.c6.xlarge"
          },
          "labels": {
            "created-by-eci": "true"
          }
        }
      },
      {
        "name": "selector-demo2",   
        "objectSelector": {      
          "matchLabels": {     
            "eci": "test"
    	  }
        }
      }
    ]

上記のテンプレートでは、selector-demo1という名前のセレクターは次の機能を提供します。

ポッドとその名前空間の両方にeci: trueラベルが付いている場合、ポッドは自動的にElastic Container Instanceで実行されるようにスケジュールされます。 "k8s.aliyun.com/eci-use-specs": "ecs.c6.xlarge" とcreated-by-eci: trueラベルがポッドに追加されます。

セレクターを設定したら、次のコマンドを実行して、セレクターが有効かどうかを確認できます。 返されたYAMLファイルに設定済みのセレクターが含まれている場合、セレクターは有効になります。 返されたYAMLファイルに設定済みのセレクターが含まれていない場合は、セレクターが正しくフォーマットされているかどうかを確認します。

kubectl get mutatingwebhookconfigurations -o yaml vk-webhook

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

データ:
  セレクター: |
    [
      {
        "name":"gpu-namespace-selector" 、
        "namespaceSelector":{
          "matchLabels":{
            "gpu":"true"
          }
        },
        "effect": {
          "annotations": {
            "k8s.aliyun.com/eci-use-specs":"ecs.gn6v-c8g1.2xlarge"
          },        
          "labels":{
            "gpu":"test"
          }
        }
      }
    ]

データ:
  セレクター: |
    [
      {
        "name":"autoimc-object-selector" 、
        "objectSelector":{
          "matchLabels":{
            "imc":"auto"
          }
        },
        "effect": {
          "annotations": {
            "k8s.aliyun.com/eci-auto-imc": "true"
          }
        }
      }
    ]

データセクションの他の必要なパラメータを更新する

データセクションに含まれるその他の必須パラメーターでは、ポッドの作成に必要な情報を指定します。 たとえば、vpcIdパラメーターは、ポッドが属する仮想プライベートクラウド (VPC) を指定します。 vSwitchIdsパラメーターは、ポッドに関連付けられているvSwitchを指定します。 要件に基づいて、必要なパラメーターを更新できます。 更新された設定は、ack-virtual-nodeコンポーネントを再起動しなくてもすぐに有効になります。 次の必須パラメータを更新できます。

次のサンプルコードは、データセクションを設定する方法を示しています。

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****