GitLab CI rules 未按预期在feature/test分支触发作业
GitLab CI配置异常原因及修正方案
配置异常的核心原因是预定义内置变量拼写错误,导致规则判断无法匹配真实分支信息,具体问题拆解如下:
- GitLab 13.8版本中,用来标识当前流水线所属分支的预定义内置变量为
CI_COMMIT_BRANCH,不存在名为GIT_COMMIT_BRANCH的内置变量。所有引用$GIT_COMMIT_BRANCH的规则判断,实际读取到的是空值,无法匹配真实的分支名,对应作业的触发条件自然无法满足。
各作业的实际运行逻辑和预期偏差如下:All Branches except master/dev作业
第一条规则使用了正确的$CI_COMMIT_BRANCH变量,可正确识别默认分支并跳过;第二条排除dev开头分支的规则错用了不存在的$GIT_COMMIT_BRANCH,导致该排除逻辑实际失效。但因为规则末尾设置了when: always的兜底触发逻辑,所以只要不是默认分支,这个作业就会被触发,和你观察到的运行现象完全一致。Only Branch Regex作业
规则中错用$GIT_COMMIT_BRANCH做正则匹配,判断时实际执行的是空字符串匹配/^feature.*/的逻辑,永远不满足匹配条件,因此作业不会触发。Only Branch Specific作业
规则中错用$GIT_COMMIT_BRANCH做等值判断,判断时实际执行的是空字符串等于"feature/test"的逻辑,永远不成立,因此作业不会触发。
修正后配置
将所有错写的GIT_COMMIT_BRANCH替换为正确的CI_COMMIT_BRANCH即可,修正后内容如下:
stages: - pre-build - build - post-build - test - publish - deploy All Branches except master/dev: stage: build image: openjdk:16-slim script: - 'cd .tools' rules: - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH' when: never - if: '$CI_COMMIT_BRANCH =~ /^dev.*/' when: never - when: always Only Branch Regex: stage: build image: openjdk:16-slim script: - 'cd .tools' rules: - if: '$CI_COMMIT_BRANCH =~ /^feature.*/' Only Branch Specific: stage: build image: openjdk:16-slim script: - 'cd .tools' rules: - if: '$CI_COMMIT_BRANCH == "feature/test"'
修正完成后,在feature/test分支下三个build阶段的作业都会按预期触发,同时All Branches except master/dev作业的dev分支排除逻辑也会恢复正常生效。
内容的提问来源于stack exchange,提问作者Kenneth Gunnerud
相关产品推荐
相关产品推荐

