GitLab结合部署密钥与API向受保护分支提交代码的问题

是否可行？ #

可行，但你当前的API调用方式不符合分支保护规则的权限要求，所以被拦截了。

问题根源 #

你用个人访问令牌（PRIVATE-TOKEN）调用GitLab API，API请求的身份是该令牌关联的用户，而你的master分支保护规则只允许部署密钥推送代码，两者身份不匹配，因此提示cannot push to that branch。

不取消分支保护的解决方案 #

方案1：给令牌关联用户添加受保护分支推送权限

如果想继续用API方式操作，可以给个人访问令牌所属的用户开通master分支的推送权限：

• 进入项目的 Settings → Repository → Protected Branches
• 找到master分支的配置项，展开「Allowed to push」
• 添加令牌对应的用户（或用户组）到允许列表，保存设置
• 之后再执行你原来的API命令即可成功，注意确保令牌只授予write_repository这类最小必要权限

方案2：用部署密钥通过Git命令直接更新子模块

如果要严格遵循「仅允许部署密钥推送」的规则，直接用Git命令结合部署密钥操作即可：

1. 用部署密钥克隆主仓库：

   GIT_SSH_COMMAND="ssh -i ~/.ssh/id_deploy" git clone git@gitlab.example.com:你的项目路径.git
   

2. 进入仓库目录，更新子模块到指定commit：

   cd 仓库目录名
   # 切换到子模块目录并检出目标commit
   cd sub
   git checkout 3ddec28ea23acc5caa5d8331a6ecb2a65fc03e88
   cd ..
   

3. 提交子模块更新并推送到master：

   git add sub
   git commit -m "Update submodule reference"
   GIT_SSH_COMMAND="ssh -i ~/.ssh/id_deploy" git push origin master
   

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