为何推送.gitlab-ci.yml文件后GitLab流水线未触发?
GitLab CI流水线无响应排查点
分支匹配规则不生效
你当前配置里指定了仅master分支触发流水线,首先确认远程仓库的实际主分支名称:
- 新版GitLab默认主分支为
main,如果你的仓库主分支不是master,规则会直接命中失败,流水线不会触发 - 可以临时修改分支匹配规则验证:
only: - master - main
CI配置文件本身异常
- 确认
.gitlab-ci.yml文件存放在仓库根目录,文件名完全匹配(开头的点不能省略,大小写完全一致) - 进入仓库「CI/CD」→「流水线」→「CI Lint」,把配置内容粘贴进去做语法校验,存在语法错误的配置不会触发流水线
- 确认该文件已经正常提交到远程
master分支,本地未提交、或者被.gitignore过滤都会导致远程没有生效配置
CI/CD功能或Runner异常
- 进入仓库「设置」→「CI/CD」→「通用管道设置」,确认CI/CD功能已启用,部分项目会默认关闭该功能
- 进入「设置」→「CI/CD」→「Runner」,确认项目有可用的Runner:要么开启了GitLab共享Runner,要么已经绑定了可用的私有Runner,离线/暂停状态的Runner无法运行流水线
- 检查当前提交账号是否有触发流水线的权限,部分仓库会设置CI操作权限白名单
内容的提问来源于stack exchange,提问作者Rainer Winkler
相关产品推荐
相关产品推荐

