全部产品
Search
文档中心

弹性容器实例:ECI Pod Annotation

更新时间:May 09, 2024

在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下。

  • 仅支持在创建ECI Pod时添加ECI相关Annotation来生效ECI功能,更新ECI Pod时添加或者修改ECI相关Annotation均不会生效。

实例

功能及相关文档

参数

示例值

描述

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规格代数。

创建抢占式实例

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。

镜像

功能及相关文档

参数

示例值

描述

使用ImageCache加速创建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。

免密拉取ACR镜像

k8s.aliyun.com/acr-instance-ids

cri-j36zhodptmyq****

ACR企业版实例ID。

支持跨地域指定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来跳过证书认证,避免因证书认证失败而导致镜像拉取失败。

网络

功能及相关文档

参数

示例值

描述

配置安全组

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的出入带宽

kubernetes.io/ingress-bandwidth

40M

入方向带宽。

kubernetes.io/egress-bandwidth

20M

出方向带宽。

存储

功能及相关文档

参数

示例值

描述

增加临时存储空间大小

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

50Gi

临时存储空间大小。

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

k8s.aliyun.com/eci-eviction-enable

"true"

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

容器配置

功能及相关文档

参数

示例值

描述

配置NTP服务

k8s.aliyun.com/eci-ntp-server

100.100.*.*

指定NTP服务器的地址。

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****

ECI实例ID。

k8s.aliyun.com/eci-instance-spec

2.0-4.0Gi

ECI实例规格,即实际计费规格。

  • 如果返回值是具体的vCPU和内存数值(如2.0-4.0Gi),则按vCPU和内存计费。

  • 如果返回值是ECS规格(如ecs.c6.large),则按ECS规格计费。

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

调度结果。该Annotation已弃用,请参考podStatus.condition ContainerInstanceCreated了解Pod调度结果。具体请参见ContainerInstanceCreated