容器服务 Kubernetes 版 ACK：ECI Pod Annotation

功能及相关文档

参数

示例值

描述

多可用区创建Pod

k8s.aliyun.com/eci-vswitch

vsw-bp1xpiowfm5vo8o3c****

指定交换机ID，支持指定多个交换机实现多可用区功能。

k8s.aliyun.com/eci-schedule-strategy

VSwitchOrdered

多可用区调度策略。取值范围：

• VSwitchOrdered：按顺序

• VSwitchRandom：随机

• 多规格创建Pod

• 指定vCPU和内存创建Pod

• 指定ECS规格创建Pod

k8s.aliyun.com/eci-use-specs

2-4Gi,4-8Gi,ecs.c6.xlarge

指定ECI实例规格，支持指定多规格，包括指定vCPU和内存，或者ECS规格。

k8s.aliyun.com/eci-gpu-driver-version

tesla=525.85.12

指定GPU驱动版本。

创建GPU实例时，如果指定了支持多个驱动和CUDA版本的GPU规格，可配置该Annotation指定驱动和CUDA版本。

指定或排除ECS规格族创建Pod

k8s.aliyun.com/eci-instance-family

"ecs.c6,ecs.g6"

指定vCPU和内存创建ECI实例时，支持指定或排除ECS规格族。

指定或排除ECS规格代数创建Pod

k8s.aliyun.com/eci-instance-generation

"6,5"

指定vCPU和内存创建ECI实例时，支持指定或排除ECS规格代数。

指定算力类别创建Pod

k8s.aliyun.com/eci-compute-category

economy

指定vCPU和内存创建ECI实例时，支持进一步指定算力类别。

• 取值为economy（表示经济型）和general（表示通用型）。

• 支持设置多个算力类别，系统会按照设置顺序创建。

创建抢占式实例

k8s.aliyun.com/eci-spot-strategy

SpotAsPriceGo

抢占式实例的出价策略。取值范围：

• SpotWithPriceLimit：自定义设置抢占实例价格上限。此时必须设置k8s.aliyun.com/eci-spot-price-limit。

• SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。

k8s.aliyun.com/eci-spot-price-limit

"0.5"

抢占式实例的每小时价格上限，最多支持精确到小数点后三位。

仅当k8s.aliyun.com/eci-spot-strategy设置为SpotWithPriceLimit时有效。

k8s.aliyun.com/eci-spot-duration

"0"

抢占式实例的保护期。默认为1，可设置为0，表示无保护期。

k8s.aliyun.com/eci-spot-fallback

"true"

抢占式实例没有库存时，是否自动转为按量付费。默认为false。

使用弹性保障的私有资源池创建Pod

k8s.aliyun.com/eci-privatepool-matchcriteria

"Open"

配置私有池的匹配模式。取值范围：

• Open：开放模式。该模式下系统自动为实例匹配开放的私有池。

• Target：指定模式。该模式下必须同时指定私有池ID。当私有池类型为专有时，必须使用该模式。

k8s.aliyun.com/eci-privatepool-id

eap-2ze1g68k2melxkkl****

指定私有池ID（即弹性保障ID）。您可以在ECS管理控制台的资源预定页面的资源预定或者私有资源池页签下获取。

• 当k8s.aliyun.com/eci-privatepool-matchcriteria配置为Target时，必须配置该Annotation。

• 当k8s.aliyun.com/eci-privatepool-matchcriteria配置为Open时，该Annotation无效。

设置ECI Pod的故障处理策略

k8s.aliyun.com/eci-fail-strategy

fail-back

ECI Pod的故障处理策略，取值如下：

• fail-back：失败自动恢复。即Pod创建失败后自动尝试重新创建。

• fail-over：失败转移。效果等同于fail-back。

• fail-fast：快速失败。即Pod创建失败后直接报错。

自定义设置ECI Pod的最大Pending时长

k8s.aliyun.com/eci-max-pending-minute

"30"

自定义设置Pod对应ECI实例的最大Pending时长，超时后系统会自动终止实例。

