文档中心

容器服务

创建工作负载

工作负载配置

本文主要介绍无状态负载（Deployment）、有状态负载（Statefulset）、守护进程（Daemonset）、任务（Job）、定时任务（CronJob）等工作负载的自定义参数配置属性，帮助您灵活配置参数，创建应用于不同场景的工作负载。

基本信息

配置项	说明
名称	根据系统提示，配置工作负载的名称。在同一个命名空间下，名称必须唯一。
命名空间	选择工作负载部署的命名空间，支持选择自定义创建的命名空间或 Kubernetes 自建的命名空间。Kubernetes 自建命名空间的说明，请参见命名空间概述。
实例个数	仅无状态负载、有状态负载支持配置该参数。输入工作负载的 Pod 实例个数。
标签	填写工作负载的标签，对应 Kubernetes 中的 Label，用于识别工作负载的键值对，配合选择器，帮助 Kubernetes 快速筛选目标工作负载。例如service.istio.io/canonical-revision:latest。单击添加标签，根据界面提示输入键和值。
注解	填写工作负载的注解信息，对应 Kubernetes 中的 Annotation，主要记录用于应用部署、安全策略、调度策略的附加信息，不用于标识和区分资源。单击添加注解，根据界面提示输入键和值。
算力类型	仅托管版集群中的无状态负载、有状态负载、任务、定时任务支持配置该参数。选择部署工作负载的基础设施资源，有如下两种算力类型：云服务器实例 ECS：在集群中的云服务器节点（Node）上部署该工作负载。弹性容器实例 VCI：在集群中的弹性容器实例（VCI），即虚拟节点（VirtualNode）上部署该工作负载。弹性容器实例相关介绍，请参见什么是弹性容器实例。
同步时区	开启后，容器（Container）使用节点本地所属时区的 CST（Central Standard Time）时区。
日志采集	算力类型选择弹性容器实例 VCI 后显示该参数。要开启后采集弹性容器实例日志。详细说明，请参见通过日志服务采集 VCI 容器日志。

容器配置

基本信息

