文档首页 > > 用户指南>

构建参数

构建参数

分享
更新时间:2021/04/07 GMT+08:00

编译构建默认生成codeBranch参数和系统预定义参数。用户可以根据需要修改codeBranch参数类型和参数值,并添加其他自定义参数;系统预定义参数参数值由系统自动生成,不需定义,可通过${参数名}引用。

参数配置

编辑构建任务,切至“参数设置”页签。

  

参数信息说明如下:

基本信息

说明

参数名称

参数名称。除系统默认生成的codeBranch参数和系统预定义参数,其余自定义新增的参数可自定义修改参数名称。

参数类型

参数可选类型。包括文本类型和枚举类型。

参数值

参数的默认值。选择不同类型的参数系统都会自动生成对应的默认值,可根据需要修改参数值。

静态参数

静态参数默认是不选中的,选中表示单独执行构建任务时不支持变更参数值,并且也不会把该参数上报流水线。

描述

对参数进行描述。

操作

单击“操作” ,可以添加或删除参数,系统默认生成的codeBranch参数无法删除。

  • 添加文本类型参数

    单击“操作”,默认新增一条文本类型参数,可根据需要修改参数名、参数值、参数描述,配置静态参数等。

  • 添加枚举类型参数
    1. 单击“操作”,默认新增一条文本类型参数。
    2. 单击参数类型下拉列表,选择“枚举参数”,弹出“枚举参数”框。
    3. 为参数设置“可选取值”,每个参数值必须以英文逗号结尾。
    4. 设置完成后,在“参数值”列单击下拉列表选择其中一个值。

参数使用

分别举例介绍自定义参数和系统预定义参数的使用。

  • 自定义参数
    1. 配置执行参数。

      编辑构建任务,选择“参数设置”页签,添加一条参数,设置参数名称和参数值,本例参数名为“myparam”,参数值为“1.0.1.1”

    2. 使用执行参数。

      切换到“构建步骤”页签,配置构建步骤,在文本框里输入“$”, 选择需要的执行参数“myparam”。然后保存构建任务。

    3. 执行构建任务。

      弹出“设定参数并执行”框,根据实际情况输入值或者使用默认值。

    4. 本构建任务是Maven构建并且开通了发布服务,所以可以在发布服务里查到该任务的构建包。

      看到版本号就是用户自定义的执行参数“myparam”值。

  • 系统预定义参数
    1. 配置执行参数。

      编辑构建任务,选择“构建步骤”页签,配置构建步骤,文本框里输入“$”,选择需要的系统参数,这里选择“BuildNumber”

      也可以选择其他参数,选择后保存构建任务。

      参数名

      说明

      BuildNumber

      构建编号。格式为“日期.今日该构建任务执行次数”,例如:20200312.3

      GIT_COMMIT

      代码提交号。例如:b6192120acc67074990127864d3fecaf259b20f5

      TIMESTAMP

      构建执行时间戳。例如:20190219191621

      INCREASENUM

      该任务构建执行总次数,从1开始自增长,每执行1次加1。

      PROJECT_ID

      项目编号。

      WORKSPACE

      工作空间,源代码根目录。

      GIT_TAG

      代码tag名,使用tag构建时才有值。

    2. 运行构建任务。
    3. 本构建任务是Maven构建并且开通了发布服务,所以可以在发布服务里查到该任务的构建包。

      输入本次构建的包名“demo01”,看到版本号就是系统的执行参数“BuildNumber”

分享:

    相关文档

    相关产品