配置构建任务参数
编译构建服务默认生成codeBranch参数和系统预定义参数。用户可以根据需要修改codeBranch参数类型和参数值，并添加其他自定义参数。
系统预定义参数的参数值由系统自动生成，无需定义，如表1所示，可在代码中使用${参数名}引用。
参数名称 |
参数说明 |
|---|---|
BUILDNUMBER |
构建编号。格式为“日期.今日该构建任务执行次数”，例如：20200312.3。 |
TIMESTAMP |
构建执行时间戳。例如：20190219191621。 |
INCREASENUM |
该任务构建执行总次数，从1开始自增长，每执行1次加1。 |
PROJECT_ID |
项目编号。 |
WORKSPACE |
工作空间，源代码根目录。 |
GIT_TAG |
代码tag名，使用tag构建时才有值。 |
COMMIT_ID_SHORTER |
代码提交号的前8位。 |
COMMIT_ID |
代码提交号。例如：b6192120acc67074990127864d3fecaf259b20f5。 |
添加自定义参数的配置指导
在编译构建任务配置页面，切至“参数设置”页签，单击“新建参数”，参考表2配置参数。
类型 |
名称 |
默认值 |
私密参数 |
运行时设置 |
参数描述 |
|---|---|---|---|---|---|
字符串 |
自定义参数名称。支持字母，数字，下划线“_”，长度不超过128个字符。
说明：
|
自定义参数的默认值。长度不超过8192个字符。 |
设置是否为私密参数。参数为私密参数时，系统会将输入参数进行加密存储，使用时再进行解密，同时在运行日志里不可见。 |
设置该参数是否在执行构建任务时设置。 打开“运行时设置”开关，表示通过单击 |
自定义关于该参数的描述信息。长度不超过1024个字符。 |
枚举 |
在弹出的对话框中，填写自定义的“可选取值”，每个参数值必须以英文分号结尾。长度不超过8192个字符。 配置完可选取值后，在“默认值”的下拉框中为该参数配置一个默认值。 |
||||
自增长 |
自定义参数的默认值。长度不超过8192个字符。 |
使用参数的操作指导
以自定义的参数名设置为“myparam”、默认值设置为“1.0.1.1”，打开“运行时设置”开关为例。
- 在编译构建任务配置页面切换到“构建步骤”页签，在“上传软件包至软件发布库”构建步骤的“发布版本号”中输入“${myparam}”，保存构建任务。
- 执行构建任务。弹出“设定参数并执行”框，将“myparam”修改为“1.0.1.2”，单击“确定”，等待构建任务执行完成。
- 进入软件发布库，找到刚构建的构建包，即可看到版本号就是修改后的的“myparam”值。
