You need to enable JavaScript to run this app.
导航

Pod Annotation 说明

最近更新时间2024.03.28 20:08:07

首次发布时间2021.11.04 14:08:18

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

创建实例时支持设置的 Annotation

Annotation KeyAnnotation Value 示例值说明是否必填相关文档

vke.volcengine.com/burst-to-vci

enforce

是否将 Pod 强制部署到 VCI 上。取值如下:
enforce:创建 Pod 时将其强制部署到 VCI 上。

创建 Pod 到 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 实例规格。

  • 通用型:不支持设置。
  • GPU 型:必填。

指定 VCI 规格创建 GPU 计算型实例

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 实例 规格族
可取值的 规格族 介绍,请参见 VCI 实例规格介绍

  • 通用型:非必填。 默认值为vci.u1

  • GPU 型:必填。无默认值。

vci.vke.volcengine.com/desired-system-storage

500

自定义系统盘存储空间。

  • 取值:具体正整数数值。
  • 单位:GiB。
  • 最大值:500。
  • 最小值:40。

说明

邀测·申请试用】:该 Annotation 对应的功能目前处于邀测阶段,如需使用,请提交申请。

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

支持将弹性容器实例的日志采集至容器服务。value 取值如下:

  • false:(默认)不开启日志采集。
  • true:开启日志采集。

通过日志服务采集 VCI 容器日志

vci.vke.volcengine.com/gpu-driver-version

tesla-470.129.06

创建 GPU 计算型实例时指定 GPU 的驱动版本。取值如下:

  • tesla-470.129.06(默认值)
  • tesla-535.129.03

说明

未设置该 Annotation 时,系统会为您的 GPU 计算型实例指定默认的 GPU 驱动版本。

vke.volcengine.com/eviction-grace-period-seconds50设置 Pod 被驱逐时的优雅退出时间。单位为秒,取值范围为 1~60 的整数。

创建实例后展示的关键 Annotation

Annotation KeyAnnotation Value 示例值说明
vci.vke.volcengine.com/instance-idvci-3todtpl3ng4dgfwz****VCI 实例 ID。
vci.vke.volcengine.com/used-instance-typesvci.g1v.2xlargeVCI 使用的实例规格。
vke.volcengine.com/eni-ideni-bp1fgnh68xyz9****VCI 实例绑定的弹性网卡 ID。
vke.volcengine.com/used-subnet-idsubnet-128fhnvjjgg****VCI 实例所属子网。
vci.vke.volcengine.com/vk-namevci-node1-cn-beijing-aVCI 实例所属虚拟节点。