设计自定义流水线

主要操作过程

1. 在流水线管理页面的自定义流水线页签，单击目标自定义流水线右侧操作列下的设计流水线。

2. 在目标自定义流水线设计器画布中，您可以参考以下步骤添加任务。

   1. 在目标位置单击图标。流水线设计器画布上，各阶段节点之间以及阶段节点内均有该图标，单击后可添加新的阶段或任务。

      说明

      您可以添加阶段节点的任务，或在阶段节点内添加任务。

   2. 在添加任务面板，选择需要添加的任务。本文以添加编译构建任务为例说明，点击编译构建区域。可选的任务类型包括编译构建（对代码进行编译构建，生成制品）、部署（将制品部署到目标环境）、流水线控制（增加人工审批等控制）和执行命令（执行Shell命令等进行功能扩展）。

      重要

      如果在新建自定义流水线步骤，流水线源选择镜像，则在添加任务对话框中，没有编译构建选项。关于如何新建自定义流水线，请参见自定义流水线。

      1. 在编辑构建面板，您可以修改任务名称和描述。面板中还显示自动生成的任务编码，以及任务步骤区域，可单击添加步骤按钮添加具体的构建步骤。

      2. 单击添加步骤，在添加面板，选择目标任务（以Maven构建为例）后，单击确定。您可以对任务步骤中的相关参数进行修改或配置，或添加多个步骤，移动同一个任务下多个步骤的先后顺序。添加后，Maven构建步骤显示步骤名称、步骤编码以及选择JDK版本、选择Maven版本和构建命令等配置项。

3. 可选：编辑或删除目标阶段节点。单击流水线中的目标阶段节点的图标或图标，编辑或删除该阶段节点信息。

   说明

   流水线源和代码准备阶段节点不支持编辑和删除。

4. 完成流水线设计后，单击保存。

支持的任务类型

编译构建

任务步骤：Maven构建

支持的参数如下：

任务步骤：制作镜像并推送到镜像仓库

支持的参数如下：

本步骤的输出包括：

部署

任务步骤：部署到目标环境

目标部署环境类型支持勾选开发环境、测试环境、预发环境和生产环境。

支持的参数如下：

流水线控制

步骤：人工审批

​

支持的参数如下：

审批

包含人工审批步骤的流水线运行后，审批人可在BizWorks控制台上处理审批任务。

在BizWorks控制台的任务中心页面，选择待我审批页签，可通过来源系统、任务类型、发起时间和发起人筛选审批任务。任务列表显示各审批任务的详情，可在操作列单击详情、同意或拒绝进行处理，也支持批量同意和批量拒绝。

执行命令

步骤：执行命令

支持的参数如下：

变量

支持系统变量和自定义变量两种类型：

• 系统变量。系统默认提供，只能由系统赋值、不支持用户自定义内容。支持的系统变量如下：

  系统变量名	说明
  BW_TENANT_ID	租户ID
  BW_USER_ID	用户id
  BW_PROJECT_CODE	项目编码
  BW_APPLICATION_CODE	应用编码
  BW_DEPLOY_ENV_TYPE	部署环境类型
  BW_ENVIRONMENT_CODE	部署环境编码
  BW_PIPELINE_INSTANCE_CODE	流水线实例编码
  BW_WORK_DIR	工作目录
  BW_DATETIME	时间
  BW_GIT_CHECKOUT_PARAMS_URL	代码仓库地址 说明 仅流水线源=代码时可使用该变量
  BW_GIT_CHECKOUT_PARAMS_BRANCH	代码分支 说明 仅流水线源=代码时可使用该变量
  BW_GIT_CHECKOUT_PARAMS_TAG	代码Tag 说明 仅流水线源=代码时可使用该变量
  BW_GIT_CHECKOUT_PARAMS_COMMIT_ID	代码CommitId 说明 仅流水线源=代码时可使用该变量。
  BW_DOCKER_BUILD_PARAMS_BUILD_OUTPUT_随机数	制作镜像并推送至镜像仓库步骤的输出变量
  BW_PLATFORM_ARCH	保存部署环境所在容器镜像节点的芯片架构，例如amd64、arm64，如果为空时则默认为amd64
  BW_DEPLOY_TARGET_ENV_PARAMS_IMAGE_URL	镜像信息（含Tag） 说明 仅流水线源=镜像时可使用该变量

• 自定义变量。用户可为自定义流水线创建运行时所需的自定义变量。自定义变量只能在流水线执行时的入参赋值，暂不支持运行过程中在步骤中赋值。

  您可在流水线设计器左侧的流水线变量面板中进行新建、修改和删除。

  新建自定义变量。单击流水线设计器页面左上角新增变量。

  支持的参数如下：

  参数	说明
  变量名称	默认随机生成，可按需调整。
  默认值	可选参数，用于流水线运行前该自定义变量的默认填入值，给流水线使用者提供便利。 设置方式为文本框时，默认值可填写String类型的内容。 设置方式为下拉单选时，可选择某个备选值作为下拉单选框的默认选中。
  运行时设置	默认不选中。该自定义变量不能在流水线运行前设置。 选中后，支持在运行流水线前设置。
  设置方式	用于确定使用者运行时的交互方式，目前支持文本框和下拉单选两种交互方式。 下拉单选支持添加多个备选项。

  如果启用运行时设置的自定义变量，在流水线运行前的交互过程如下。

  在创建部署实例时，部署配置对话框的流水线区域会显示流水线变量表格，列出所有启用了运行时设置的自定义变量。文本框类型的变量（如p1）显示默认值供修改，下拉单选类型的变量（如p2）显示下拉选择器供选择备选项。

在流水线中使用变量：

• 在步骤中支持使用两种类型的变量。

• 使用方式为${变量名}，变量会以占位符的方式在流水线运行时自动替换，例如：cd ${WORKDIR}。