配置eci-profile

功能介绍

阿里云容器服务ACK通过VK（部署ack-virtual-node组件）使用ECI时，可能会碰到以下问题：

• 需要上层业务修改YAML才能调度Pod到ECI

• 需要上层业务修改YAML才能开启ECI特有的高级特性

这类问题导致了运维管理工作和业务管理工作混淆在一起。为解决此类问题，ECI支持了eci-profile。eci-profile可以实现以下三个功能：

• ECI Scheduler

  在混合使用ECI和普通节点的场景下，一般可以通过配置Pod Label、配置Namespace Label和配置ECI弹性调度等方式将Pod调度到ECI，但这些方式均需要对存量资源做一定的修改，无法做到零侵入。

  对于上述情况，ECI Scheduler基于Mutating Webhook机制实现了一种新的调度机制。在eci-profile中，您可以自定义selector，selector可以根据Pod的Label或者Pod所属Namespace的Label来筛选Pod，满足selector筛选条件的Pod会自动调度到ECI。

• ECI Effect

  对于ECI的一些功能特性，例如指定ECS实例规格，启用镜像缓存，设置NTP服务等，需要在Pod中追加Annotation或者Label来实现。更多信息，请参见ECI Pod Annotation。

  对于上述情况，ECI Effect实现了自动追加Annotation和Label的功能。在eci-profile中，您可以自定义selector，在selector中同时指定筛选条件和要追加的Annotation和Label，满足selector筛选条件的Pod会自动调度到ECI，并自动追加指定的Annotation和Label。

• 配置热更新

  eci-profile中包含了Cluster IP、混合云模式、日志采集、交换机等配置，您可以根据需要进行更新。

  • 更新配置时无需重启VK。

  • 对于新创建的ECI Pod，可以即时生效更新后的配置；对于存量ECI Pod，需要滚动发布后才能生效更新后的配置。

注意事项

• 使用该功能时，请确保集群中的VK（ack-virtual-node组件）为最新版本。关于如何升级组件，请参见管理组件。

• 如果需要使用ECI Scheduler功能，则必须要开启Webhook。ACK Serverless集群默认调度Pod到ECI，无需使用ECI Scheduler功能。

配置说明

创建Pod时，系统会读取kube-system命名空间下的eci-profile配置文件（名为eci-profile的ConfigMap），按其data配置来创建Pod。您可以通过kubectl get cm -n kube-system eci-profile -o yaml命令查看eci-profile的YAML。eci-profile的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配置，配置selectors或更新固定配置项。

修改eci-profile的方式如下：

• 通过kubectl edit命令

  kubectl edit configmap eci-profile -n kube-system

• 通过容器服务管理控制台

  1. 登录容器服务管理控制台。

  2. 在集群页面，找到目标集群，单击集群名称。

  3. 在集群管理页的左侧导航栏，选择配置管理>配置项。

  4. 选择命名空间为kube-system。

  5. 找到eci-profile，单击YAML编辑。

配置selectors

selectors包含了ECI Scheduler和ECI Effect的配置。创建Pod时，系统会按照selectors去匹配Pod，对于Label能够匹配上的Pod，会自动调度到ECI，或者追加Annotation和Label，以便生效ECI的功能特性。

selectors中可以包含多个selector，在每个selector中，您必须声明selector的name，可以根据需要声明以下信息：

• namespaceSelector：要匹配的Namespace Label。

• objectSelector：要匹配的Pod Label。

• effect：要动态追加的Annotation和Label。

selectors的配置模板如下：

data:
  selectors: |
    [
      {
        "name": "selector-demo1", #selector名称，必填，不能为空
        "namespaceSelector": {    #通过NameSpace Label筛选,可选
          "matchLabels": {        #要匹配的NameSpace Label。如果填写多个，为与关系
            "eci": "true"
          }
        },
        "objectSelector": {       #通过Pod Label筛选，可选
          "matchLabels": {        #要匹配的Pod Label。如果填写多个，为与关系
            "eci": "true"
          }
        },
        "effect": {               #要动态追加的Annotation和Label，可选
          "annotations": {
            "k8s.aliyun.com/eci-use-specs": "ecs.c6.xlarge"
          },
          "labels": {
            "created-by-eci": "true"
          }
        }
      },
      {
        "name": "selector-demo2",   
        "objectSelector": {      
          "matchLabels": {     
            "eci": "test"
    	  }
        }
      }
    ]

上述模板中，名为selector-demo1的selector可以实现以下功能：

如果Pod所属命名空间含有eci: true Label，并且Pod本身含有eci: true Label，则该Pod会自动调度到ECI，并且增加"k8s.aliyun.com/eci-use-specs": "ecs.c6.xlarge"的Annotation，以及created-by-eci: true Label。

配置selectors后，您可以通过以下命令确认selectors是否生效。如果返回的YAML中已包含配置的selectors，则表示配置成功；如果未包含selectors，请检查selectors的格式是否有误。

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中包含的vpcId、vswitchIds等固定配置项对应VPC、交换机等信息，您可以根据需要进行更新，更新后的配置可以即时生效（无需重启VK）。支持更新的配置项如下：

配置示例如下：

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