指定或排除ECS规格代数创建ECI实例 - 弹性容器实例

在指定vCPU和内存创建ECI Pod的场景下，如果您对规格有一定要求，例如只想使用6代ECS规格（如g6、c6等），可添加k8s.aliyun.com/eci-instance-generation的Annotation来指定ECS规格代数。本文介绍创建ECI Pod时，如何指定或排除ECS规格代数。

功能说明

指定vCPU和内存创建ECI Pod时，系统会使用多种ECS规格进行支撑，并自动选择满足vCPU和内存条件且有库存的规格。此时，您可以添加Annotation（k8s.aliyun.com/eci-instance-generation）来指定或排除ECS规格代数。

如果指定了某些ECS规格代数，则系统仅会从相应代数的ECS规格中进行选择，如果指定的ECS规格代数没有库存，则不会创建ECI Pod。
如果排除了某些ECS规格代数，则系统在选择规格时会排除这些规格代数，从其他ECI支持的ECS规格代数中选择规格。

支持指定或排除的ECS规格代数，及其包含的ECS规格族如下：

ECS规格代数	ECS规格族
8	g8i、c8i、r8i、hfg8i、hfc8i、hfr8i
7	g7、c7、r7、hfg7、hfc7、hfr7、g7ne
6	g6e、g6、c6e、c6、r6e、r6、hfc6、hfg6
5	u1、g5、g5ne、c5、r5、ic5、hfc5、hfg5
4	sn2ne、sn1ne、se1ne、se1

关于ECS规格的详细信息，请参见：

注意事项

指定ECS规格代数创建的ECI Pod按照实际生成的ECS规格进行计费，不按照vCPU和内存计费。
重要
ECI Pod创建成功后，您可以执行kubectl describe pod命令查看其YAML详情，通过k8s.aliyun.com/eci-instance-spec字段确认ECI Pod实际使用的ECS规格，ECI会按照该ECS规格进行计费。
指定或排除ECS规格代数时，系统无法自动选择到某些规格，如GPU规格（如gn6i）、本地盘规格（如i2g）等。如有需要，请明确指定ECS规格来创建ECI Pod。具体操作，请参见指定ECS规格创建Pod。
支持指定或排除规格代数创建抢占式实例，该场景下系统会综合考量配置的代数顺序和市场价格（价格优先），为您选择最优的实例规格。如果您对规格代数有严格要求，建议只配置一个代数。
指定或排除ECS规格代数的功能仅适用于指定vCPU和内存规格的场景，如果优先指定的是ECS规格，则该功能不会生效。

配置说明

k8s.aliyun.com/eci-instance-generation的取值为ECS规格代数，相关说明如下：

支持配置多个规格代数，取值范围为4、5、6、7。
在规格代数前加上-表示排除该规格代数。
例如：k8s.aliyun.com/eci-instance-generation: "-5,-4"表示排除5代和4代ECS规格，使用7代或6代ECS规格。
对于指定的规格代数，系统会按照配置的顺序进行选择。
例如：k8s.aliyun.com/eci-instance-generation: "6,5"表示优先使用6代ECS规格，当6代ECS规格中，满足vCPU和内存条件的规格库存不足时，使用5代ECS规格。如果5代ECS规格库存仍不足，则创建失败。

使用k8s.aliyun.com/eci-instance-generation时，必须先指定vCPU和内存规格，您可以通过以下两种方式指定：

通过定义容器的limits或requests来指定，建议使用limits。
在Pod metadata中添加k8s.aliyun.com/eci-use-specs的Annotation来指定。

示例一：指定ECS规格代数

配置项	实现效果
通过limit指定了vCPU和内存资源（2 vCPU，4 GiB内存）。通过`k8s.aliyun.com/eci-instance-generation: "6,5"` 指定优先使用6代ECS规格，其次使用5代ECS规格。	优先从6代ECS规格中选择满足vCPU和内存条件的规格。如果6代ECS规格库存不足，从5代规格中进行选择。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test
  labels:
    app: test
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      name: nginx-test
      labels:
        app: nginx
        alibabacloud.com/eci: "true" 
      annotations:
        k8s.aliyun.com/eci-instance-generation: "6,5"    # 指定优先使用6代ECS规格，其次使用5代ECS规格
    spec:
      containers:
      - name: nginx
        image: registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
        ports:
        - containerPort: 80
        resources:
          limits:
            cpu: "2"       # vCPU上限        
            memory: "4Gi"  # 内存上限

示例二：排除ECS规格代数

