连接到 Bitbucket Data Center 代码库

本页面介绍了如何将 Bitbucket 数据中心代码库连接到 Cloud Build。

准备工作

  • 启用 Cloud Build, Secret Manager, and Compute Engine API。

    启用 API

连接到 Bitbucket Data Center 代码库

控制台

如需使用 Google Cloud 控制台将 Bitbucket Data Center 代码库连接到 Cloud Build，请执行以下操作：

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

    打开“代码库”页面

  2. 在页面顶部，选择第 1 代标签页。

  3. 点击关联代码库。

  4. 选择 Bitbucket Data Center。

    您将看到关联代码库面板。完成以下步骤以连接 Bitbucket Data Center 代码库：

    1. 区域：选择您的连接所在的区域。

    2. 在选择源代码管理提供方下，选择 Bitbucket Data Center。

    3. 主机连接：从下拉菜单中选择主机连接的名称。

    4. 点击继续。

    5. 在选择代码库下，选择要连接到 Cloud Build 的 Bitbucket Data Center 代码库。

    6. 选择 Bitbucket Data Center 帐号和代码库后，请阅读意见征求免责声明，并选中旁边的复选框，以表明您接受所显示的条款。

    7. 点击关联以关联您的代码库。

  5. 点击完成。（可选）点击创建触发器以创建触发器。

API

如需使用 API 将 Bitbucket Data Center 代码库连接到 Cloud Build，请完成以下步骤：

  1. 使用以下内容创建 JSON 文件：

    {
  "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_DATA_CENTER_CONFIG_NAME",
  "requests": {
    "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_DATA_CENTER_CONFIG_NAME",
    "bitbucketServerConnectedRepository": {
      "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_DATA_CENTER_CONFIG_NAME",
      "repo": {
         "projectKey":"PROJECT_KEY",
         "repoSlug": "REPO_SLUG",
       }
     }
  }
}

    其中：

    • PROJECT_NUMBER 是您的 Cloud 项目的项目编号。
    • REGION 是与您的 Bitbucket 数据中心配置关联的区域。
    • BITBUCKET_DATA_CENTER_CONFIG_NAME 是 Bitbucket Data Center 配置的名称。
    • PROJECT_KEY 是您的 Bitbucket Data Center 项目的密钥。如果要连接个人代码库，您的项目密钥应在用户名前面包含波浪号 (~)。例如 ~${USERNAME}。主机代码库的完整网址类似于 https://${HOST_URI}/projects/~${USER_NAME}/repos/${REPO_SLUG}。
    • REPO_SLUG 是 Bitbucket 数据中心代码库的 Slug。

  2. 在终端中，从 JSON 文件所在的目录运行以下 curl 命令：

curl -X POST -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8" -H "x-goog-user-project: PROJECT_NUMBER" https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/bitbucketServerConfigs/BITBUCKET_DATA_CENTER_CONFIG_NAME/connectedRepositories:batchCreate -d @requests.json

其中：

  • PROJECT_NUMBER 是您的 Google Cloud 项目编号。
  • PROJECT_ID 是您的 Google Cloud 项目 ID。
  • REGION 是与您的 Bitbucket 数据中心配置关联的区域。
  • BITBUCKET_DATA_CENTER_CONFIG_NAME 是您的 Bitbucket Data Center 配置的名称。如果成功，响应正文将包含一个新创建的 Operation 实例。

  1. 在终端中运行以下 curl 命令：

    curl -X GET -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8"  -H "x-goog-user-project: PROJECT_NUMBER" https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID

    其中：

    • PROJECT_NUMBER 是您的 Google Cloud 项目编号。
    • PROJECT_ID 是您的 Google Cloud ID。
    • REGION 是与您的 Bitbucket 数据中心配置关联的区域。
    • OPERATION_ID 是 Bitbucket Data Center 配置创建操作的 ID。您可以在响应的 name 字段中找到操作 ID。响应中 name 字段的格式如下所示：projects/project-id/locations/region/operations/operation-id。

    您可能需要继续运行 GetOperation API 命令，直到响应包含 done: true（表示操作已完成）。如果 Bitbucket Data Center 代码库已成功连接，您可以在 response.bitbucketServerConnectedRepositories 字段中看到已连接的代码库。否则，请参阅 error 字段获取详细的错误报告。

连接代码库后，Cloud Build 会在 Bitbucket Data Center 实例的代码库上配置网络钩子。然后，当您对代码库进行更改时，代码库会发送 webhook，以调用相应的 Bitbucket Data Center 触发器。代码库还可以通过多个主机连接多次连接。如需了解如何管理网络钩子，请参阅管理网络钩子。

如需找到网络钩子，您需要获取网络钩子 ID。您可以在 BitbucketServerConfig 中找到每个连接的代码库的网络钩子 ID。

输入以下命令以检索网络钩子 ID：

gcloud alpha builds enterprise-config bitbucketserver describe CONFIG_NAME  --region=REGION

其中：

  • CONFIG_NAME 是 Bitbucket Data Center 配置的名称
  • REGION 是 Bitbucket Data Center 主机连接的区域

后续步骤