如何指定ECS規格代數建立ECI執行個體 - Elastic Container Instance

在指定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規格類型系列
Arm	8	g8y、c8y、r8y
x86	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規格代數，相關說明如下：

支援配置多個規格代數，取值範圍為ECI支援的規格代數。
重要
目前8代規格僅支援Arm架構規格，建立Pod時需要通過nodeSelector調度到Arm節點，因此無法與其他x86架構的規格同時配置。建立Arm規格的ECI Pod時，無需使用規格代數功能來過濾規格（單獨指定或排除8代規格沒有實際意義）。更多資訊，請參見調度Pod到Arm架構的虛擬節點和指定Arm規格建立Pod。
在規格代數前加上-表示排除該規格代數。
例如：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	[ecs.instance]Ignore instance type features because specific k8s.aliyun.com/eci-use-specs is set	由於已通過`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