Elastic Container Instance：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配置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檔案儲存目錄。