关联到 GitHub 代码库

使用集合让一切井井有条

根据您的偏好保存内容并对其进行分类。

本页介绍了如何将 GitHub 代码库连接到 Cloud Build。如需详细了解 Cloud Build 仓库，请参阅 Cloud Build 仓库。

准备工作

连接 GitHub 主机

控制台

如需将 GitHub 代码库连接到 Cloud Build，请执行以下操作：

打开 Google Cloud 控制台中的制品库页面。

打开“代码库”页面

您将看到代码库页面。
在顶部栏的项目选择器中，选择您的 Google Cloud 项目。
在页面顶部，选择第 2 代标签页。
点击创建主机连接，将新主机连接到 Cloud Build。
在左侧面板中，选择 GitHub 作为来源提供方。
在配置连接部分中，输入以下信息：
1. 区域：为您的连接选择一个区域。
2. 名称：输入连接的名称。
点击连接。

点击连接按钮后，系统会要求您授权 Cloud Build GitHub 应用访问您的 GitHub 账号。您可以
通过从以下位置卸载或删除应用来撤消对该应用的访问权限：
托管您的域名托管服务商

Cloud Build is 请求对您的请求对您的 GitHub 用户账号进行授权
并将生成的授权令牌作为密钥存储在
Secret Manager。授权令牌用于验证您的用户账号是否有权安装 Cloud Build GitHub 应用以及访问关联的代码库。Cloud Build Service Agent 账号 (service-{projectNumber}@gcp-sa-cloudbuild.iam.gserviceaccount.com) 用于访问您的 Secret。如需查看您的密钥，请执行以下操作：
请参阅列出 Secret 和查看 Secret 详情。

注意：此身份验证可用于在同一项目中创建其他连接。我们建议使用机器人账号或由
您的团队，而不是使用个人 GitHub 账号来保持联系
安全。

向 Cloud Build GitHub 应用授权后，您将执行以下操作：
重定向到 Cloud Build 代码库
页面。

您现在已成功创建 GitHub 关联。

gcloud

如需使用 gcloud 连接您的 GitHub 主机，请执行以下操作：
请完成以下步骤：

输入以下命令以建立与 GitHub 代码库的连接 is 输入以下命令以建立与：
```
 gcloud build connection create github  --region=
```
其中：
- 是连接的名称。
- 是触发器的区域。
运行gcloud build connection 命令后，您将看到一个用于授权的链接
Cloud Build GitHub 应用
登录您的 github.com 账号。

注意：此身份验证可用于在同一项目中创建其他连接。为确保您的关联安全，我们建议您使用机器人账号或团队共享的账号，而不是个人 GitHub 账号。
点击相应链接，授权 Cloud Build GitHub 应用。

向应用授权后，Cloud Build 会存储身份验证信息
在 Google Cloud 的 Secret Manager 中将令牌作为 Secret
项目。您可以在 Secret Manager 页面上查看 Secret。
在您的账号或您拥有的组织中安装 Cloud Build GitHub 应用。

使用您的 GitHub 账号允许安装，并在出现提示时选择代码库权限。
运行以下命令，验证 GitHub 关联的安装情况：
```
 gcloud build connection describe  --region=
```
其中：
- 是连接的名称。
- 是触发器的区域。
如果 installationstate 字段设为 COMPLETE，则表示您已成功接通
安装了连接。否则，installationstate 字段会提供指向所需其他步骤的链接。

您现在已成功创建 GitHub 关联。

以程序化方式连接 GitHub 主机

terraform

您可以使用 Google terraform提供程序完成以下步骤，将 GitHub 主机连接到 Cloud Build：

安装 Cloud Build GitHub 应用
在您的 GitHub 账号或您拥有的组织中 is 安装。
创建个人访问令牌。

请务必将您的令牌设置为没有失效日期，并选择
在 GitHub 中出现提示时，包含以下权限：repo 和read : user。
如果您的应用安装在组织中，请务必也选择 read:org 权限。

生成个人访问令牌后，请将生成的令牌保存在安全的位置。您将在
。

注意：如果您在之前创建的连接的 secret 中存储了身份验证令牌，则可以将该 Secret 用于新连接。

在以下示例中，代码段将执行以下操作：

其中：

是您的 Google Cloud 项目编号。
是 Secret Manager 中令牌或 Secret 的 ID 。
是您在 GitHub 中的个人访问令牌的 ID。
是您的 Google Cloud 项目 ID。
是连接的区域。
是您的 GitHub 关联的名称。
是 Cloud Build GitHub 应用的安装 ID。您可以在 Cloud Build GitHub 应用的网址中找到安装 ID。在以下网址 https://github.com/settings/installations/1234567 中，安装 ID 是数值 1234567。

