Ubuntu配置git-remote-codecommit操作AWS CodeCommit克隆报错如何解决

常见根因及对应解决方案 #

• IAM身份权限配置问题
  确认联合身份对应的IAM角色/用户已附加AWSCodeCommitPowerUser权限策略，或自定义策略已包含codecommit:GitPull、codecommit:GitPush、codecommit:GetRepository等必要操作权限，同时需确认角色的信任策略允许当前使用的身份源进行角色调用。
• 本地AWS凭证配置异常
  执行cat ~/.aws/credentials、cat ~/.aws/config确认联合身份获取的临时凭证（AccessKeyId、SecretAccessKey、SessionToken）已正确写入对应配置文件。如果使用非default的自定义profile，可通过两种方式指定：
  • 克隆时直接携带profile：git clone codecommit::<AWS区域>://<profile名称>@<仓库名称>
  • 终端临时指定环境变量：export AWS_PROFILE=<你的profile名称>
• git-remote-codecommit路径未加入系统PATH
  先执行git-remote-codecommit --version验证工具是否可正常调用，如返回“命令不存在”，说明pip安装的用户级路径未加入PATH。Ubuntu环境下默认pip3安装路径为~/.local/bin，执行以下命令更新环境变量即可：

  echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc && source ~/.bashrc
  

• 克隆地址格式错误
  标准调用格式为git clone codecommit::<AWS区域>@<仓库名称>，如果仓库所属区域和你AWS配置的默认区域不一致，必须在地址中显式指定区域，例如北京区域仓库的克隆命令为：

  git clone codecommit::cn-north-1@demo-repo
  

• 全局Git凭证助手冲突
  如果之前配置过其他Git凭证助手，会和git-remote-codecommit的凭证逻辑冲突，执行以下命令清除全局凭证助手配置后重试：

  git config --global --unset credential.helper
  

快速定位方法 #

先执行AWS CLI命令验证权限和凭证有效性：

aws codecommit get-repository --repository-name <你的仓库名>

如果使用自定义profile，末尾加上--profile <你的profile名称>：

• 命令返回仓库正常信息：说明凭证、权限无问题，优先排查工具路径、克隆地址格式、Git配置冲突问题
• 命令报错：优先排查IAM权限、本地凭证配置问题

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