You need to enable JavaScript to run this app.
导航
Pod Annotation 说明
最近更新时间:2024.10.12 11:09:43首次发布时间: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

"50"

自定义系统盘存储空间。

  • 取值:String 格式正整数数值。
  • 单位: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 计算型规格,支持配置的驱动版本也不同,详细说明,请参见 不同规格对应的驱动版本

说明

不设置该 Annotation 时,系统自动指定与您所选 GPU 计算型规格对应的默认驱动版本。

vke.volcengine.com/eviction-grace-period-seconds50设置 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-namedefault指定 VCI 实例所属的项目名称。项目分账

vci.vke.volcengine.com/sysctls

{"vm.watermark_scale_factor":"10"}

修改 VCI 实例内核参数。取值如下:

  • 参数值支持的格式为 Map[String]String。
  • 目前仅支持vm.watermark_scale_factor参数:
    • 参数说明:通过内核的watermark_scale_factor参数调整minlowhigh水位线之间的差值,以应对业务突发申请内存的情况。更多介绍,请参见 内核文档
    • 默认值:10。
    • 取值范围:1~1000 的正整数。

创建实例后展示的关键 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 实例所属虚拟节点。