ECI Pod Annotation
在Kubernetes集群中创建ECI类型的Pod(即ECI实例)时,为充分使用ECI提供的功能,在不改变Kubernetes语义的前提下,您可以根据需求为Pod添加Annotation。 本文为您介绍创建ECI Pod时支持添加的Annotation,以及ECI Pod调度完成后会追加的Annotation。
ECI Pod支持的Annotation
创建ECI Pod时,支持添加的Annotation如下表所示。
下表列举的Annotation仅适用于创建到虚拟节点上的Pod,即ECI实例,调度到普通节点上的Pod不受这些Annotation影响。
Annotation请添加在Pod的metadata下,例如:配置Deployment时,Annotation需添加在spec>template>metadata下。
参数 | 示例值 | 描述 | 相关文档 |
k8s.aliyun.com/eci-security-group | sg-bp1dktddjsg5nktv**** | 指定安全组ID。 | |
k8s.aliyun.com/eci-vswitch | vsw-bp1xpiowfm5vo8o3c**** | 指定交换机ID,支持指定多个交换机实现多可用区功能。 | |
k8s.aliyun.com/eci-schedule-strategy | VSwitchOrdered | 设置多可用区调度策略。取值范围:
| |
k8s.aliyun.com/eci-use-specs | 2-4Gi,4-8Gi,ecs.c6.xlarge | 指定ECI实例规格,支持指定多规格,包括指定vCPU和内存,或者ECS规格。 | |
k8s.aliyun.com/eci-instance-generation | "6,5" | 指定vCPU和内存创建ECI实例时,支持指定ECS规格代数。 | |
k8s.aliyun.com/eci-spot-strategy | 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-cpu-option-core | "2" | 设置CPU物理核心数。 | |
k8s.aliyun.com/eci-cpu-option-ht | "1" | 设置每核线程数。 | |
k8s.aliyun.com/eci-custom-tags | "env:test,name:alice" | 绑定的标签(Tag)字符串,最多可以绑定3个标签。标签键和标签值之间用半角冒号隔开,多个标签之间用半角逗号隔开。 | |
k8s.aliyun.com/eci-ram-role-name | AliyunECIContainerGroupRole | 绑定RAM角色,赋予ECI访问阿里云产品的能力。 | |
k8s.aliyun.com/eci-fail-strategy | fail-back | 设置Pod故障处理策略,取值如下:
| |
k8s.aliyun.com/eci-auto-imc | "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。 | |
k8s.aliyun.com/acr-instance-id | cri-j36zhodptmyq**** | ACR企业版实例ID。 支持跨地域指定ACR企业版实例,此时需在实例ID前加上所属地域,例如 | |
k8s.aliyun.com/eci-eip-instanceid | eip-bp1q5n8cq4p7f6dzu**** | 绑定的EIP实例ID。 | |
k8s.aliyun.com/eci-with-eip | "true" | 是否自动创建并绑定EIP。 | |
k8s.aliyun.com/eip-bandwidth | "5" | 设置EIP带宽。 | |
k8s.aliyun.com/eip-common-bandwidth-package-id | cbwp-2zeukbj916scmj51m**** | 设置共享带宽包ID。 | |
k8s.aliyun.com/eip-isp | BGP | 设置EIP线路类型,仅按量付费的EIP支持指定。取值范围:
| |
k8s.aliyun.com/eip-internet-charge-type | PayByBandwidth | 设置EIP的计量方式。取值范围:
| |
k8s.aliyun.com/eci-enable-ipv6 | "true" | 是否绑定一个IPv6地址。 | |
k8s.aliyun.com/eci-ipv6-bandwidth-enable | "true" | 是否开通ECI的IPv6公网通信能力。 | |
k8s.aliyun.com/eci-ipv6-bandwidth | 100M | 设置IPv6地址的公网带宽峰值。 | |
kubernetes.io/ingress-bandwidth | 40M | 设置入方向带宽。 | |
kubernetes.io/egress-bandwidth | 20M | 设置出方向带宽。 | |
k8s.aliyun.com/eci-extra-ephemeral-storage | 50Gi | 设置临时存储空间大小。 | |
k8s.aliyun.com/eci-eviction-enable | "true" | 设置自动驱逐临时存储空间不足的ECI Pod。 | |
k8s.aliyun.com/eci-core-pattern | /pod/data/dump/core | 设置Core dump文件保存目录。 | |
k8s.aliyun.com/eci-ntp-server | 100.100.*.* | 设置NTP Server。 | |
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来跳过证书认证,避免因证书认证失败而导致镜像拉取失败。 | |
k8s.aliyun.com/eci-sls-enable | "false" | 通过SLS CRD方式采集日志时,如果某些Pod不需要采集日志,可配置该Annotation来关闭日志采集功能,避免系统自动创建Logtail而造成资源浪费。 |
ECI Pod追加的Annotation
ECI Pod调度完成后会追加的Annotation如下表所示。您可以通过kubectl describe
命令进行查询。
参数 | 示例值 | 描述 |
k8s.aliyun.com/eci-request-id | 45942504-4688-51BA-BBAB-4B692C4F39C0 | 请求ID。 |
k8s.aliyun.com/eci-instance-id | eci-2ze1y0la40qgva09**** | 实例ID。 |
k8s.aliyun.com/eci-instance-spec | 2.0-4.0Gi | 实例规格。 |
k8s.aliyun.com/allocated-eipInstanceId | eip-bp1q5n8cq4p7f6dzu**** | 绑定的EIP实例ID。 |
k8s.aliyun.com/allocated-eipAddress | 47.99.**.** | 绑定的EIP实例的IP地址。 |
k8s.aliyun.com/allocated-ipv6Address | 2001:d**:1:1:1:1:1:1 | 绑定的IPv6地址。 |
k8s.aliyun.com/eci-created-by-template | true | 是否使用模板创建。 |
k8s.aliyun.com/eni-instance-id | eni-2ze6d7oo5ukqj26o**** | 绑定的网卡ID。 |
k8s.aliyun.com/eci-vpc | vpc-2zeghwzptn5zii0w7**** | 所属VPC。 |
k8s.aliyun.com/eci-matched-image-cache | imc-2zedy3v37800iimu**** | 匹配的镜像缓存ID。 |
k8s.aliyun.com/eci-schedule-result | finished | 调度结果。 |