配置项	实现效果
通过`k8s.aliyun.com/eci-use-specs: "2-4Gi"`指定vCPU和内存资源（2 vCPU，4 GiB内存）。通过`k8s.aliyun.com/eci-instance-generation: "-5,-4"` 排除使用5代和4代ECS规格。	从7代和6代ECS规格中选择满足vCPU和内存条件的规格。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test
  labels:
    app: test
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      name: nginx-test
      labels:
        app: nginx
        alibabacloud.com/eci: "true" 
      annotations:
        k8s.aliyun.com/eci-use-specs: "2-4Gi"                    # 指定模糊的vCPU和内存规格
        k8s.aliyun.com/eci-instance-generation: "-5,-4"          # 排除5代和4代ECS规格
    spec:
      containers:
      - name: nginx
        image: registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
        ports:
        - containerPort: 80

示例三：指定ECS规格代数并排除ECS规格族

配置项	实现效果
通过`k8s.aliyun.com/eci-use-specs: "2-4Gi"`指定vCPU和内存资源（2 vCPU，4 GiB内存）。通过`k8s.aliyun.com/eci-instance-generation: "6,5"` 指定优先使用6代ECS规格，其次使用5代ECS规格。通过`k8s.aliyun.com/eci-instance-family: "-ecs.hfg5"`排除ecs.hfg5规格族。	优先从6代ECS规格中选择满足vCPU和内存条件的规格。如果6代ECS规格库存不足，从除了ecs.hfg5规格族外的其他ECI支持的5代ECS规格中进行选择。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test
  labels:
    app: test
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      name: nginx-test
      labels:
        app: nginx
        alibabacloud.com/eci: "true" 
      annotations:
        k8s.aliyun.com/eci-use-specs: "2-4Gi"                   # 指定模糊的vCPU和内存规格
        k8s.aliyun.com/eci-instance-generation: "6,5"           # 指定优先使用6代ECS规格，其次使用5代ECS规格
        k8s.aliyun.com/eci-instance-family: "-ecs.hfg5"           # 排除ecs.hfg5规格族
    spec:
      containers:
      - name: nginx
        image: registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
        ports:
        - containerPort: 80

示例四：排除ECS规格代数并排除ECS规格族

配置项	实现效果
通过`k8s.aliyun.com/eci-use-specs: "2-4Gi"`指定vCPU和内存资源（2 vCPU，4 GiB内存）。通过`k8s.aliyun.com/eci-instance-generation: "-5,-4"` 排除使用5代和4代ECS规格。通过`k8s.aliyun.com/eci-instance-family: "-ecs.hfg6"`排除ecs.hfg6规格族。	从除了ecs.hfg6规格族外的其他7代和6代ECS规格中选择满足vCPU和内存条件的规格。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test
  labels:
    app: test
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      name: nginx-test
      labels:
        app: nginx
        alibabacloud.com/eci: "true" 
      annotations:
        k8s.aliyun.com/eci-use-specs: "2-4Gi"                    # 指定模糊的vCPU和内存规格
        k8s.aliyun.com/eci-instance-generation: "-5,-4"          # 排除5代和4代ECS规格
        k8s.aliyun.com/eci-instance-family: "-ecs.hfg6"            # 排除ecs.hfg6规格族
    spec:
      containers:
      - name: nginx
        image: registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
        ports:
        - containerPort: 80

示例五：不生效配置

指定ECS规格代数的功能仅适用于模糊指定vCPU和内存规格的场景，不适用于明确指定ECS规格的场景。如果指定ECS规格代数的功能没有生效，会生成IgnoreInstanceTypeFeatures事件。

事件名称	事件类型	事件信息	事件说明
IgnoreInstanceTypeFeatures	Warning	[eci.containergroup]The instance type features will be ignored as the provided specifications, [%s],correspond exclusively to ECS instance types.	由于已通过`k8s.aliyun.com/eci-use-specs`明确指定了ECS规格，因此自动忽略指定ECS规格代数的Annotation。

如下示例中，会自动忽略指定6代ECS规格的Annotation，仅使用ecs.c5.large规格创建ECI Pod。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test
  labels:
    app: test
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      name: nginx-test
      labels:
        app: nginx
        alibabacloud.com/eci: "true" 
      annotations:
        k8s.aliyun.com/eci-use-specs: "ecs.c5.large"   # 指定明确的ECS规格
        k8s.aliyun.com/eci-instance-generation: "6"    # 指定ECS规格代数（实际不会生效）
    spec:
      containers:
      - name: nginx
        image: registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
        ports:
        - containerPort: 80