文档中心

容器服务

请输入

用户指南

Pod Annotation 说明

Kubernetes 集群通过虚拟节点创建 Pod 到 VCI 时，为充分使用 VCI 提供的功能，在不改变 Kubernetes 语义的前提下，您可以根据需求为 Pod 添加 Annotation。本文为您介绍 VCI 实例支持的 Annotation 及其配置示例。

创建实例时支持设置的 Annotation

Annotation Key	Annotation Value 示例值	说明	是否必填	相关文档
vke.volcengine.com/burst-to-vci	enforce	是否将 Pod 强制部署到 VCI 上。取值如下： enforce：创建 Pod 时将其强制部署到 VCI 上。	VCI 场景必填	创建实例
vke.volcengine.com/preferred-subnet-ids	subnet-3tispp1nai****	设置 VCI 实例子网。说明默认值为创建集群时指定的 Pod 子网。支持指定多个可用区的多个子网。多子网之间使用半角逗号（,）隔开。指定多个子网时，系统从多个子网中选择一个剩余 IP 数量最多的子网创建 VCI 实例。	否	指定子网创建实例
vke.volcengine.com/security-group-ids	sg-3thbinrkp94bwbh**, sg-2b49fbsd723bf4r**	设置 VCI 实例安全组。可填写多个安全组，使用半角逗号（,）分割。安全组数量限制，请参见安全组约束限制说明默认值为创建容器服务集群时默认开通的 Pod 安全组（放通所有出入流量）。	否	指定安全组创建实例
vci.vke.volcengine.com/preferred-instance-types	vci.g1v.2xlarge	设置 VCI 实例规格。支持指定多个规格（Annotation Value），多个规格之间以半角逗号（,）分隔，并按照前后顺序排列优先级。	指定规格创建实例时必填	指定 VCI 规格创建 GPU 计算型实例指定 VCI 规格创建通用型实例
vci.vke.volcengine.com/kube-proxy-enabled	false	支持禁用 Proxy，以降低 Overhead、提升启动速度。value 取值如下： false：不安装 Proxy。 true ：（默认）安装 Proxy。	否	无
vci.vke.volcengine.com/preferred-instance-family	vci.u1	设置 VCI 实例规格族。支持指定多个规格族（Annotation Value），多个规格族之间以半角逗号（,）分隔，并按照前后顺序排列优先级。可取值的规格族介绍，请参见 VCI 实例规格介绍。	通用型：非必填。默认值为vci.u1。 GPU 型：必填。无默认值。	指定容器 vCPU 和内存创建通用型实例指定 GPU 资源创建 GPU 计算型实例
vci.vke.volcengine.com/desired-system-storage	"50"	自定义系统盘存储空间。取值：String 格式正整数数值。单位：GiB。最大值：500。最小值：40。说明【邀测·申请试用】：该 Annotation 对应的功能目前处于邀测阶段，如需使用，请提交申请。	否	使用自动镜像缓存创建 VCI 实例使用手动镜像缓存创建 VCI 实例
vci.vke.volcengine.com/stdlog-max-size	10Mi	通过 Sidecar 采集容器标准输出日志时，容器日志文件的最大容量。取值范围：1Mi～1Gi（即 1 MiB～1024 MiB）。取值格式：数值+二进制单位，例如10Mi表示 10 MiB；1Gi表示 1 GiB=1024 MiB。默认值：10Mi。	否	通过 Sidecar 采集 VCI 容器日志
vci.vke.volcengine.com/stdlog-max-files	5	通过 Sidecar 采集容器标准输出日志时，容器日志文件的存放个数上限。取值范围：2～100（正整数数值）。默认值：5。	否	通过 Sidecar 采集 VCI 容器日志
vci.vke.volcengine.com/stdlog-max-line-size	16384	通过 Sidecar 采集容器标准输出日志时，容器标准输出单行最大取值。取值范围：4096～1048576 Byte。取值格式：数值或数值+二进制单位，只填数值，表示单位为 Byte；填写数值+二进制单位，例如100Ki表示 100 KiB。默认值：16384。	否	通过 Sidecar 采集 VCI 容器日志
vci.volcengine.com/tls-enable	false	支持将 VCI 容器日志采集至日志服务。value 取值如下： false：（默认）不开启日志采集。 true：开启日志采集。	否	通过日志服务采集 VCI 容器日志
vci.vke.volcengine.com/gpu-driver-version	tesla-470.129.06	指定 GPU 计算型实例的驱动版本。不同 GPU 计算型规格，支持配置的驱动版本也不同，详细说明，请参见支持的 GPU 驱动版本。说明不设置该 Annotation 时，系统自动指定与您所选 GPU 计算型规格对应的默认驱动版本。	否	指定容器 GPU 资源创建 GPU 计算型实例指定 VCI 规格创建 GPU 计算型实例
vke.volcengine.com/eviction-grace-period-seconds	50	设置 Pod 被驱逐时的优雅退出时间。单位为秒，取值范围为 1~60 的整数。	否	无
vci.vke.volcengine.com/resource-tags	"cluster-id:ccq****,env:test"	为 VCI 实例设置自定义标签，用于以标签维度对 VCI 资源进行分账。自定义标签的要求如下：支持的格式为 String。每个标签由key:value格式的键值对组成，多个标签中间以英文逗号（,）分隔，例如"cluster-id:**,env:test"，表示为该 VCI 实例设置两个标签，分别为cluster-id:**和env:test。标签 key 要求如下：不能以任何大小写形式的volc:开头。只能包含语言字符、数字、空格和特殊符号_.:/=+-@。长度限制为 1～128 个字符。标签 value 要求如下：可以为空。只能包含语言字符、数字、空格和特殊符号_.:/=+-@。长度不超过 256 个字符。单个 VCI 实例最多支持 50 个标签。 VCI 实例已有相同标签 key 的情况下，通过该 Annotation 重复绑定标签 key 时，会覆盖原来的标签 value。标签 key 的前后和标签 value 的前后均不允许输入空格。	否	标签分账
vci.vke.volcengine.com/project-name	default	指定 VCI 实例所属的项目名称。	否	项目分账
vci.vke.volcengine.com/sysctls		修改 VCI 实例内核参数。取值如下：参数值支持的格式为 Map[String]String。目前仅支持vm.watermark_scale_factor参数：参数说明：通过内核的watermark_scale_factor参数调整min、low、high水位线之间的差值，以应对业务突发申请内存的情况。更多介绍，请参见内核文档。默认值：10。取值范围：1~1000 的正整数。	否	指定容器 vCPU 和内存创建通用型实例指定容器 GPU 资源创建 GPU 计算型实例
vci.volcengine.com/insecure-registries	"registry1,registry:5000,registry:80"	指定跳过 TLS 认证的镜像仓库，多个镜像仓库通过半角逗号（,）分隔。如果镜像仓库地址有端口号，则需要带上端口号。	否	创建实例时拉取自建镜像仓库的镜像
vci.volcengine.com/plain-http-registries	"registry1-http,registry-http:5000,registry-http:80"	指定通过 HTTP 访问的镜像仓库，多个镜像仓库通过半角逗号（,）分隔。如果镜像仓库地址有端口号，则需要带上端口号。	否	创建实例时拉取自建镜像仓库的镜像
vci.vke.volcengine.com/image-cache-id	imc-3uqroqkx0i3j********	创建 VCI 实例时指定的镜像缓存 ID。	否	使用手动镜像缓存创建 VCI 实例
vci.vke.volcengine.com/ignore-image-cache-unavailable	false	创建 VCI 实例时，若指定 ID 的镜像缓存不存在，或者状态为不可用时，忽略镜像缓存配置。 true：（默认值）忽略。 false：不忽略，若相应 ID 的镜像缓存不存在或者不可用时，VCI 实例将创建失败。	否	使用手动镜像缓存创建 VCI 实例
vci.volcengine.com/gpu-compute-mode	exclusive	GPU 可设置的 CUDA 计算模式，用于管理 GPU 设备的上下文创建和多线程/多进程访问权限。支持设置： exclusive：整个系统中只有一个 CUDA 上下文能在该 GPU 设备上创建，但创建该上下文的进程内，可有多线程使用这个上下文，保证了进程级的独占性，避免多进程争抢 GPU 资源。说明该模式会锁住进程，仅适合高性能科学计算场景，若是通用推理场景，会有明显性能影响。	否	创建 GPU 计算型实例
vci.vke.volcengine.com/kernel-transparent-hugepage	madvise	内核是否使用透明大页内存的配置。取值如下： never：关闭，不使用透明内存。 always：尽量使用透明内存。 madvise：（默认）避免改变内存占用。	否	无

创建实例后展示的关键 Annotation

Annotation Key	Annotation Value 示例值	说明
vci.vke.volcengine.com/instance-id	vci-3todtpl3ng4dgfwz****	VCI 实例 ID。
vci.vke.volcengine.com/used-instance-types	vci.g1v.2xlarge	VCI 使用的实例规格。
vke.volcengine.com/eni-id	eni-bp1fgnh68xyz9****	VCI 实例绑定的弹性网卡 ID。
vke.volcengine.com/used-subnet-id	subnet-128fhnvjjgg****	VCI 实例所属子网。
vci.vke.volcengine.com/vk-name	vci-node1-cn-beijing-a	VCI 实例所属虚拟节点。

最近更新时间：2026.07.09 22:00:06

这个页面对您有帮助吗？

有用

无用