# 配置构建任务参数
编译构建默认生成系统预定义参数，用户也可以根据需要添加其他自定义参数。其中，系统预定义参数的参数值由系统自动生成，无需定义，可通过**${参数名}**引用。
#### 系统预定义参数
系统预定义参数的参数值由系统自动生成，无需定义，如[表1]所示，可在代码中使用${参数名}引用。
 表1系统预定义参数 
| **参数**            | **说明**                                                                                                      |
|:---|:---|
| BUILDNUMBER       | 构建编号。格式为"日期.今日该构建任务执行次数"，例如：20200312.3。                                                                     |
| TIMESTAMP         | 构建任务执行时间戳。例如：20190219191621。                                                                                |
| INCREASENUM       | 该构建任务执行总次数，从1开始自增长，每执行1次加1。                                                                                 |
| PROJECT_ID        | 该构建任务所在的项目编号。                                                                                               |
| WORKSPACE         | 该构建任务拉取的源代码根目录，即工作空间。                                                                                       |
| GIT_TAG           | 代码tag名，在[配置代码下载](https://support.huaweicloud.com/usermanual-codeci/codeci_ug_1067.html)时指定tag构建才有值。         |
| COMMIT_ID_SHORTER | 代码提交号的前8位。在[配置代码下载](https://support.huaweicloud.com/usermanual-codeci/codeci_ug_1067.html)时指定CommitID构建才有值。 |
| COMMIT_ID         | 代码提交号。例如：b6192120acc67074990127864d3fecaf259b20f5。                                                          |
| JOB_ID            | 构建任务编号。                                                                                                     |
| GIT_BRANCH        | 触发这次构建的源代码分支。                                                                                               |
| SOURCE_NAME       | 触发构建的源代码仓库名称。                                                                                               |
| GIT_LOCAL_BRANCH  | 触发构建的本地源代码分支名。                                                                                              |
   
 #### 添加自定义参数的配置指导
在编译构建任务配置页面，切换至"参数设置"页签，单击"新建参数"，参考[表2]配置参数。系统会将输入参数做加密存储，使用时解密。
 表2添加自定义参数 
| **名称**                                                                                                                                                                                                                                                                                                                              | **类型** | **默认值**                                                                                                              | **私密参数**                                                | **运行时设置**                                                                                                                                                                                        | **参数描述**                    |
|:---|:---|:---|:---|:---|:---|
| 自定义参数名称。支持字母，数字，下划线"_"，长度不超过128个字符。 注意： - 以下字段不可用：LD_PRELOAD、LD_LIBRARY_PATH、PATH、BASH_ENV、GIT_SSH_COMMAND、path。  - 不支持任何符号。   | 字符串    | 自定义参数的默认值。长度不超过8192个字符。                                                                                              | 设置是否为私密参数。参数为私密参数时，系统会将输入参数进行加密存储，使用时再进行解密，同时在运行日志里不可见。 | 设置该参数是否在执行构建任务时设置。 打开"运行时设置"开关，表示通过单击![](https://support.huaweicloud.com/usermanual-codeci/zh-cn_image_0000001985097345.png)按钮执行构建任务时支持变更参数值，并且系统会把该参数上报到流水线服务。 | 自定义关于该参数的描述信息。长度不超过1024个字符。 |
| 自定义参数名称。支持字母，数字，下划线"_"，长度不超过128个字符。 注意： - 以下字段不可用：LD_PRELOAD、LD_LIBRARY_PATH、PATH、BASH_ENV、GIT_SSH_COMMAND、path。  - 不支持任何符号。   | 枚举     | 在弹出的对话框中，填写自定义的"可选取值"，每个参数值必须以英文分号结尾。长度不超过8192个字符。 配置完可选取值后，在"默认值"的下拉框中为该参数配置一个默认值。 | 设置是否为私密参数。参数为私密参数时，系统会将输入参数进行加密存储，使用时再进行解密，同时在运行日志里不可见。 | 设置该参数是否在执行构建任务时设置。 打开"运行时设置"开关，表示通过单击![](https://support.huaweicloud.com/usermanual-codeci/zh-cn_image_0000001985097345.png)按钮执行构建任务时支持变更参数值，并且系统会把该参数上报到流水线服务。 | 自定义关于该参数的描述信息。长度不超过1024个字符。 |
| 自定义参数名称。支持字母，数字，下划线"_"，长度不超过128个字符。 注意： - 以下字段不可用：LD_PRELOAD、LD_LIBRARY_PATH、PATH、BASH_ENV、GIT_SSH_COMMAND、path。  - 不支持任何符号。   | 自增长    | 自定义参数的默认值。长度不超过8192个字符。                                                                                              | 设置是否为私密参数。参数为私密参数时，系统会将输入参数进行加密存储，使用时再进行解密，同时在运行日志里不可见。 | 设置该参数是否在执行构建任务时设置。 打开"运行时设置"开关，表示通过单击![](https://support.huaweicloud.com/usermanual-codeci/zh-cn_image_0000001985097345.png)按钮执行构建任务时支持变更参数值，并且系统会把该参数上报到流水线服务。 | 自定义关于该参数的描述信息。长度不超过1024个字符。 |
   
![](https://support.huaweicloud.com/usermanual-codeci/public_sys-resources/caution_3.0-zh-cn.png)
流水线任务中的私密参数在配置的构建任务中无法使用。如果需使用私密参数，可在构建任务中进行配置。
#### 使用参数的操作指导
以[图1]为例为您介绍如何使用自定义的参数。
图1自定义参数   
![](https://support.huaweicloud.com/usermanual-codeci/zh-cn_image_0000001991003229.png)
1. 在编译构建任务配置页面切换到"构建步骤"页签，在"上传软件包至软件发布库"构建步骤的"发布版本号"中输入"${myparam}"，保存并执行构建任务。
2. 在弹框中，将"myparam"修改为"1.0.1.2"，单击"确定"，等待构建任务执行完成。
   图2填写运行参数值   
   ![](https://support.huaweicloud.com/usermanual-codeci/zh-cn_image_0000002515577582.png) 
3. 进入软件发布库，找到刚构建的构建包，即可看到版本号就是修改后的"myparam"值。
   图3查看构建包   
   ![](https://support.huaweicloud.com/usermanual-codeci/zh-cn_image_0000001952138344.png)