取值范围为10~1440的整数，单位为分钟。默认为4小时。

自定义设置ECI Pod的hosts

k8s.aliyun.com/eci-custom-hosts

"[{\"host\":\"example.com\",\"ip\":\"100.100.XX.XX\"},{\"host\":\"aliyundoc.com\",\"ip\":\"100.100.XX.XX\"}]"

自定义设置ECI Pod的hosts（即/etc/hosts）。

为ECI Pod绑定自定义标签

k8s.aliyun.com/eci-custom-tags

"env:test,name:alice"

绑定的标签（Tag）字符串，最多可以绑定3个标签。标签键和标签值之间用半角冒号隔开，多个标签之间用半角逗号隔开。

为ECI Pod绑定RAM角色

k8s.aliyun.com/eci-ram-role-name

AliyunECIContainerGroupRole

绑定RAM角色，赋予ECI访问阿里云产品的能力。

功能及相关文档

参数

示例值

描述

使用ImageCache加速创建Pod

k8s.aliyun.com/eci-auto-imc

"true"

配置为true表示自动匹配镜像缓存。

k8s.aliyun.com/imc-perfect-match

"true"

自动匹配镜像缓存时，Pod内所有容器镜像是否均要完全匹配。

k8s.aliyun.com/imc-match-count-request

"2"

自动匹配镜像缓存时，Pod内要完全匹配的容器镜像个数。

k8s.aliyun.com/eci-imc-id

imc-2zebxkiifuyzzlhl****

指定镜像缓存ID。

免密拉取ACR镜像

k8s.aliyun.com/acr-instance-ids

cri-j36zhodptmyq****

指定ACR企业版实例，用于免密拉取镜像。

支持跨地域指定ACR企业版实例，此时需在实例ID前加上所属地域，例如"cn-beijing:cri-j36zhodptmyq****"。

k8s.aliyun.com/acr-service-arns

acs:ram::1609982529******:role/role-assume

ECI资源归属账号下的RAM角色的ARN。

指定RAM角色创建资源时需配置。

k8s.aliyun.com/acr-user-arns

acs:ram::1298452580******:role/role-acr

ACR实例归属账号下的RAM角色的ARN。

跨账号拉取ACR镜像时需配置。

拉取自建镜像仓库的镜像

k8s.aliyun.com/plain-http-registry

harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80

使用HTTP协议的自建镜像仓库中的镜像创建ECI实例时，需配置该Annotation，使得ECI使用HTTP协议拉取镜像，避免因协议不同而导致镜像拉取失败。

k8s.aliyun.com/insecure-registry

harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80

使用自签发证书的自建镜像仓库中的镜像创建ECI实例时，需配置该Annotation来跳过证书认证，避免因证书认证失败而导致镜像拉取失败。

功能及相关文档

参数

示例值

描述

使用DataCache创建Pod

k8s.aliyun.com/eci-data-cache-bucket

default

指定DataCache的Bucket。使用DataCache创建Pod时必须配置。

k8s.aliyun.com/eci-data-cache-pl

PL1

基于DataCache创建的云盘的性能等级。默认使用ESSD云盘，性能等级默认为PL1。

k8s.aliyun.com/eci-data-cache-provisionedIops

"40000"

k8s.aliyun.com/eci-data-cache-burstingEnabled

"true"

功能及相关文档

参数

示例值

描述

配置ECI Pod所属安全组

k8s.aliyun.com/eci-security-group

sg-bp1dktddjsg5nktv****

指定安全组ID。要求如下：

• 支持指定一个或多个安全组，最多可以指定5个安全组。

• 指定的安全组必须属于同一VPC。

• 指定的安全组的类型必须相同。

为ECI实例绑定EIP

k8s.aliyun.com/eci-eip-instanceid

eip-bp1q5n8cq4p7f6dzu****

绑定的EIP实例ID。

k8s.aliyun.com/eci-with-eip

"true"

配置为true表示自动创建并绑定EIP。