配置项	说明
容器名称	根据系统提示的命名规则，输入容器名称。同一个工作负载下容器名称必须唯一。
容器镜像	容器使用的镜像。支持使用第三方镜像和镜像仓库 CR 中的镜像：第三方镜像：直接输入第三方镜像仓库地址（包括镜像 Tag），例如：example.com/namespace/repository:v1。镜像仓库 CR 中的镜像：单击选择镜像，从右侧弹出的面板中选择目标镜像仓库实例下的镜像。说明若需要使用 CR 中的私有镜像，请先安装 cr-credential-controller 免密组件。详细操作，请参见使用免密组件拉取私有镜像创建工作负载。若不使用 cr-credential-controller 免密组件拉取私有镜像，则需要配置镜像密钥。使用 CR 标准版实例中的镜像时，若您的标准版实例未配置当前集群所在 VPC 的访问控制权限，需要根据系统提示配置。详细操作，请参见连通本账号 VPC。
镜像版本	选择镜像的版本，不选择则默认拉取latest版本。注意如果镜像不存在latest版本，此处必须填写或选择镜像版本。使用第三方镜像时，无需配置该参数。
镜像拉取策略	拉取容器镜像的策略：默认策略：使用系统指定的默认策略。默认策略说明如下：当前集群 kube-apiserver 未启用 AlwaysPullImages 插件：若未指定镜像版本（Tag）或指定为latest时，镜像拉取策略默认为 Always。若已指定镜像版本（Tag）且不为latest时，镜像拉取策略默认为 IfNotPresent。当前集群 kube-apiserver 已启用 AlwaysPullImages 插件：镜像拉取策略默认为 Always，选择其余策略不会生效。 Always：总是拉取镜像。 IfNotPresent：优先使用本地镜像。 Never：仅使用本地镜像。
镜像密钥	默认不开启。开启后需要配置镜像仓库密钥。选择已有的仓库密钥或单击创建仓库密钥，按如下说明在容器服务侧补充镜像仓库的密钥：名称：容器使用的镜像的仓库名称。以使用镜像仓库 CR 中的镜像为例，则此处填写镜像所在的 OCI 制品仓库名称。仓库域名：填写镜像仓库域名，示例：cr-cn-beijing.volces.com。用户名：登录镜像仓库的用户名。以使用镜像仓库 CR 中的镜像为例，则此处填写镜像所在实例的登录用户名。可在镜像仓库控制台目标实例的概览页面获取。密码：镜像仓库登录用户名对应的密码。注意不使用免密组件，且需要拉取私有镜像时，必须配置该参数。
全链路应用性能监控	勾选启用，开启工作负载应用性能监控功能，并配置相应参数。更多配置详情，请参见应用性能观测。监控应用类型：选择监控的应用类型，当前支持 Java、Python、NodeJs 等。监控服务名称：（可选）配置监控服务的名称，该名称会作为当前工作负载监控任务的名称，在 APMPlus 服务端控制台的服务列表中展示，方便您区分不同的监控任务。说明若未填写监控服务名称，则系统会默认使用工作负载的名称作为监控服务的名称。
资源配额	支持按照业务需求，在容器维度配置 CPU 和内存的上下限，保障容器的健康运行。若不设置，则表示容器资源配额无限制。 CPU 请求：容器需要使用的最小 CPU 值。 CPU 上限：允许容器使用的 CPU 最大值。如果超过，容器会被终止。内存请求：容器需要使用的最小内存值。内存上限：允许容器使用的内存最大值。如果超过，容器会被终止。 GPU 资源类型：仅具有 GPU 计算型节点的集群，可配置 GPU 资源。有如下两种 GPU 资源： Nvidia：使用 NVIDIA GPU 资源。根据系统提示输入您需要使用的 NVIDIA GPU 算力和显卡类型。详细说明，请参见 NVIDIA GPU 调度、弹性容器实例 GPU 调度。该功能依赖 nvidia-device-plugin 组件，若未安装组件，请根据系统提示安装。 mGPU：使用容器共享 GPU 资源。根据系统提示输入您需要使用的容器共享 GPU 算力、GPU 显存和显卡类型。详细说明，请参见容器共享 GPU 调度。该功能依赖 mgpu 组件，若未安装组件，请根据系统提示安装。 RDMA 卡数：【邀测·申请试用】提供 Pod Container 使用 RDMA 设备能力，推荐配置 2 或者 4。详细说明，请参见 VKE 集群中使用 RDMA 资源。说明单个工作负载中，只能选用一种 GPU 资源。 RDMA 和 mGPU 不能同时使用。
特权级容器	默认不开启。开启后特权级容器可以访问宿主上的设备。支持部署在 Linux 系统上的容器控制网络堆栈或访问设备。
Init 容器	默认不开启。开启后表示将该容器设置为 Init 容器。Init 容器是 Pod 中，运行在应用容器前的容器，并且它可以包括仅在安装过程中使用的工具（例如 python、dig）和代码，避免在应用容器中的重复部署，提升应用镜像的安全性。说明 Init 容器不支持设置生命周期管理中的启动后处理、停止前处理，不支持开启健康检查。
Stdin	仅无状态负载、有状态负载支持配置该参数。开启后，在容器运行时为容器标准输入 (Stdin) 分配缓冲区。
Tty	仅无状态负载、有状态负载支持配置该参数。开启后，为容器分配一个终端，需同时勾选 Stdin。

容器端口

单击添加端口，根据界面提示，配置容器中应用对容器外服务的连接端口，包括支持的协议（TCP、UDP）、端口号、端口名称。例如 Nignx 监听端口名称为nginx的 TCP 协议 80 端口。

环境变量

单击添加环境变量，配置环境变量。Kubernetes 在创建 Pod 时，会将环境变量的信息注入到容器中。

