首页/开发/CI/CD 与发布速查/GitLab 受保护分支与保护变量
工具链要点63 条

GitLab 受保护分支与保护变量

受保护分支/标签限制推送与合并权限;标记为 protected 的变量只在受保护上下文(如受保护分支流水线)可用,用于把发布凭据留给受控流程。

CI/CD 与发布速查开发更新于 2026-10-12
保护对象分支、标签
变量联动protected 变量仅在受保护分支/标签的流水线上展开
权限按角色控制谁能推送与合并
配合受保护环境 + 审批

使用受保护变量

使用受保护变量
deploy-prod:
  stage: deploy
  script: [./deploy.sh prod]
  environment: production
  rules:
    - if: '$CI_COMMIT_BRANCH == "main"'
MR 流水线不在受保护分支上下文:依赖保护变量的发布作业要以分支流水线形态设计。

易错点

  • 发布作业依赖保护变量却安排在 MR 流水线:变量为空导致失败
  • 保护规则过宽:直接把主干推送权限放开给所有人,保护形同虚设

数据来源与参考

  • GitLab Docs《Protected branches》
  • GitLab Docs《Protected variables》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