更新时间:2024-10-15 GMT+08:00

配置流水线参数

流水线参数可以传递给各个任务使用,实现任务间数据流动的统一,只需要配置好流水线参数,即可完成构建、部署、接口测试等任务的数据拉通。流水线参数包括以下三种。

  • 系统预定义参数:系统默认提供的参数,无需定义、不能删除、不能修改。
  • 自定义参数:根据需要自定义添加,参数类型包括字符串类型、枚举类型、自增长类型。
  • 通用参数组:项目下通用流水线参数,所有流水线都可以关联并使用通用参数组。
  • 如果设置了代码源别名,可基于别名生成仓库对应的系统参数,未设置别名则以仓库名作为别名,生成系统参数,如:“别名_TAG”,表示仓库标签名称。
  • 当同一条流水线关联多个参数组,且多个参数组存在同名参数时,以后关联的参数组参数取值为准。
  • 参数引用形式:${参数名},在参数输入框输入“$”符号后会自动出现参数列表。

流水线系统预定义参数

表1 流水线系统预定义参数

参数信息

说明

TIMESTAMP

流水线执行时间戳。例如:20211222124301。

PIPELINE_TRIGGER_TYPE

流水线触发类型。包括:Manual、Scheduler、RollBack以及WebHook类型(CreateTag、Note、Issue、MR、Push)。

PIPELINE_NAME

流水线名称。

REPO_URL

代码仓地址(HTTPS)。

EXECUTE_USER

执行人。

PASS_CONDITIONS_LINK

流水线执行详情链接。

PIPELINE_RUN_ID

流水线执行ID。

MERGE_ID

合并请求ID。

WEBHOOK_PAYLOAD

Webhook请求负载信息。

Repo01_REPOSITORY_NAME

仓库名称。

Repo01_SOURCE_BRANCH

仓库运行源分支名称。

Repo01_TARGET_BRANCH

仓库运行目标分支名称。

Repo01_TAG

仓库标签名称。

Repo01_COMMIT_ID

执行时代码最后一次提交的ID。

Repo01_COMMIT_ID_SHORT

执行时代码最后一次提交的短ID

Repo01_REPO_URL

代码仓地址(HTTPS)。

配置流水线自定义参数

介绍流水线自定义参数新建和配置。

  1. 访问CodeArts Pipeline首页
  2. 在流水线列表页搜索目标流水线,单击操作列,选择“编辑”。
  3. 进入流水线“任务编排”页面,切换至“参数设置”页面。
  4. 单击参数列表下的“立即新建”(已存在自定义参数,则单击“新建参数”),填写参数信息。

    表2 流水线自定义参数说明

    参数信息

    说明

    名称

    自定义参数名称。支持大小写英文字母、数字、“_”,长度不超过128个字符。

    说明:

    自定义参数名称不可与系统预定义参数名称相同。

    类型

    参数可选类型:字符串(默认类型)、自增长、枚举。

    默认值

    自定义参数的默认取值。

    • 字符串:长度不超过8192个字符。
    • 自增长:长度不超过8192个字符。
      说明:

      自增长类型参数如果被引用,全新执行一次后,下次执行时参数值末位如果是数字则会自动+1。

    • 枚举:仅支持中文、大小写英文字母、数字、“-”、“_”、“,”、“.”、“/”,长度不超过8192个字符。

      选择枚举类型后,在弹出的对话框中添加可选取值,添加完成后在“默认值”下拉框中选择一个默认值,再次单击“枚举”类型,可修改可选取值。

    私密参数

    参数为私密参数时,系统会将输入参数做加密存储,使用时解密,同时在运行日志里不可见。

    运行时设置

    打开“运行时设置”开关,在执行流水线时支持修改该参数的值。

    参数描述

    不超过512个字符。

    • 最多可以新建20个自定义参数。
    • 单击参数所在行,可以删除该参数。

  5. 配置完成后,保存流水线。

配置流水线通用参数组

  1. 通过项目入口方式访问CodeArts Pipeline首页
  2. 切换至“通用参数组”页面,单击“新建参数组”。
  3. 进入“新建通用参数组”页面,填写参数信息。

    图1 新建通用参数组
    表3 通用参数组参数说明

    基本信息

    说明

    所属项目

    通用参数组归属项目,不可更改。

    参数组名称

    支持大小写英文字母、数字、“_”,长度不超过128个字符。

    描述

    长度不超过512个字符。

    自定义参数列表

    单击“立即新建”,可根据需要添加自定义参数,参数配置方法同自定义参数

    最多可以新建5个通用参数组,每个参数组最多可以添加20个自定义参数。

  4. 单击“确定”,新建完成。
  5. 编辑需要关联通用参数组的流水线,进入“参数设置 > 通用参数组”页面。
  6. 单击“立即关联”,选择参数组,然后单击“确定”,即可将参数组关联到当前流水线。

    • 展开通用参数组,可以查看参数详情。
    • 单击操作列,可以解除关联参数组。
    图2 关联参数组

  7. 配置完成后,保存流水线。

流水线参数使用示例

本文以通过流水线统一配置releaseversion参数并传递到构建任务为例,介绍流水线参数使用方法。

  1. 新建构建任务。
  2. 在“参数设置”页面添加releaseversion参数并设置好默认值,打开“运行时设置”。

    图3 新建构建任务参数

  3. 在“构建步骤”页面,选择“上传软件包到软件发布库”,将“发布版本号”配置成引用参数形式。在参数输入框输入“$”符号后会自动出现参数列表,选择上一步已经新建好的releaseversion参数。

    图4 引用构建任务参数

    使用“$”符号引用通用参数组的参数时不会自动生成提示。

  4. 配置完成后,保存构建任务。
  5. 新建空白模板流水线,在流水线阶段添加一个新的任务,然后在该任务中添加“Build构建”插件并调用刚创建的构建任务,即可看到刚新建好的构建任务参数releaseversion。

    图5 配置构建任务参数

  6. 将鼠标移动到releaseversion参数上,可以一键将该参数设置为流水线参数并能直接引用该参数;或直接单击“确定”,然后切换到流水线“参数设置”页面,新建流水线参数releaseversion,类型可以根据需求选择自增长或字符串等,设置默认值并打开运行时设置。

    图6 新建流水线参数

  7. 再切回到流水线“任务编排”页面,编辑刚添加的构建任务,将流水线的releaseversion参数通过“$”符号引用到构建任务的releaseversion参数内。

    图7 引用流水线参数
    • 该处只显示构建任务中开启“运行时设置”的文本类型参数。
    • 鼠标移至参数名称,可以快速将该参数设置为流水线参数并能直接引用该参数。

  8. 完成参数引用后,保存信息,然后单击“保存并执行”,弹出“执行配置”侧滑框,可查看“运行参数配置”。

    运行时参数值默认为添加参数时为参数设置的默认值,可根据需要进行修改。流水线运行时在构建任务内使用的就是此时输入的参数值。

  9. 设置完参数,单击“执行”,开始使用配置的参数执行流水线。