GitLab UI设置的环境变量无法传递至子流水线求助

问题说明 #

父流水线中，全局声明的ENVIRONMENT变量可正常传递给子流水线，但通过GitLab UI设置的受保护未掩码变量SOME_OTHER_ENV_VARIABLES_PASSED_THROUGH_UI无法传递，子流水线无对应输出。即使在父流水线deploy任务中显式声明该变量，问题仍未解决。

配置示例 #

parent.yml

variables:
  ENVIRONMENT:
    value: dev
    options:
      - "dev"
      - "staging"
      - "prod"

stages: 
  - child
  
deploy:
  stage: child
  trigger:
    include: child_dir/child-pipeline.yml

child_dir/child-pipeline.yml

before_script:
  - echo "$ENVIRONMENT"
  - echo "$SOME_OTHER_ENV_VARIABLES_PASSED_THROUGH_UI"

尝试过的无效修改：

deploy:
  stage: child
  variables:
    SOME_OTHER_ENV_VARIABLES_PASSED_THROUGH_UI: $SOME_OTHER_ENV_VARIABLES_PASSED_THROUGH_UI
  trigger:
    include: child_dir/child-pipeline.yml

解决方案 #

1. 检查受保护变量的分支匹配条件 #

GitLab受保护变量仅会传递给受保护分支/标签上运行的流水线，需确认：

• 父流水线运行的分支/标签处于受保护状态
• 子流水线触发对应的分支也满足受保护要求（若子流水线使用不同分支）

2. 显式开启变量继承 #

在触发子流水线的配置中添加inherit: variables: true，确保子流水线继承父流水线的所有变量（包括UI设置的受保护变量）：

deploy:
  stage: child
  trigger:
    include: child_dir/child-pipeline.yml
    inherit:
      variables: true

3. 检查UI变量的"传递给子流水线"设置 #

进入项目设置→CI/CD→变量，编辑目标变量时，确认勾选了**"传递给子流水线"**选项（默认开启，若手动关闭则无法传递）。

4. 显式传递时使用变量插值 #

若上述方法无效，可在父流水线任务中显式引用变量，确保父流水线能正确读取后传递：

deploy:
  stage: child
  variables:
    SOME_OTHER_ENV_VARIABLES_PASSED_THROUGH_UI: "${SOME_OTHER_ENV_VARIABLES_PASSED_THROUGH_UI}"
  trigger:
    include: child_dir/child-pipeline.yml

验证步骤 #

1. 确认父流水线运行在受保护分支上
2. 检查UI变量的"传递给子流水线"选项状态
3. 添加inherit: variables: true到触发配置
4. 重新运行父流水线，查看子流水线输出

内容的提问来源于stack exchange，提问作者Flakron Rexhepaj