在专用池中运行构建

本文档介绍如何在专用池中运行构建。如果您是第一次使用专用池，请参阅专用池概览。

准备工作

  • 确保您已按照创建和管理专用池中的步骤创建专用池。

  • 如需使用本指南中的命令行示例，请安装并配置 Google Cloud CLI。

  • 您可以使用同一个 Google Cloud 项目来创建 使用专用池和 Cloud Build 构建 项目。如果您的 build 与您的专用项目分属不同的项目 请在 gcloud CLI 中将默认项目设置为 构建来源：

    gcloud config set project BUILD_ORIGIN_PROJECT_ID

IAM 权限

  • 如需通过 gcloud CLI 或 Cloud Build API 运行构建，请授予 向用户或服务授予专用池项目中的 WorkerPool User 角色 请求构建的账号。

  • 如需使用触发器运行自动构建，请执行以下操作：

    • 如果要启动构建的项目就是您的专用池所在的项目，则您无需授予任何权限。

    • 如果您启动构建的项目不同于 如果有，请将 WorkerPool User 角色分配给您在 创建构建的工作器池项目：

    控制台

    1. 在 Google Cloud 控制台中打开 IAM 页面。

      打开“IAM 权限”页面

    2. 在页面顶部的项目选择器下拉菜单中，选择包含您的专用池的项目。

    3. 点击授予访问权限。

    4. 输入以下主账号和角色设置：

      • 添加主账号：输入您要为其创建访问权限的服务账号的电子邮件地址 您使用的触发器数量。

      • 分配角色：选择 Cloud Build WorkerPool User 角色。

    5. 点击保存以保存新的 IAM 权限。

    gcloud

    从触发器添加默认的 Cloud Build 服务账号 项目导出到具有 cloudbuild.workerPoolUser 角色的工作器池项目：

      gcloud projects add-iam-policy-binding PRIVATEPOOL_PROJECT_ID \
      --member=serviceAccount:SERVICE_ACCOUNT \
      --role=roles/cloudbuild.workerPoolUser

    将上述命令中的占位值替换为以下内容：

    • PRIVATEPOOL_PROJECT_ID 是运行构建的专用池的项目 ID。
    • SERVICE_ACCOUNT 是服务的电子邮件地址 您用于执行构建的触发器所使用的账号。

运行构建

您可以在创建 或来自其他 Google Cloud 项目。您可以在构建配置文件中指定专用池，也可以在 gcloud 命令中直接指定：

在构建配置文件中指定专用池：

  1. 在 Cloud Build 配置文件中，添加 pool 选项并指定用于运行构建的专用池的完整资源名称：

    YAML

    steps:
- name: 'bash'
  args: ['echo', 'I am running in a private pool!']
options:
  pool:
    name: 'projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID'

    JSON

    {
  "steps": [
  {
    "name": "bash",
    "args": [
      "echo",
      "I am running in a private pool!"
    ]
  }
  ],
  "options": {
    "pool" : {
      "name" : "projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID"
    }
  }
}

    将上述配置文件中的占位符值替换为以下内容：

    • PRIVATEPOOL_PROJECT_ID：您的 Google Cloud Storage 存储分区 专用池的 IP 地址
    • REGION：创建了专用池的区域。
    • PRIVATEPOOL_ID：您在创建专用池时指定的唯一专用池 ID。

  2. 使用上面创建的构建配置文件通过 gcloud 或 API 或使用触发器运行构建。 如果您的实例托管在本地，则 Cloud Build 还会为多个外部源代码管理系统（例如 GitHub Enterprise 或 Bitbucket Server）提供触发器功能支持。

在 gcloud 命令中指定专用池：

您可以在 gcloud 命令（而不是构建配置文件）中指定专用池。例如，假设您有以下构建配置文件：

YAML

  steps:
  - name: 'bash'
    args: ['echo', 'I am running in a private pool!']

JSON

  {
    "steps": [
    {
      "name": "bash",
      "args": [
        "echo",
        "I am running in a private pool!"
      ]
    }
    ],
  }

以下命令使用构建配置文件进行构建，并在该命令中指定工作器池：

gcloud builds submit --config=CONFIG_FILE
  --worker-pool=projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID

将上述命令中的占位值替换为以下内容：

  • CONFIG_FILE：构建配置文件的路径。
  • PRIVATEPOOL_ID：您在创建专用池时指定的唯一专用池 ID。
  • PRIVATEPOOL_PROJECT_ID：您的 Google Cloud Storage 存储分区 专用池的 IP 地址
  • REGION：创建了专用池的区域。

后续步骤