功能及相關文檔

參數

示例值

描述

多可用區創建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文件保存目錄。