GitLab流水线中通过Job创建新分支失败的排查求助

可能的问题及修复方案 #

1. 权限不足 #

GitLab CI流水线默认可能没有推送分支的权限：

• 进入项目设置→CI/CD→流水线权限，勾选「允许流水线推送到受保护分支」（若release是受保护分支）；
• 确认Runner使用的服务账号拥有仓库的写入权限。

2. Git远程仓库配置异常 #

你提到origin链接末尾带单引号，大概率是环境变量解析错误：

• 先在script中添加echo $CI_REPOSITORY_URL，检查变量是否自带多余引号；
• 重新配置remote解决解析问题：

  git remote remove origin
  git remote add origin $CI_REPOSITORY_URL
  

• 或者直接使用CI_JOB_TOKEN认证推送，绕开origin配置：

  git push https://gitlab-ci-token:${CI_JOB_TOKEN}@${CI_REPOSITORY_URL#*@} release
  

3. 分支名冲突 #

若仓库已存在release分支，git checkout -b release会失败，可先检查再创建：

git fetch origin
if ! git branch -a | grep -q "release"; then
  git checkout -b release
else
  git checkout release
  git pull origin release
fi

4. 原配置的无效项修正 #

你的.gitlab-ci.yml开头的- release是无效配置，需正确定义stages字段：

stages:
  - release

start:
  stage: release
  before_script:
    - git config --global user.name "${GITLAB_USER_NAME}"
    - git config --global user.email "${GITLAB_USER_EMAIL}"
  script:
    - git fetch origin
    - if ! git branch -a | grep -q "release"; then git checkout -b release; else git checkout release; fi
    - git push --set-upstream origin release

内容的提问来源于stack exchange，提问作者adi1992