k8s.aliyun.com/eip-bandwidth

"5"

设置EIP带宽。单位为Mbps。默认为5 Mbps。

k8s.aliyun.com/eip-common-bandwidth-package-id

cbwp-2zeukbj916scmj51m****

绑定已有的共享带宽包ID。更多信息，请参见共享带宽。

k8s.aliyun.com/eip-isp

BGP

EIP线路类型，仅按量付费的EIP支持指定。取值范围：

• BGP：BGP（多线）线路

• BGP_PRO：BGP（多线）精品线路

更多信息，请参见EIP线路类型。

k8s.aliyun.com/eip-internet-charge-type

PayByBandwidth

EIP的计量方式。取值范围：

• PayByBandwidth：按带宽计费

• PayByTraffic：按流量计费

更多信息，请参见EIP计费方式。

k8s.aliyun.com/eip-public-ip-address-pool-id

pippool-bp187arfugi543y1s****

IP地址池ID。EIP将从该IP地址池中分配。更多信息，请参见创建和管理IP地址池。

为ECI Pod分配IPv6地址

k8s.aliyun.com/eci-enable-ipv6

"true"

配置为true表示为Pod绑定一个IPv6地址。

k8s.aliyun.com/eci-ipv6-bandwidth-enable

"true"

配置为true表示开通ECI的IPv6公网通信能力。

k8s.aliyun.com/eci-ipv6-bandwidth

100M

IPv6地址的公网带宽峰值。

指定ECI Pod的私网IP地址

k8s.aliyun.com/eci-private-ip-address

"172.16.0.1"

指定Pod的私网IP地址。目前仅支持指定IPv4地址，请确保该IP地址没有被占用。

配置ECI Pod使用固定IP地址

k8s.aliyun.com/eci-fixed-ip

"true"

配置为true表示Pod启用固定IP地址。

k8s.aliyun.com/eci-fixed-ip-retain-hour

"24"

IP地址空闲后的保留时长，即启用固定IP地址的Pod释放后，对应IP地址的保留时长，单位为小时。

如果没有配置该Annotation，默认保留48小时。

限制ECI Pod的出入带宽

kubernetes.io/ingress-bandwidth

40M

入方向带宽。

kubernetes.io/egress-bandwidth

20M

出方向带宽。

为ECI Pod配置自定义DNS

k8s.aliyun.com/eci-custom-dnsconfig

{\"nameservers\":\"20.1.xx.xx,20.1.xx.xx\",\"searches\":\"xx.com,xx.eee\",\"options\":\"ndots:2,edns0\"}

混合云场景下，指定ECI Pod使用自定义DNS，以便解析内网域名。

功能及相关文档

参数

示例值

描述

增加临时存储空间大小

k8s.aliyun.com/eci-extra-ephemeral-storage

50Gi

临时存储空间大小。

加密临时存储空间

k8s.aliyun.com/eci-ephemeral-storage-options

"{\"encrypted\":\"true\"}"

取值为"{\"encrypted\":\"true\"}"}时，表示开启临时存储空间加密功能。

设置自动驱逐临时存储空间不足的Pod

k8s.aliyun.com/eci-eviction-enable

"true"

配置为true表示系统会自动驱逐临时存储空间不足的ECI Pod。

功能及相关文档

参数

示例值

描述

为Pod配置NTP服务

k8s.aliyun.com/eci-ntp-server

100.100.*.*

指定NTP服务器的地址。

功能及相关文档

参数

示例值

描述

通过SLS CRD采集日志

k8s.aliyun.com/eci-sls-enable

"false"

配置为false表示关闭日志采集功能。

通过SLS CRD方式采集日志时，如果某些Pod不需要采集日志，可配置该Annotation来关闭日志采集功能，避免系统自动创建Logtail而造成资源浪费。

功能及相关文档

参数

示例值

描述

查看Core dump文件

k8s.aliyun.com/eci-core-pattern

/pod/data/dump/core

Core dump文件保存目录。