配置流水线参数

流水线系统预定义参数请参见表1，参数引用形式：${参数名}，在参数输入框输入“$”符号后会自动出现系统预定义参数列表。

介绍流水线自定义参数的新建和配置。参数引用形式：${参数名}，在参数输入框输入“$”符号后会自动出现自定义参数列表。

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

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

   参数信息	说明	取值样例
   名称	自定义参数名称，不可与系统预定义参数名称相同。支持大小写英文字母、数字、“_”，长度不超过128个字符。	输入“test01”。
   类型	参数可选类型：字符串、自增长、枚举，默认选择字符串类型。	选择“字符串”。
   默认值	自定义参数的默认取值。 字符串：长度不超过8192个字符，可以为空。 自增长：长度不超过8192个字符。不能为空。自增长类型参数如果被引用，全新执行一次后，下次执行时参数值末位如果是数字则会自动加1。 枚举：长度不超过8192个字符，仅支持中文、大小写英文字母、数字、“-”、“_”、“,”、“.”、“/”。 选择枚举类型后，在弹出的对话框中添加可选取值，可选取值不能为空。添加完成后在“默认值”下拉框中选择一个默认值，支持输入关键词搜索过滤。	输入“releaseversion”。
   私密参数	参数为私密参数时，系统会将输入参数做加密存储，并在使用时自动解密。该参数在运行日志中不可见，且在流水线复制时不会被同步复制。仅字符串类型参数可设置为私密参数。	-
   运行时设置	打开“运行时设置”开关，在手动执行流水线时支持修改该参数的值。	单击打开“运行时设置”。
   参数描述	对该自定义参数的相关描述，长度不超过512个字符。	-
   操作	单击“操作”列，可以新增参数。 单击“操作”列，可以删除参数。	-

5. 配置完成后，单击“保存”，弹出“保存信息成功”提示，保存流水线成功。

   

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

   

   表3 通用参数组参数说明

   基本信息	说明	取值样例
   所属项目	通用参数组归属项目，不可更改。	默认为“project01”。
   参数组名称	仅支持大小写英文字母、数字、“_”，长度不超过128个字符。	输入“group01”。
   描述	对所新建的通用参数组的描述，长度不超过512个字符。	-
   自定义参数列表	单击“立即新建”，可根据需要添加自定义参数，参数配置方法同自定义参数。	配置示例如下图：

4. 单击“确定”，完成新建通用参数组。
5. 找到需要关联通用参数组的流水线，单击操作列，选择“编辑”，单击“参数设置” ，单击“通用参数组”，进入“通用参数组”页面。
6. 单击“立即关联”，选择需要关联的参数组，单击“确定”，即可将参数组关联到当前流水线。
   • 展开通用参数组，可以查看参数详情。
   • 单击操作列，可以解除关联参数组。
   图3 关联参数组
   

7. 配置完成后，单击“保存”，弹出“操作成功”提示，保存成功。