GitLab CI/CD变量APPSETTINGS无法传递至流水线作业脚本排查

问题根源分析 #

你的问题出在变量的环境范围关联和受保护变量的分支限制两个核心点：

1. 环境范围不匹配
   APPSETTINGS变量的环境范围设置为staging，但pre-deploy_job作业未关联该环境。GitLab仅会将对应环境范围的变量注入到明确指定environment字段的作业中，你的pre-deploy_job缺少该配置，导致变量无法被注入。

2. 受保护变量的分支验证
   你开启了Protect variable标识，这类变量仅会注入到受保护分支上运行的作业。需确认master和dev分支是否被标记为GitLab项目的受保护分支。

解决方案 #

1. 为pre-deploy_job关联staging环境 #

修改.gitlab-ci.yml中的pre-deploy_job配置，添加environment字段：

pre-deploy_job:
  image: docker:stable
  services:
    - docker:dind
  stage: pre-deploy
  only:
    - master
    - dev
  environment:  # 添加该字段关联staging环境
    name: staging
  before_script:
    - docker login ${CI_REGISTRY} -u ${CI_REGISTRY_USER} -p ${CI_REGISTRY_PASSWORD}
    - echo "APPSETTINGS in job: $APPSETTINGS"  # 新增该行，验证变量是否注入成功
  script:
    - docker build -t ${CI_REGISTRY}/${CI_PROJECT_PATH}:latest --build-arg APPSETTINGS=${APPSETTINGS} --no-cache .
    - docker push ${CI_REGISTRY}/${CI_PROJECT_PATH}:latest
  after_script:
    - docker logout ${CI_REGISTRY}

2. 验证受保护分支配置 #

进入GitLab项目的设置 > 仓库 > 受保护分支，确认master和dev分支已被标记为受保护分支。如果未标记，点击"保护分支"按钮添加这两个分支。

3. Dockerfile容错优化（可选） #

为避免变量为空时cp命令报错，可在Dockerfile中添加默认值处理：

RUN cp -f "${APPSETTINGS:-./default-appsettings.json}" /app/build/appsettings.json

（需提前在项目根目录准备default-appsettings.json作为兜底文件）

验证步骤 #

1. 提交修改后的.gitlab-ci.yml到对应分支
2. 触发流水线，查看pre-deploy_job中的echo "APPSETTINGS in job: $APPSETTINGS"输出，确认变量已被注入
3. 查看Docker构建阶段的echo $APPSETTINGS输出，确认参数已传递到Dockerfile

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