如何在GitLab CI流水线失败时阻止代码推送？
2026-5-20
如何在GitLab CI流水线失败时阻止代码推送到仓库
当然有办法！要实现这个需求，核心是利用GitLab的分支保护功能——这正是你需要的直接推送场景下的限制手段，和合并请求中的检查逻辑原理一致。
具体操作步骤：
- 进入你的GitLab项目，点击顶部菜单栏的
Settings->Repository，找到Protected branches区域。 - 选择你想要保护的分支（比如
main或master），点击Protect按钮进入分支保护设置。 - 在设置页面中，找到 "Pipeline must succeed" 选项并勾选它。
这样配置后，当有人直接向这个受保护的分支推送代码时：
- GitLab会自动触发你现有的CI流水线（包含lint和test任务）
- 如果流水线中任何一个任务失败，推送操作会被直接拒绝，代码不会被合并到仓库中。
针对你提供的CI配置补充说明：
你当前的 .gitlab-ci.yml 已经包含了lint和test两个阶段的任务，完全可以配合分支保护功能使用——只要流水线中任一阶段任务失败，推送就会被拦截，完美符合你的需求。
额外注意事项：
- 确保推送代码的用户/令牌拥有推送受保护分支的权限，但即便有权限，流水线失败时依然会被阻止。
- 如果需要保护多个分支，可以重复上述步骤为每个分支开启相同的规则。
内容的提问来源于stack exchange，提问作者Simon Bruneaud
相关产品推荐
相关产品推荐
