持续交付提供 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 发布卡片的标题，查看运行日志、任务配置等信息。

• 运行日志：实时展示该任务的运行日志。
• 任务配置：展示该任务的配置参数，详情可参考前文的参数说明。