首页/开发/CI/CD 与发布速查/流水线变量分层
流水线设计54 条

流水线变量分层

变量来自多处(平台配置、作业级、触发时注入、下游传递),同名覆盖按优先级生效:合并规则必须在团队内说清。

CI/CD 与发布速查开发更新于 2026-10-12
来源项目/组/实例变量、作业级 variables、触发时覆盖、父管道传递
优先级以 GitLab《CI/CD variable precedence》与 GitHub 环境作用域定义为准
实践只在有必要处覆盖;敏感变量走受保护与掩码机制

GitLab 触发时覆盖

GitLab 触发时覆盖
deploy:
  variables:
    TARGET_ENV: staging
  script: ./ci/deploy.sh
调试时先打印变量来源与作用域,再排查「为什么生效的不是我以为的值」。

易错点

  • 同名变量多处定义:排查耗时集中在覆盖顺序上,减少层级是根本解法
  • 在脚本里加 set -x 打印逻辑:变量值可能被日志记录,敏感值依赖掩码兜底

数据来源与参考

  • GitLab Docs《CI/CD variable precedence》
  • GitHub Docs《Variables》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