本页介绍了如何将 GitLab 主机连接到 Cloud Build。
准备工作
-
Enable the Cloud Build and Secret Manager APIs.
连接到 GitLab 主机
在为 GitLab 实例创建主机连接之前, 您必须完成以下步骤,在 GitLab 中创建个人访问令牌:
登录您的 GitLab Enterprise Edition 实例。
在实例的 GitLab Enterprise Edition 页面上,点击右上角的头像。
点击修改个人资料。
在左侧边栏中,选择访问令牌。
您会看到 Personal Access Tokens(个人访问令牌)页面。
创建具有
api
范围的访问令牌,用于与代码库建立连接和断开连接。创建具有
read_api
范围的访问令牌 以确保 Cloud Build 代码库可以访问代码库中的源代码。
控制台
如需将 GitLab 主机连接到 Cloud Build,请执行以下操作:
打开 Google Cloud 控制台中的制品库页面。
您会看到代码库页面。
在页面顶部,选择第 2 代标签页。
在顶部栏的项目选择器中,选择您的 Google Cloud 项目。
点击创建主机连接,将新主机连接到 Cloud Build。
在左侧面板中,选择 GitLab 作为源提供商。
在配置连接部分中,输入以下信息:
区域:为连接选择一个区域。
名称:输入连接的名称。
在主机详细信息部分,选择或输入以下内容 信息:
- GitLab 提供程序:选择 GitLab.com 作为提供程序。
在 Personal access tokens 部分中,输入以下信息:
API 访问令牌:输入具有
api
范围访问权限的令牌。这个 令牌用于与代码库建立连接和断开连接。读取 API 访问令牌:输入范围为
read_api
的令牌 访问权限。Cloud Build 触发器使用此令牌访问代码库中的源代码。
点击连接。
点击连接按钮后,您的个人访问令牌会安全地存储在 Secret Manager 中。已关注 Cloud Build 还会创建一个 webhook Secret 。您可以在以下位置查看和管理密钥: Secret Manager 页面。
您现在已成功创建 GitLab 关联。
gcloud
在将 GitLab 主机连接到 Cloud Build 之前, 完成以下步骤以存储您的凭据:
在 Secret Manager 中创建 Webhook Secret,方法是运行以下命令: 以下命令:
cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create my-gle-webhook-secret --data-file=-
如果您将 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,请执行以下操作:
输入以下命令以创建 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 关联。
后续步骤
- 了解如何关联 GitLab 代码库。
- 了解如何在 GitLab 流水线中使用 Google 管理的 CI/CD 组件构建工作负载并将其部署到 Google Cloud。请参阅 GitLab on Google Cloud。