You need to enable JavaScript to run this app.
导航
Kubectl 发布
最近更新时间:2024.11.06 14:37:04首次发布时间:2023.10.23 11:22:00

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

前提条件

  • 已接入待部署的集群,具体操作请参见 接入部署资源
  • 已编写好 YAML 文件。
  • 若目标镜像为私有镜像,请注意在部署集群提前设置密钥或配置免密组件。在容器服务配置可参考 配置保密字典配置免密组件

添加任务

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

参数说明

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

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

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

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

    • 下载代码:当前任务需要下载代码源。
    • 不下载代码:当前任务无需使用代码源。
  • 步骤
    当前任务包含一个默认预置步骤(Kubectl 发布)。支持根据需要为当前任务添加其他串行步骤。下文介绍该默认预置步骤的参数。
    alt

    配置项说明
    步骤名称默认为 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 发布卡片的标题,查看运行日志、任务配置等信息。
alt

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