您现在已成功创建 GitHub 连接。

gcloud

使用现有令牌和安装 ID 连接 GitHub 主机
从之前的连接中获取的
请完成以下步骤：

注意：使用现有令牌和安装 ID 创建
无需通过
网络浏览器。

在您的 GitHub 账号或您拥有的组织中安装 Cloud Build GitHub 应用。
创建个人访问令牌。

请务必将令牌设置为无到期日期，并在 GitHub 中出现提示时选择以下权限：repo 和read : user。如果您的应用安装在组织中，请务必也选择 read:org 权限。

生成个人访问令牌后，请将生成的令牌保存在安全的位置。您将在
。

注意：如果您在之前创建的连接的 Secret 中存储了身份验证令牌，则可以对新连接使用该 Secret。
运行以下命令，将令牌存储在 Google Cloud 项目的 Secret Manager 中：
```
    echo -n  | gcloud secrets create  --data-file=-
```
其中：
- 是您的个人访问令牌。
- 是您要为
  Secret Manager 中的 Secret。

向 Cloud Build 服务代理授予对 Secret 的访问权限，其中是 Secret Manager 中存储的 Secret 的名称：

  PROJECT_ID=$(gcloud config list --format="value(core.project)")
  PN=$(gcloud projects describe $ {PROJECT_ID} --format="value(projectNumber)")
  cloud_build_service_agent="service-$ {PN}@gcp-sa-cloudbuild.iam.gserviceaccount.com"
  gcloud secrets add - iam - policy - bind  \ 
    --member="serviceAccount :$ {cloud_build_service_agent}" \ 
    --role="roles/secretmanager.secretAccessor"

创建 GitHub 连接：
```
  gcloud build connection create github  \
    --authorizer-token-secret-version=projects//secrets//versions/1  \
    --app-installation-i d= --region=
```
其中：
- 是连接的名称。
- 是您的 Google Cloud 项目 ID。
- 是存储在
  Secret Manager
- 是您的 GitHub 应用的安装 ID。您的
  您可以在 Cloud Build 网址中找到安装 ID 。
  GitHub 应用。在以下网址中，https://github.com/settings/installations/1234567：
  安装 ID is 是数值是数值1234567。
- 是您的连接所在的区域。

您现在已成功创建 GitHub 关联。

关联 GitHub 代码库

控制台

如需将 GitHub 代码库连接到主机连接，请完成以下步骤：

打开 Google Cloud 控制台中的制品库页面。

打开“代码库”页面

您将看到代码库页面。
在页面顶部，选择第 2 代标签页。
点击关联代码库，以通过您的连接关联代码库。

您将看到关联代码库面板。
在 Connect Repositories 面板中，输入以下信息：
1. 连接：从下拉菜单中选择一个连接。
2. 代码库：选择要关联到您的连接的代码库。
3. 代码库名称：输入代码库的名称。
  1. 已生成：选择此选项可让 Cloud Build 自动创建
    代表所选代码库生成的代码库名称
  2. 人工：选择此选项可手动为您的
    所选代码库
    
    如果选择人工，您可以修改
    代码库名称部分中选择的代码库。
点击关联，将您的代码库与您的连接相关联。

您现在已成功将 GitHub 代码库关联到您的关联。

gcloud

如需向关联中添加 GitHub 代码库，请输入以下命令：

   gcloud build repositories create  \
     --remote-uri= \
     --connection= --region=

其中：

是代码库的名称。
是指向您的 GitHub 代码库的链接。例如 https://github.com/cloud-build/test-repo.git。
是连接的名称。
是连接的区域。

您现在已将代码库关联到 GitHub 连接。

terraform

如需将 GitHub 代码库添加到您的连接，请添加以下内容
添加到 terraform配置中的代码段：

    resource "google_cloudbuildv2_repository" "my_repository" {
      project = " " 
      location = " " 
      name = " " 
      parent_connection = google_cloudbuildv2_connection.my_connection.name
      remote_uri = " " 
  }

其中：

是您的 Google Cloud 项目 ID。
是您的 GitHub 代码库的名称。
是连接的区域。
是代码库的主机 URI。例如 https://github.com/myuser/myrepo.git。

现在，您已将代码库关联到 GitHub 连接。

后续步骤

如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。

最后更新时间 (UTC)：2024-11-12。