全部产品
Search
文档中心

弹性容器实例:ECI Pod Annotation

更新时间:Nov 28, 2022

在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,支持指定多个交换机实现多可用区功能。

多可用区创建Pod

k8s.aliyun.com/eci-schedule-strategy

VSwitchOrdered

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

  • VSwitchOrdered:按顺序

  • VSwitchRandom:随机

k8s.aliyun.com/eci-use-specs

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

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

多规格创建Pod

k8s.aliyun.com/eci-spot-strategy

SpotAsPriceGo

抢占式实例策略。取值范围:

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

  • SpotWithPriceLimit:设置抢占实例价格上限。

创建抢占式实例

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

"0.5"

抢占式实例价格。仅当k8s.aliyun.com/eci-spot-strategy设置为SpotWithPriceLimit时有效。

k8s.aliyun.com/eci-cpu-option-core

"2"

CPU物理核心数。

自定义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访问阿里云产品的能力。

设置RAM角色

k8s.aliyun.com/eci-fail-strategy

fail-back

设置Pod故障处理策略,取值如下:

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

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

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

设置Pod故障处理策略

k8s.aliyun.com/pod-fail-on-create-err

"true"

创建失败的ECI实例是否体现Failed状态。

设置Pod创建失败时体现Failed状态

k8s.aliyun.com/eci-auto-imc

"true"

自动匹配镜像缓存。

使用ImageCache加速创建Pod

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前加上所属地域,例如"cn-beijng:cri-j36zhodptmyq****"

免密拉取ACR企业版镜像

k8s.aliyun.com/eci-eip-instanceid

eip-bp1q5n8cq4p7f6dzu****

EIP实例ID。

为ECI实例绑定EIP

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支持指定。取值范围:

  • BGP:BGP(多线)线路

  • BGP_PRO:BGP(多线)精品线路

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

PayByBandwidth

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

  • PayByBandwidth:按带宽计费

  • PayByTraffic:按流量计费

k8s.aliyun.com/eci-enable-ipv6

"true"

是否绑定一个IPv6地址。

配置IPv6地址

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

"true"

是否开通ECI的IPv6公网通信能力。

k8s.aliyun.com/eci-ipv6-bandwidth

100M

设置IPv6地址的公网带宽峰值。

kubernetes.io/ingress-bandwidth

40M

入方向带宽。

配置ECI Pod带宽限速

kubernetes.io/egress-bandwidth

20M

出方向带宽。

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

50Gi

临时存储空间大小。

自定义临时存储空间大小

k8s.aliyun.com/eci-eviction-enable

"true"

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

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

k8s.aliyun.com/eci-core-pattern

/pod/data/dump/core

Core dump文件保存目录。

查看Core dump文件

k8s.aliyun.com/eci-ntp-server

100.100.*.*

NTP Server。

为Pod配置NTP服务

k8s.aliyun.com/plain-http-registry

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

自建镜像仓库地址。

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

使用自建镜像仓库

k8s.aliyun.com/insecure-registry

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

取值为自建镜像仓库地址。

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

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

调度结果。