文档中心

持续交付

部署

Kubectl 发布

持续交付提供 Kubectl 发布任务，支持用户基于 YAML 资源描述文件创建 Kubernetes 发布任务，将代码仓库中的 YAML 文件或自定义 YAML 文件部署到 Kubernetes 集群中。

前提条件

已接入待部署的集群，具体操作请参见接入部署资源。

已编写好 YAML 文件。

若目标镜像为私有镜像，请注意在部署集群提前设置密钥或配置免密组件。在容器服务配置可参考配置保密字典、配置免密组件。添加任务

创建或编辑流水线时，在流程编排页签，单击添加任务，弹出添加任务抽屉。任务模板选择 Kubectl 发布。

参数说明

下文为您介绍该预置任务的参数。

任务名称

默认为 Kubectl 发布，支持自定义任务名称。

上游任务

展示当前任务的上游串行任务名称。无上游任务时展示为-。

代码源下载策略

根据当前任务是否需要使用代码源，选择代码源下载策略。

下载代码：当前任务需要下载代码源。

不下载代码：当前任务无需使用代码源。

步骤

当前任务包含一个默认预置步骤（Kubectl 发布）。支持根据需要为当前任务添加其他串行步骤。下文介绍该默认预置步骤的参数。

配置项	说明
步骤名称	默认为 Kubectl 发布，支持自定义步骤名称。
部署资源	选择已接入的待部署集群。
YAML 文件	输入 YAML 文件，支持使用文件路径和输入自定义 YAML 文件两种方式，请按需选择。文件路径: 填写需要部署的 YAML 文件名或 YAML 文件目录在源码中的相对路径，默认为./manifest。自定义文件：自行编写 YAML 文件。支持通过模板快速创建 YAML 文件。系统提供 Namespace、Deployment、StatefulSet、Service、ConfigMap 五种模板。
镜像引用	可选配置。YAML 文件中的镜像引用流水线上游产物时，需填写该参数。设置变量 key，选择前序镜像打包任务的产出物，并在 YAML 中用$(key)来替换对应的 image 参数值。例如：设置 key 为image，选择目标上游产物。并在 YAML 中，用$(image)来替换原 image 值。
变量	可选配置。对 YAML 文件中的参数进行变量替换，提升 YAML 文件的通用性和灵活性。单击+，添加一条变量。支持添加多条。变量由 key 和 value 组成： key：变量名。注意此处的 key 必须与 YAML 中填写的 key 保持一致。在 YAML 中，通过$(key)引用该变量。 value：变量值。value 支持输入常量，也支持引用流水线变量。例如：Deployment.yaml 文件中将部署的命名空间设置为变量$(namespace)。则此处 key 应为namespace；value 可以为常量（例如default），也可以引用流水线变量（例如$(parameters.ns))。注意镜像引用的 key 与变量 key 冲突时，镜像引用生效的优先级更高。
失败时跳过	可选配置。开启：当前步骤运行失败直接跳过，当前任务其余步骤可继续执行，流水线也可继续向下运行。关闭：当前步骤失败后，当前任务其余步骤不再执行，流水线将运行失败。

任务输出

展示当前任务输出的所有产物，包含当前任务下所有步骤的产物。无产物时展示为-。产物可用于后续任务的输入。

对于当前默认预置步骤，将输出部署资源 ID。

高级设置

超时时间：设置整个任务的超时时间，任务超时后自动失败。一个任务可以包含多个串行步骤，每个步骤的运行时长总和需要小于任务的超时时间。

Webhook 通知：支持通过 Webhook 和飞书机器人两种方式推送任务维度的消息，帮助您及时掌握任务动态。

日志说明

下文为您介绍该预置任务运行完成后，流水线展示的详情信息。

在当前流水线的运行详情页面，单击 Kubectl 发布卡片的标题，查看运行日志、任务配置等信息。

运行日志：实时展示该任务的运行日志。

任务配置：展示该任务的配置参数，详情可参考前文的参数说明。

最近更新时间：2026.01.27 14:25:40

这个页面对您有帮助吗？

有用

无用