GitLab Runner修改文件推送主分支遇权限错误求助

1. 先修复语法错误 #

你的配置里把git remote add命令拆成了两行，这会导致命令执行失败，正确写法必须把地址和命令放在同一行：

git remote add gitlab_origin https://oauth2:$project_token@gitlab.com/path-to-project.git

2. 确认令牌变量配置正确 #

• 去GitLab项目的Settings > CI/CD > Variables里，检查project_token变量是否存在，要勾选Protect variable（如果main分支是受保护分支）和Mask variable。
• 这个令牌必须是项目级访问令牌，创建路径是Settings > Access Tokens，一定要勾选write_repository权限，过期时间设个合理的期限。

3. 简化脚本逻辑（可选但更稳妥） #

没必要新增远程仓库地址，直接修改现有origin的认证信息就行，脚本可以改成这样：

stages:
  - build

write_logfile:
  stage: build
  script:
    - echo "This is a log message" > logfile.txt
    - git config user.email "my-email@example.com"
    - git config user.name "GitLab CI Runner"
    # 替换当前远程地址的认证信息
    - git remote set-url origin https://oauth2:$project_token@gitlab.com/path-to-project.git
    - git add logfile.txt
    - git commit -m "push back from pipeline"
    - git push origin HEAD:main -o ci.skip
  rules:
     - changes: 
       - 'Source/*'

4. 检查Runner权限 #

如果用的是共享Runner，确保它有访问你这个项目的权限；如果是私有Runner，确认注册令牌正确，且Runner处于活跃状态。

5. 更省心的替代方案：用内置CI_JOB_TOKEN #

GitLab自带CI_JOB_TOKEN，不用额外创建令牌，只要两步：

1. 进入项目Settings > Repository > Protected branches，找到main分支，在Allowed to push里添加gitlab-ci-token用户。
2. 修改脚本里的推送地址：

git remote set-url origin https://gitlab-ci-token:$CI_JOB_TOKEN@gitlab.com/path-to-project.git

这样直接用内置令牌，安全又省事。

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