配置项	说明
自定义	支持输入变量名称和变量值，创建自定义的环境变量。
配置项	支持部分引用或全部引用配置项中的变量。部分引用时，一条规则仅支持为一个 Key 创建环境变量。
保密字典	支持部分引用或全部引用保密字典中的变量。部分引用时，一条规则仅支持为一个 Key 创建环境变量。
实例字段	支持引用实例字段中的值，创建环境变量。 metadata.name：工作负载的名称。 metadata.namespace：工作负载所处的命名空间。 metadata.labels：工作负载的标签。 metadata.annotations：工作负载的注解。 spec.nodeName：工作负载所处的节点。 spec.serviceAccountName：所使用的服务账号。 status.hostIP：工作负载所处节点的 IP。 status.podIP：工作负载中 Pod 的 IPv4 地址。 status.podIPs：工作负载中 Pod 的 IPv4 和 IPv6 地址。
容器资源	支持引用容器中的字段作为环境变量。 limits.cpu：容器 CPU 的使用上限。 limits.memory：容器内存的使用上限。 requests.cpu：容器 CPU 请求的大小。 requests.memory：容器内存请求的大小。

存储配置

在容器中存储数据分两步：先在 Pod 定义卷（Volume），也就是添加卷，然后在容器挂载卷。

添加卷：单击添加卷，添加数据卷。卷（Volume）是容器中存储数据的位置。为一类数据分配存储资源前，需要先在容器中指定待存储数据的目录。

配置项	说明
配置项	支持为配置项中的全部数据或部分数据创建数据卷。为部分数据创建存储卷时，支持配置多数据 item，用半角分号（;）分隔。例如 cm1:path1;cm2:path2。
保密字典	支持部分挂载或全部挂载保密字典中的数据。为部分数据创建存储卷时，支持配置多数据 item，用半角分号（;）分隔。例如 cm1:path1;cm2:path2。
存储卷声明	选择当前工作负载命名空间中已创建的存储卷声明，并为其指定数据卷的名称。
临时目录	为临时目录创建数据卷名称。
主机目录	为主机中的目录创建数据卷。

挂载卷：单击添加挂载卷，为已创建的卷分配存储资源，并分配读写权限。具体配置操作如下：

配置操作	说明
选择数据卷	选择在添加卷中命名的数据卷。
输入挂载路径	存储数据要挂载到的容器路径。
选择挂载卷的路径方式	subPath：挂载卷的子目录。填写具体挂载的卷的子目录信息，如不填写则不使用挂载卷的子目录。 subPathExpr：挂载卷的扩展路径。填写具体挂载的卷的拓展路径信息，如不填写则不使用挂载卷的扩展路径。
分配读写权限	定义该挂载卷对应路径的读写限制。

生命周期

支持在创建容器时，自动注入容器运行前后的执行命令，设置的命令和参数将填写在配置文件中。如果容器镜像中存在相同的命令和参数，那么配置文件中命令和参数将覆盖容器镜像中的对应命令和参数。

注意

如下表生命周期配置项中，每个配置项的每条命令/参数都需要在单独的输入框中输入。单击配置项后的添加，输入一条命令/参数。

配置项	说明
运行命令	输入容器启动前运行的命令。
运行参数	输入容器启动前所运行命令的参数。
启动后处理	输入启动后命令。
停止前处理	输入停止前处理命令。

健康检查

支持配置存活检查、就绪检查和启动检查。允许基于 HTTP 协议、TCP 协议或执行具体命令的方式，探测容器中的负载是否正常。以下以配置存活检查为例，介绍配置参数。

