全部產品
Search

搜尋本產品

    Container Compute Service：Pod Annotation功能說明

    文件中心

    Container Compute Service：Pod Annotation功能說明

    更新時間：May 14, 2025

    ACS Pod支援通過Annotation的方式進行部分擴充功能的開啟和配置。本文介紹ACS支援的所有Pod Annotation的定義和功能。

    ACS Pod支援配置的Annotation

    您可以通過Pod Annotation中配置支援的Key和Value以開啟相關功能和配置，樣本如下。

    Pod配置樣本

    apiVersion: v1
kind: Pod
metadata:
  name: annotation-pod
  annotations:
    network.alibabacloud.com/vswitch-ids: "vsw-foo"
spec:
  ...

    Deployment配置樣本

    apiVersion: apps/v1
kind: Deployment
metadata:
  name: foo
  ...
spec:
  ...
  template:
    metadata:
      annotations:
        network.alibabacloud.com/vswitch-ids: "vsw-foo"
    ...

    網路

    功能

    參數

    樣本值

    說明

    為Pod指定交換器和安全性群組

    network.alibabacloud.com/vswitch-ids

    "vsw-slw1***,vsw-lkjwo***"

    指定交換器ID，支援指定多個交換器開啟多可用性區域建立Pod功能。

    重要

    當Pod同時指定交換器和親和性時，ACS生產資源時會優先參考Pod指定的交換器，親和性配置將被忽略。

    重要

    當Pod同時使用WaitForFirstConsumer類型PVC時，請在Pod親和性中同時指定對應的可用性區域，調度器會確保PVC分配的可用性區域與交換器一致，避免Pod Pending。更多資訊，請參見節點親和性調度。

    network.alibabacloud.com/security-group-ids

    "sg-sljwo***,sg-lwirp***"

    指定安全性群組ID，支援指定多個安全性群組。

    使用Annotation配置自訂DNS

    network.alibabacloud.com/custom-dnsconfig

    {"servers":["20.1.xx.xx","30.1.xx.xx"],"searches":["xx.com","yy.com"],"options":["ndots:2","edns0"]}

    指定自訂DNS配置。

    在ACS叢集中使用網路原則

    alibabacloud.com/enable-network-policy-agent

    "true"

    對ACS Pod啟用NetworkPolicy。預設值為false。

    為Pod掛載獨立公網EIP

    network.alibabacloud.com/pod-with-eip

    "true"

    是否自動建立並綁定EIP。取值：

    • true：自動建立並綁定EIP。

    • false：不自動建立並綁定EIP。

    network.alibabacloud.com/pod-eip-instanceid

    "eip-bp14q***"

    使用指定的EIP，請填寫EIP執行個體ID，例如：eip-bp14q***。更多資訊，請參見申請EIP。

    k8s.aliyun.com/eci-eip-instanceid（相容ECI註解）

    network.alibabacloud.com/eip-bandwidth

    "5"

    EIP峰值頻寬，單位：Mbps。

    network.alibabacloud.com/eip-internet-charge-type

    "PayByTraffic"

    EIP流量的計費方式。取值：

    • PayByTraffic：預設值，按使用流量計費。

    • PayByBandwidth：按頻寬計費。

    更多資訊，請參見EIP計費方式。

    k8s.aliyun.com/eip-charge-type（相容早期版本的註解）

    network.alibabacloud.com/eip-instance-charge-type

    "PrePaid"

    EIP執行個體的付費模式。取值：

    • PrePaid：訂用帳戶。

    • PostPaid：隨用隨付。

    更多資訊，請參見訂用帳戶和隨用隨付。

    network.alibabacloud.com/eip-common-bandwidth-package-id

    "cbwp-slex***"

    綁定已有的共用頻寬包。

    network.alibabacloud.com/eip-isp

    "BGP"

    EIP的線路類型。取值：

    • BGP：BGP（多線）線路。

    • BGP_PRO：BGP（多線）精品線路。

    更多資訊，請參見申請EIP。

    network.alibabacloud.com/eip-public-ip-address-pool-id

    "pippool-dlsw***"

    EIP位址集區。關於EIP位址集區的使用限制、使用步驟等，請參見建立和管理IP位址集區。

    network.alibabacloud.com/eip-resource-group-id

    EIP資源群組。更多資訊，請參見申請EIP。

    network.alibabacloud.com/eip-name

    EIP名稱。更多資訊，請參見申請EIP。

    network.alibabacloud.com/eip-description

    EIP描述。更多資訊，請參見申請EIP。

    network.alibabacloud.com/eip-security-protection-types

    EIP安全防護層級。若配置多個，請通過半形逗號,分隔。更多資訊，請參見申請EIP。

    network.alibabacloud.com/pod-eip-release-strategy

    "Never"

    Pod EIP的回收策略。取值：

    • Follow：預設值，跟隨Pod生命週期。

    • Never：不刪除Pod EIP。當不需要時需要手動刪除這個Pod EIP。

    • 配置到期時間，例如：5m30s，表示在Pod刪除5分鐘30秒之後刪除Pod EIP。支援符合規範的Go類型時間運算式。

    鏡像

    功能

    參數

    樣本值

    說明

    使用自建鏡像倉庫

    registry.alibabacloud.com/plain-http-registry

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

    拉取採用HTTP協議的自建鏡像倉庫中的鏡像時，需配置該參數，避免因協議不同而導致鏡像拉取失敗。

    registry.alibabacloud.com/insecure-registry

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

    拉取使用自簽發認證的自建鏡像倉庫中的鏡像時，需要配置該參數來跳過認證認證，避免因認證認證失敗而導致鏡像拉取失敗。

    調度

    功能

    參數

    樣本值

    說明

    Pod算力品質重試策略

    alpha.alibabacloud.com/compute-qos-strategy

    "best-effort-to-default"

    指定compute-qos重試策略。有效值為best-effort-to-default：優先使用BestEffort算力品質，如果資源不足，則使用Default算力品質。

    重要

    使用此註解時無需指定alibabacloud.com/compute-qos標籤，若已存在此標籤，則以標籤的設定值為準。

    ACS自動追加的Annotation

    說明

    以下Annotation資訊為ACS相關功能處理完成後產生的結果資訊，如網卡分配結果和EIP分配結果等，這部分Annotation參數不允許使用者進行設定和修改。

    功能

    參數

    樣本值

    說明

    網卡分配資訊

    network.alibabacloud.com/allocated-eni-id

    "eni-esdxs***"

    分配的網卡（ENI）ID。

    network.alibabacloud.com/vpc-id

    "vpc-sljwo***"

    當前網卡歸屬的VPC ID。

    network.alibabacloud.com/vswitch-id

    "vsw-lskdw***"

    當前網卡歸屬的交換器ID，如果您建立ACS Pod時指定了多個交換器，這裡展示的是最終使用的交換器。

    EIP分配資訊

    network.alibabacloud.com/allocated-eip-id

    "eip-bp1m***"

    分配的EIP ID資訊。

    network.alibabacloud.com/allocated-eip-address

    "116.62.***"

    分配的EIP的IP地址。

    資源規格

    alibabacloud.com/pod-use-spec

    "2.5-5Gi"

    規格規整後ACS Pod的CPU/Memory規格，表示的格式和單位是為"xxvCPU-xxGiB"。

    alibabacloud.com/pod-gpu-use-spec

    "1"

    規格規整後ACS Pod的GPU卡數量。

    alibabacloud.com/pod-ephemeral-storage

    "30Gi"

    規格規整後ACS Pod的臨時儲存空間大小，單位是GiB。

    調度結果資訊

    topology.kubernetes.io/region

    "cn-hangzhou"

    ACS Pod的所屬地區。

    topology.kubernetes.io/zone

    "cn-hangzhou-i"

    ACS Pod的所屬可用性區域。

    其他元資訊

    alibabacloud.com/instance-id

    "acs-sdsf***"

    ACS Pod執行個體ID。

    alibabacloud.com/request-id

    "6925D4B7-***"

    請求ID。