跳到主要内容

参数设置

系统级参数​

系统级参数是 Gitee Go 内置参数，只要产生一条构建记录即可产生以下参数，并可以在任何任务内使用。全部使用 GITEE_xxx 形式描述，使用 ${GITEE_xxx} 或 $GITEE_xxx 可以引用参数。系统参数全部由系统生成，不可变更。

参数描述
GITEE_PIPELINE_NAME流水线唯一标识
GITEE_PIPELINE_DISPLAY_NAME流水线名字
GITEE_PIPELINE_BUILD_NUMBER流水线构建号
GITEE_PIPELINE_TRIGGER_USER流水线触发人
GITEE_COMMIT_MESSAGEPush 和 Tag 的 message 或 PR 的 title
GITEE_BRANCHPush 下的分支或 PR 下的目标分支
GITEE_COMMITPush 和 Tag 的 commit 或 PR 的目标分支 commit
GITEE_SOURCE_BRANCH发起 PR 时的源分支
GITEE_SOURCE_COMMIT发起 PR 时的源分支 commit
GITEE_PULL_ID发起 PR 时的 PR 号
GITEE_REPO代码仓库名
GITEE_STAGE_NAME阶段唯一标识
GITEE_STAGE_DISPLAY_NAME阶段名字
GITEE_STAGE_STRATEGY阶段触发策略，manual 或 auto

使用事例： 【推荐】您可以在可视化编辑界面引用： 引用系统变量

您可以在 Yml 中直接引用：

# 如下在 Maven 构建中，可这样使用
- step: build@maven
  name: build_maven_2
  displayName: Maven 构建 -2
  jdkVersion: 8
  mavenVersion: 3.3.9
  commands:
    - echo ${GITEE_PIPELINE_NAME}

流水线级参数​

流水线级参数属于用户自定义参数，可以在此条流水线内任何阶段、任务内使用。其中 GITEE_、GO_ 为系统保留字。流水线级参数为用户自定义参数，可以变更，您可以通过执行以下命令来更改参数或创建参数 echo 'Key=Value' >> GITEE_PARAMS ，其中 GITEE_PARAMS 为参数专用处理文件。

使用事例： 【推荐】您可以在可视化编辑界面中定义并引用：

定义流水线级参数

引用流水线级参数

您可以在 Yml 中直接定义并引用：

# 非必填字段
variables:
  // Key：支持数字、字母（包含大小写）、中划线、下划线，不支持特殊字符，最大32个字符，其中GITEE_、GO_为系统保留字
  // Value：请支持数字、字母、通用符号、中文等，最大256个字符
  PIPELINE_A: aaa
  
 # 定义好之后可以在任务中引用，如下在 Maven 构建中引用
- step: build@maven
  name: build_maven_2
  displayName: Maven 构建 -2
  jdkVersion: 8
  mavenVersion: 3.3.9
  commands:
    - echo ${PIPELINE_A}
    # 更改参数值
    - echo '${PIPELINE_A}=bbb' >> GITEE_PARAMS
    # 通生成一个新参数
    - echo '${PIPELINE_C}=ccc' >> GITEE_PARAMS