更新时间:2025-09-23 GMT+08:00
分享

设置标签与注解

Pod注解

Autopilot集群在创建Pod过程中提供了多种高级功能,您可以通过在控制台或YAML中添加注解(Annotation)来实现,具体可用的Annotation请参见表1

表1 Pod Annotation

功能及相关文档

参数

示例值

说明

设置可用区亲和性

node.cce.io/node-az-list

cn-east-3a,cn-east-3b

表示Pod亲和的可用区列表。

可以通过设置工作负载注解实现可用区亲和,将Pod调度到指定的可用区。

增加Pod的临时存储容量

resource.cce.io/extra-ephemeral-storage-in-GiB

14

表示额外增加的Pod临时存储容量,单位GiB,取值范围:0-994。

每个Pod的实际临时存储容量=30GiB(默认免费提供的临时存储容量)+额外增加的临时存储容量。

说明:

1.28.6-r0和1.27.8-r0及以上版本的集群支持该功能。

使用镜像缓存

(两个参数二选一即可)

imagecache.cce.io/specified-name

autopilot-test

用于指定镜像缓存,请填写待使用镜像缓存的名称,且该镜像缓存必须为可用状态。指定镜像缓存后,containers参数中的镜像信息需与镜像缓存中的镜像信息一致。

如果填写的镜像缓存不存在,或者未在镜像缓存中找到需要的镜像,则不再使用镜像缓存,集群会按照containers中的镜像信息重新下载镜像。

imagecache.cce.io/auto-match

true

表示是否开启自动匹配镜像缓存,取值范围如下:

  • true:表示开启镜像缓存。
  • false:表示不开启镜像缓存,默认为不开启。

开启后,集群将从所有可用的镜像缓存中自动匹配最优镜像,并且匹配顺序如下:

  • 镜像匹配度:选择镜像信息匹配度最高的镜像缓存。
  • 创建时间:选择创建时间最新的镜像缓存。

如果在镜像缓存中未匹配到镜像,则不再使用镜像缓存。不使用镜像缓存后,集群将在SWR镜像仓库、镜像中心依次匹配输入的镜像名称,若最终未匹配,则返回镜像拉取失败。

您可通过控制台或YAML文件添加Annotation,具体步骤如下。

控制台添加Annotation

在控制台创建工作负载时,您可以通过“高级配置 > 标签与注解”,添加“Pod注解”,从而启用Pod的高级功能。

例如,为Pod增加14GiB的临时存储空间,可以将“Pod注解”设置为“resource.cce.io/extra-ephemeral-storage-in-GiB=14”,并单击“确认添加”

图1 为Pod增加临时存储空间

YAML中添加Annotation

通过YAML创建工作负载时您可以通过“annotations”参数,启用Pod的高级功能。

例如,创建Nginx工作负载时,您可以通过“annotations”为Pod增加14GiB的临时存储空间。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx     # 工作负载名称
spec:
  replicas: 1     # 实例数量
  selector:
    matchLabels:  # 选择器,用于选择带有特定标签的资源
      app: nginx  
  template:
    metadata:
      labels:     # 标签
        app: nginx
      annotations:
        resource.cce.io/extra-ephemeral-storage-in-GiB: '14'
    spec:
      containers:
      - image: nginx:latest   # 镜像名称:镜像版本
        name: nginx
      imagePullSecrets:
      - name: default-secret

Pod标签

您可以通过Pod标签为Pod组织、选择和管理相关的资源,提高资源应用的灵活性和可维护性。

在控制台创建工作负载时,会默认为Pod添加如下标签,其中app的值为工作负载名称。

图2 Pod标签

YAML示例如下:

...
spec:
  selector:
    matchLabels:
      app: nginx
      version: v1
  template:
    metadata:
      labels:
        app: nginx
        version: v1
    spec:
      ...

相关文档