镜像 GitHub 代码库

本主题介绍如何将 GitHub 代码库镜像到 Cloud Source Repositories。 使用此配置，您推送到 GitHub 代码库的提交内容将被复制（或称 镜像）到托管在 Cloud Source Repositories 中的代码库中。

只有 Bitbucket Cloud 和 GitHub Cloud 代码库可以镜像到 Cloud Source Repositories；不支持自托管的 Bitbucket 和 GitHub 镜像。

如果您要将 GitHub 代码库镜像到 Cloud Source Repositories 以与 Cloud Build 集成，并且不需要任何其他 Cloud Source Repositories 功能，请改为按照从 GitHub 构建代码库中的 Cloud Build 说明进行操作。

准备工作

镜像代码库时，您必须提供 GitHub 身份验证凭据。这些凭证使 Cloud Source Repositories 可以访问 GitHub 代码库的内容。

如果您使用的是 GitHub 组织，我们建议您使用专门用于自动化任务（例如镜像代码库）的 机器用户账号。此账号必须拥有代码库的管理员权限。

镜像 GitHub 代码库

本部分显示如何将 GitHub 代码库镜像到 Cloud Source Repositories。

创建镜像代码库

在此过程中，您需要 GitHub 机器用户凭据才能向 Google Cloud 授予对 GitHub 代码库的读取访问权限。

  1. 在 Google Cloud 控制台中，打开 Cloud Source Repositories。

    打开 Cloud Source Repositories

  2. 点击 添加代码库。

    将打开 添加代码库 页面。

  3. 选择 连接外部代码库，然后点击 继续。

    连接外部代码库 页面打开。

  4. 在 Project 下拉列表中，选择镜像代码库所属的 Google Cloud 项目。

    如果您没有项目，则可以点击 创建项目 以 创建项目。

  5. 在 Git 提供者 下拉列表中，选择 GitHub。

  6. 选中复选框以授权 Cloud Source Repositories 存储您的凭据。

  7. 点击连接到 GitHub。

  8. 使用您的机器用户凭据登录 GitHub。

  9. 点击 Authorize GoogleCloudPlatform。

    此选项授予 Google Cloud 对 GitHub 用户账号中所有代码库的读取权限。

    授权完成后，您将返回到 连接外部代码库 页面。此时将会打开代码库的列表。

  10. 从代码库列表中，选择要镜像的代码库。

  11. 点击关联选定的代码库。

    打开主代码库页面。此页面包含此 Google Cloud 项目的代码库列表，包括您刚刚创建的新代码库。

识别 GitHub 代码库

Cloud Source Repositories 清楚地表明您的哪些代码库是 GitHub 代码库的镜像：

  • 每个 GitHub 代码库都使用 GitHub 徽标表示。
  • 代码库的名称已在其名称的开头添加了github_。

强制代码库同步

设置镜像后，当用户提交更改时，Cloud Source Repositories 会自动将您的代码库与镜像的代码库同步。利用 Cloud Source Repositories 可查看上一次的镜像代码库同步，并在需要时手动强制执行同步。

  1. 在 GCP Console 中，浏览到镜像的 GitHub 代码库。

  2. 点击 设置 。

    显示同步状态。

    镜像代码库同步状态

  3. 要手动强制代码库同步，请点击 从 GitHub 同步。