此页面由 Cloud Translation API 翻译。

使用社区提供的构建器和自定义构建器

本页面介绍如何在 Cloud Build 中使用社区提供的构建器和自定义构建器。Cloud Build 开发者社区提供了可用于执行任务的开源构建器。如果您要执行的任务需要用到现有映像未提供的功能，则可以构建自己的自定义映像并在构建步骤中使用。如需了解不同类型的构建器，请参阅 Cloud Builder。

如果您是刚接触 Cloud Build，请先阅读快速入门和构建配置概览。

使用社区提供的构建器

社区提供的构建器没有可用的预构建的映像；要在 Cloud Build 配置文件中使用这些构建器，您必须先构建映像并将其推送到项目中的 Container Registry。

如需使用社区提供的构建器，请执行以下操作：

构建和推送构建器：
1. 导航到您的项目根目录。
2. 克隆 cloud-builders-community 代码库：
```
git clone https://github.com/GoogleCloudPlatform/cloud-builders-community.git
```
3. 导航到您要使用的构建器映像，其中builder-name 是包含构建器的目录：
```
cd cloud-builders-community/builder-name
```
4. 将构建器提交到您的项目：
```
gcloud builds submit .
```
5. 导航回您的项目根目录：
```
cd ../..
```
6. 从根目录中移除代码库：
```
rm -rf cloud-builders-community/
```

在 Cloud Build 配置文件中，在构建步骤中使用构建器：

YAML

steps:
- name: 'gcr.io/project-id/builder-name'
  args: ['arg1', 'arg2', ...]
...

JSON

{
  "steps": [
  {
    "name": "gcr.io/project-id/builder-name",
    "args": [
      "arg1",
      "arg2",
      ...
    ]
    ...
  }
  ]
}

使用构建配置文件手动启动构建或使用触发器启动构建。

有关如何使用社区提供的构建器的示例，请参阅部署到 Firebase 和使用 Packer 构建虚拟机映像。

创建自定义构建器

如果您要执行的任务需要用到公共映像、受支持的构建器或社区提供的构建器未提供的功能，则可以构建自己的映像并在构建步骤中使用。

下面提供了一些您何时需要使用自定义构建器映像的示例：

从外部位置下载源代码或程序包。
使用外部工具链。
缓存任何必要的库。
预构建源代码（Cloud Build 仅负责在可能的情况下将构建封装到映像中）

与其他任何构建器一样，自定义构建器与装载于 /workspace 下方的源一起运行，并与 /workspace 中的某个工作目录一起运行。由给定构建步骤保留在 /workspace 中的任何文件都可用于其他构建步骤。

自定义构建器可以推送到您的构建服务账号有权访问的 Container Registry（托管在 gcr.io/$PROJECT-NAME/ 上）中的代码库，也可以从该代码库中拉取自定义构建器。

以下步骤展示了如何使用示例 Dockerfile 创建和使用自定义构建器：

创建自定义构建器映像：
1. 为自定义构建器创建 Dockerfile。以下代码展示了一个示例 Dockerfile：
```
  FROM alpine
  RUN apk add curl
  CMD curl https://httpbin.org/ip -s > myip.txt; echo "*** My IP is: $(cat myip.txt)"
```
2. 构建自定义构建器并将其推送到项目中的 Container Registry，并替换 project-id 和 image-name 的值：
```
  gcloud builds submit --tag gcr.io/project-id/image-name
```

通过在构建步骤的 name 字段中指定构建器，可以在 Cloud Build 中使用自定义构建器映像：

YAML

    steps:
    - name: 'gcr.io/project-id/image-name'
      id: Determine IP of this build worker

JSON

    {
      "steps": [
      {
        "name": "gcr.io/project-id/image-name",
        "id": "Determine IP of this build worker"
      }
      ]
    }

使用构建配置文件手动启动构建或使用触发器启动构建。

使用社区提供的构建器和自定义构建器

使用社区提供的构建器

YAML

JSON

创建自定义构建器

YAML

JSON

后续步骤