配置项	说明
检查方式	配置检查的方式，包括： HTTP 请求检查：使用 HTTP 或 HTTPS 协议，向容器发送一个 HTTP GET 请求，通过检查响应确认容器状态。您需要进行如下检查配置：协议：HTTP 或 HTTPS。 HTTP 请求头：HTTP 请求中自定义的请求头（HTTP Headers）。单击添加输入键值对的配置方式。路径：访问 HTTP Server 的路径。端口：容器暴露的访问端口号或端口名称。 TCP 端口检查：向容器发送一个 TCP Socket，Kubelet 将尝试在指定端口上打开容器的 Socket。如果可以建立连接，容器被认为是健康的，如果不能就认为是失败的。您需要进行如下检查配置：端口：容器暴露的访问端口号或端口名称。执行命令检查：在容器内执行指定的命令，通过检查命令执行的结果确认容器状态。您需要进行如下检查配置：命令：检测容器健康情况的探测命令。注意每条命令，需要在单独的一条输入框中输入。单击添加，可增加一条输入框。 gRPC 请求检查：使用 gRPC 协议，通过发送 POST 或 GET 请求检查服务器应用是否健康。服务：健康检查的方法（method），可取值：POST 或 GET。
时间设置	配置检查的时间参数，包括：初始等待时间：指容器启动后，第一次执行探测时需要等待的时间，默认为 1 秒。超时时间：指发送检查请求后，等待响应的超时时间。超过此时间表示容器无响应，默认为 1 秒。检查间隔：相邻两次检查的时间间隔。默认为 10 秒。
阈值设置	配置检查的结果阈值。包括：成功阈值：检查请求发送后，表示系统正常的响应次数，默认为 1 次。该项不可配置。失败阈值：检查请求发送后，表示系统异常的无响应次数，默认为 3 次。即如果容器对请求 3 次无响应，则认为容器状态异常。

高级配置

Headless 服务

说明

仅有状态负载支持配置该参数。

配置项	说明
名称	配置 Headless 服务的名称。Headless 服务可以与其他服务发现机制进行接口，而不必与 Kubernetes 的实现捆绑在一起，平台也不会为它们进行负载均衡和路由。
端口	配置服务的端口号，支持 TCP、UDP 协议。允许配置多个端口号。

定时重复

说明

仅定时任务支持配置该参数。

配置项	说明
Cron 语句	Cron 语句是一个字符串，通过分钟、小时、日期、月份和星期，分为 5 个域，以空格分割。详细的 Cron 语句用法，请参见 Cron 语句。
成功任务保留数	保留运行成功任务记录的个数。
失败任务保留数	保留运行失败任务记录的个数。
并发策略	任务同时运行的策略：允许（Allow）：允许多个任务同时运行。到达新任务触发点时，前一个任务还在运行，那么新旧任务同时运行。禁止（Forbid）：不允许多个任务同时运行。到达新任务触发点时，前一个任务还在运行，那么新的任务不启动。替换（Replace）：不允许多个任务同时运行。到达新任务触发点时，前一个任务还在运行，新的任务会替换当前运行的任务运行。

运行策略

说明

仅任务、定时任务支持配置该参数。

配置项	说明
成功运行次数	配置任务中需要 Pod 成功运行的次数。
可并行数	配置 Pod 同时运行的上限。
最大超时时间	配置任务运行的最大时长。
重试次数	配置任务失败后的重试次数。
重启策略	配置 Pod 重启策略，包括：永不重启、失败后重启。

VCI 规格配置

说明

仅托管版集群的基本信息配置步骤中，算力类型选择弹性容器实例 VCI 的工作负载需要进行 VCI 规格配置。

配置项	说明
规格族类型	选择使用 VCI 实例规格族的方式，支持使用系统默认规格族中的规格创建工作负载，也支持自定义指定规格族中的规格创建工作负载。
规格族	选择指定规格族时需要配置该参数。请选择具体的 VCI 实例规格族及其下规格。相关说明，请参见 VCI 实例规格介绍。
实例个数	工作负载的 Pod 实例个数，用于校验工作负载可用的 VCI 资源配额和库存。对于 Deployment 和 Statefulset 类工作负载：与基本信息步骤中配置的实例个数一致，两者会相互同步更新。对于 Job 和 CornJob 类工作负载：与高级配置步骤运行策略模块中配置的可并行数一致，此处不可更改。
Pod 子网	设置 VCI 实例子网，有如下两种子网选项：集群 Pod 子网：使用所在集群的 Pod 子网作为 VCI 实例子网。指定 Pod 子网：自定义指定 VCI 实例子网，您还需要配置可用区、选择子网。

