如何在Google Cloud Build中克隆第二代Google Cloud代码库？

核心结论 #

第二代Google Cloud代码库（即关联外部GitHub/GitLab的新版Cloud Source Repositories）不支持gcloud source repos clone命令，这个命令仅适用于旧版GCP原生托管的代码库。

原因说明 #

• gcloud source repos list --project <my-project>默认只列出GCP原生托管的旧版代码库，要查看关联的外部仓库，需要加上--include-external参数：

  gcloud source repos list --project <my-project> --include-external
  

• 即使能看到关联的外部仓库，gcloud source repos clone也无法克隆，因为新版是关联而非托管外部仓库，GCP并没有存储仓库的完整代码副本（仅做镜像同步或关联索引），克隆操作需要直接对接原外部仓库。

Cloud Build中克隆关联仓库的正确方法 #

在Cloud Build构建流程中，直接使用标准git clone命令操作原外部仓库即可，前提是确保Cloud Build服务账号拥有访问该仓库的权限：

方法1：HTTPS方式（使用个人访问令牌PAT） #

如果是GitHub仓库，生成一个有仓库读取权限的PAT，然后在构建脚本中执行：

git clone https://<你的PAT>@github.com/<仓库所有者>/<仓库名>.git

方法2：SSH方式 #

1. 为Cloud Build服务账号生成SSH密钥对
2. 将公钥添加到外部仓库的权限设置中（比如GitHub的SSH keys）
3. 在构建脚本中执行：

git clone git@github.com/<仓库所有者>/<仓库名>.git

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