GitLab流水线全局变量跨文件赋值失效问题求助

核心规则说明 #

GitLab CI 中不存在自动全局共享的"中央变量文件"，变量的复用需要遵循以下规则：

• 单独YAML文件中的变量需通过include导入到目标配置文件才能生效
• 动态计算的变量无法直接在变量文件中赋值，必须通过作业间的 artifacts 传递

方案1：动态变量跨作业传递（适配你的场景） #

1. 定义基础变量模板文件 #

创建gitlabfiles/variables.yml，仅声明变量名（可设默认值）：

variables:
  TAG_VERSION: ""
  SAP_COMMIT_HASH: ""

2. 在赋值作业中导出变量 #

编辑gitlabfiles/.gitlab-extract-tag-values.yml，导入变量文件并通过dotenv artifacts传递计算结果：

include:
  - local: gitlabfiles/variables.yml

extract-tag-values:
  stage: prepare
  script:
    # 示例：动态计算变量值
    - TAG_VERSION=$(git describe --tags)
    - SAP_COMMIT_HASH=$(git rev-parse HEAD:sap/)
    # 将变量写入dotenv文件
    - echo "TAG_VERSION=$TAG_VERSION" >> variables.env
    - echo "SAP_COMMIT_HASH=$SAP_COMMIT_HASH" >> variables.env
  artifacts:
    reports:
      dotenv: variables.env

3. 在引用作业中获取变量 #

编辑gitlabfiles/.gitlab-merge-sap-into-dev.yml，导入变量文件并依赖赋值作业：

include:
  - local: gitlabfiles/variables.yml

merge-sap-into-dev:
  stage: merge
  # 通过needs依赖赋值作业，自动获取dotenv中的变量
  needs: ["extract-tag-values"]
  script:
    - echo "TAG_VERSION: $TAG_VERSION"
    - echo "SAP_COMMIT_HASH: $SAP_COMMIT_HASH"
    # 执行你的合并逻辑

方案2：静态全局变量（固定值场景） #

如果变量是固定值，无需动态计算，直接在GitLab项目设置中配置：

1. 进入项目 Settings > CI/CD > Variables
2. 添加所需变量（可设置保护/掩码），所有CI作业可直接引用这些变量

常见误区 #

• 不要认为变量文件定义后会自动全局生效，必须通过include导入到每个需要使用的配置文件
• 动态变量无法在变量文件中直接赋值，GitLab CI 在作业启动前已解析静态变量，动态计算的值必须通过dotenv artifacts传递

内容的提问来源于stack exchange，提问作者Casey Harrils