连接到 GitLab 主机

本页介绍了如何将 GitLab 主机连接到 Cloud Build。

准备工作

  • Enable the Cloud Build and Secret Manager APIs.

    Enable the APIs

连接到 GitLab 主机

在为 GitLab 实例创建主机连接之前， 您必须完成以下步骤，在 GitLab 中创建个人访问令牌：

  1. 登录您的 GitLab Enterprise Edition 实例。

  2. 在实例的 GitLab Enterprise Edition 页面上，点击右上角的头像。

  3. 点击修改个人资料。

  4. 在左侧边栏中，选择访问令牌。

    您会看到 Personal Access Tokens（个人访问令牌）页面。

  5. 创建具有 api 范围的访问令牌，用于与代码库建立连接和断开连接。

  6. 创建具有 read_api 范围的访问令牌 以确保 Cloud Build 代码库可以访问代码库中的源代码。

控制台

如需将 GitLab 主机连接到 Cloud Build，请执行以下操作：

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

    打开“代码库”页面

    您会看到代码库页面。

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

  3. 在顶部栏的项目选择器中，选择您的 Google Cloud 项目。

  4. 点击创建主机连接，将新主机连接到 Cloud Build。

  5. 在左侧面板中，选择 GitLab 作为源提供商。

  6. 在配置连接部分中，输入以下信息：

    1. 区域：为连接选择一个区域。

    2. 名称：输入连接的名称。

  7. 在主机详细信息部分，选择或输入以下内容 信息：

    1. GitLab 提供程序：选择 GitLab.com 作为提供程序。

  8. 在 Personal access tokens 部分中，输入以下信息：

    1. API 访问令牌：输入具有 api 范围访问权限的令牌。这个 令牌用于与代码库建立连接和断开连接。

    2. 读取 API 访问令牌：输入范围为 read_api 的令牌 访问权限。Cloud Build 触发器使用此令牌访问代码库中的源代码。

  9. 点击连接。

    点击连接按钮后，您的个人访问令牌会安全地存储在 Secret Manager 中。已关注 Cloud Build 还会创建一个 webhook Secret 。您可以在以下位置查看和管理密钥： Secret Manager 页面。

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

gcloud

在将 GitLab 主机连接到 Cloud Build 之前， 完成以下步骤以存储您的凭据：

  1. 将令牌存储在 Secret Manager 中。

  2. 在 Secret Manager 中创建 Webhook Secret，方法是运行以下命令： 以下命令：

     cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create my-gle-webhook-secret --data-file=-

  3. 如果您将 Secret 存储在与您计划用于创建主机连接的 Google Cloud 项目不同的项目中，请输入以下命令，以向您的项目授予对 Cloud Build 服务代理的访问权限：

    PN=$(gcloud projects describe PROJECT_ID --format="value(projectNumber)")
CLOUD_BUILD_SERVICE_AGENT="service-${PN}@gcp-sa-cloudbuild.iam.gserviceaccount.com"
gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:${CLOUD_BUILD_SERVICE_AGENT}" \
  --role="roles/secretmanager.admin"

    其中：

    • PROJECT_ID 是您的 Google Cloud 项目 ID。

您现在可以继续将您的 GitLab 主机连接到 Cloud Build

请完成以下步骤：

如需将 GitLab 主机连接到 Cloud Build，请执行以下操作：

  1. 输入以下命令以创建 GitLab 连接：

    gcloud builds connections create gitlab CONNECTION_NAME \
  --host-uri=HOST_URI \
  --project=PROJECT_ID \
  --region=REGION \
  --authorizer-token-secret-version=projects/PROJECT_ID/secrets/API_TOKEN/versions/SECRET_VERSION \
  --read-authorizer-token-secret-version=projects/PROJECT_ID/secrets/READ_TOKEN/versions/SECRET_VERSION \
  --webhook-secret-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET/versions/SECRET_VERSION

    其中：

    • CONNECTION_NAME 是连接的名称。
    • HOST_URI 是您的 GitLab 实例的 URI。例如 https://my-gle-server.net。
    • PROJECT_ID 是您的 Google Cloud 项目 ID。
    • REGION 是您的连接的区域。
    • API_TOKEN 是包含 api 范围的令牌的名称。
    • READ_TOKEN 是具有 read_api 范围的令牌的名称。
    • SECRET_VERSION 是您的 Secret 的版本。
    • WEBHOOK_SECRET 是您的 Webhook Secret。

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

后续步骤