GitLab特性分支CI/CD无法读取配置变量的解决方法

1. 检查变量的分支可见性配置 #

• 进入项目的「Settings」→「CI/CD」→「Variables」，找到AWS_ACCOUNT_ID、SERVER_IP等目标变量：
  • 取消勾选Protected（若你的特性分支不属于受保护分支）；
  • 将Environment scope设置为*（覆盖所有分支），或直接指定特性分支名称；
  • 注意：Masked仅用于隐藏输出，不影响变量的可用性，无需修改此项。

2. 删除.gitlab-ci.yml中重复定义的变量 #

你的variables块存在递归引用自身的配置（如AWS_DEFAULT_REGION: $AWS_DEFAULT_REGION），这会导致GitLab将变量重置为空，直接覆盖配置页面的变量值。修改后的variables块如下：

variables:
    IMAGE_NAME: $AWS_ACCOUNT_ID.dkr.ecr.$AWS_DEFAULT_REGION.amazonaws.com/juice-shop
    DOCKER_PASS: $CI_COMMIT_SHA
    IMAGE_TAG: juice-shop-1.1
    SERVER_USER: ubuntu

所有从配置页面读取的变量无需在variables块中重复定义，GitLab会自动注入这些变量。

3. 添加调试步骤验证变量注入 #

在任意CI任务中添加输出变量的脚本，确认变量是否被正确读取：
例如修改create_cache任务的script部分：

script:
    - echo "AWS_ACCOUNT_ID: $AWS_ACCOUNT_ID"
    - echo "SERVER_IP: $SERVER_IP"
    - yarn install

• 敏感变量（如AWS_SECRET_ACCESS_KEY）会被GitLab自动屏蔽为****，但可通过此方式确认变量是否存在；
• 若输出为空，说明变量未被注入，需回到第一步重新检查可见性配置。

4. 检查Shell Runner的环境冲突 #

由于你使用的是shell类型的runner，需确认runner所在的EC2机器未定义同名环境变量，避免覆盖GitLab注入的变量。可在任务中添加env命令查看所有环境变量：

script:
    - env | grep -E "AWS_|SERVER_"
    - yarn install

5. 确认特性分支的CI/CD开关未被禁用 #

进入项目的「Settings」→「CI/CD」→「General pipelines」：

• 确保「Auto DevOps for branches」处于开启状态；
• 检查「CI/CD rules」是否存在针对特性分支的禁用规则。

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