实例配置

配置项	说明
镜像缓存	【邀测·申请试用】在基本信息配置步骤中算力类型选择弹性容器实例 VCI 的工作负载显示该配置。系统根据您选择的容器镜像，显示该镜像是否已进行镜像缓存：未匹配到镜像缓存：表示上一页配置中选择的容器镜像，没有进行镜像缓存。您可以单击创建镜像缓存，为已选的容器镜像进行镜像缓存。参数配置说明，请参见使用手动镜像缓存创建 VCI 实例。镜像缓存加速可用：表示上一页配置中选择的容器镜像，已进行镜像缓存。创建当前工作负载时，可缩短镜像下载耗时，加速容器启动速度。镜像缓存相关介绍，请参见镜像缓存。
优雅退出	仅无状态负载、有状态负载、守护进程支持配置该参数。优雅时间是指实例终止前的缓冲时间，默认为 30 秒。当配置为 0 时，表示立即删除实例。
更新策略	仅无状态负载、有状态负载、守护进程支持配置该参数。配置实例更新策略，包括：滚动更新：将逐步用新版本的实例替换旧版本的实例，升级的过程中，业务流量会同时负载均衡分布到新老的实例上，因此业务不会中断。重新创建：将先把工作负载的老版本实例删除，再安装指定的新版本，升级过程中业务会中断。
最大不可用	仅无状态负载、守护进程类型的工作负载且选择滚动更新策略时，需要配置此参数。指定滚动更新缩容过程中，工作负载中可用的实例（Pod）的数量的下限。支持基于百分比或具体数值配置 Pod 的最大不可用数量。使用百分比时，会将计算结果转换成绝对值并去除小数部分。最大不可用和最大超量不能同时为 0。
最大超量	仅无状态负载类型的工作负载且选择滚动更新策略时，需要配置此参数。指定滚动更新扩容过程中，工作负载中可用的实例（Pod）的数量的上限。支持基于百分比或具体数值配置 Pod 的最大超量。使用百分比时，会将计算结果转换成绝对值并去除小数部分。最大不可用和最大超量不能同时为 0。
实例标签	配置 Pod 实例标签，配合标签选择器，帮助 Kubernetes 筛选目标 Pod。单击添加实例标签，根据界面提示输入符合要求的键和值。
实例注解	配置 Pod 实例注解。单击添加实例注解，根据界面提示输入符合要求的键和值。注解对应 Kubernetes 中的 Annotation，不用于标识和区分资源，主要记录用于应用部署、安全策略、调度策略的附加信息。
DNS 策略	配置实例的 DNS 策略。包括： ClusterFirst：在该模式下，会将 Kube-dns 或 CoreDNS 的信息当作预设置参数，写入到该 Pod 内的 DNS 配置。 Default：在该模式下，Pod 里面的 DNS 配置继承了宿主机上的 DNS 配置。即该 Pod 的 DNS 配置与宿主机完全一致。 ClusterFirstWithHostNet：在该模式下，宿主机上的 DNS 配置与 Kube-dns 同时作为 Pod 的预设 DNS 配置。 None：该模式下， Kubernetes 不会为 Pod 预先加载任何逻辑，用于判定得到 DNS 的配置。

其他

工作负载支持以非 root 用户运行。开启非 root 用户运行后，指定容器必须以非root用户权限运行，否则容器将会启动失败。

最近更新时间：2026.02.04 22:09:44

这个页面对您有帮助吗？

有用

无用