使用 Cloud Build 构建和推送 Docker 映像

使用 Cloud Build 构建和推送 Docker 映像

了解如何通过构建 Docker 映像并将映像推送到 Artifact Registry 来开始使用 Cloud Build。Artifact Registry 提供用于管理私有软件包和 Docker 容器映像的单个位置。

您首先使用 Docker 配置文件 Dockerfile 构建映像，然后使用 Cloud Build 配置文件构建相同的映像。

注意： 本快速入门介绍如何使用 Docker 构建映像，但 Cloud Build 支持大多数构建工具和编程语言。

---

如需遵循有关此任务的分步指导，请直接在 Cloud Shell Editor 中点击操作演示：

操作演示

---

准备工作

登录您的 Google Cloud 账号。如果您是 Google Cloud新手，请 创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Compute Engine and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

安装 Google Cloud CLI。

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Compute Engine and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

安装 Google Cloud CLI。

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

如果您之前已经安装了 Google Cloud CLI，请运行 gcloud components update 以确保您拥有最新版本。

1. 确保您在项目上拥有以下角色： Artifact Registry Administrator、Cloud Build Editor、Logs Viewer、Service Account User、Service Usage Admin、Storage Bucket Viewer、Storage Object Creator

   检查角色

   1. 在 Google Cloud 控制台中，前往 IAM 页面。

      转到 IAM
   2. 选择项目。

   3. 在主账号列中，找到标识您或您所属群组的所有行。如需了解您属于哪些群组，请与您的管理员联系。

   4. 对于指定或包含您的所有行，请检查角色列以查看角色列表是否包含所需的角色。

   授予角色

   1. 在 Google Cloud 控制台中，前往 IAM 页面。

      转到 IAM
   2. 选择项目。
   3. 点击 授予访问权限。

   4. 在新的主账号字段中，输入您的用户标识符。 这通常是 Google 账号的电子邮件地址。

   5. 点击选择角色，然后搜索相应角色。
   6. 如需授予其他角色，请点击 添加其他角色，然后添加其他各个角色。
   7. 点击 Save（保存）。

准备源文件以进行构建

您需要一些示例源代码来打包到容器映像中。在此部分，您将创建一个 shell 脚本和 Dockerfile。Dockerfile 是文本文档，其中有 Docker 如何构建映像的说明。

1. 打开一个终端窗口。

2. 创建名为 quickstart-docker 的新目录并导航至该目录：

   mkdir quickstart-docker
   cd quickstart-docker
   

3. 创建名为 quickstart.sh 且包含以下内容的文件：

   #!/bin/sh
   echo "Hello, world! The time is $(date)."

4. 创建名为 Dockerfile 且包含以下内容的文件：

   FROM alpine
   COPY quickstart.sh /
   CMD ["/quickstart.sh"]

5. 在终端窗口中运行以下命令，使 quickstart.sh 成为可执行文件：

   chmod +x quickstart.sh
   

在 Artifact Registry 中创建 Docker 代码库

1. 使用 gcloud artifacts repositories create 命令在位置 us-west2 中创建一个名为 quickstart-docker-repo 且说明文字为“Docker repository”（Docker 代码库）的 Docker 代码库：

   gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \
       --location=us-west2 --description="Docker repository"
   

2. 验证您的代码库已创建：

   gcloud artifacts repositories list
   

   显示的代码库列表应包含 quickstart-docker-repo。

   Artifact Registry 使用命名惯例来识别代码库和映像。例如，当您与存储在 us-west2 区域的 Artifact Registry 中的 Docker 映像进行交互时，您需要在命令中使用 us-west2-docker.pkg.dev 作为注册表主机名。

使用 Dockerfile 构建映像

使用 gcloud builds submit 命令，通过 Dockerfile 构建 Docker 映像。您不需要单独的 Cloud Build 配置文件。

1. 通过运行以下命令获取 Google Cloud 项目 ID：

   gcloud config get-value project
   

2. 从包含 quickstart.sh 和 Dockerfile 的目录运行以下命令：

   gcloud builds submit --region=us-west2 --tag us-west2-docker.pkg.dev/PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1
   

   注意： 如果您的项目 ID 包含英文冒号，请将其替换为正斜线。

   构建完成后，输出应类似于以下内容：

   DONE
   ------------------------------------------------------------------------------------------------------------------------------------
   ID                                    CREATE_TIME                DURATION  SOURCE   IMAGES     STATUS
   545cb89c-f7a4-4652-8f63-579ac974be2e  2020-11-05T18:16:04+00:00  16S       gs://gcb-docs-project_cloudbuild/source/1604600163.528729-b70741b0f2d0449d8635aa22893258fe.tgz  us-west2-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1  SUCCESS
   

您刚刚使用 Dockerfile 构建了一个名为 quickstart-image 的 Docker 映像，并将该映像推送到了 Artifact Registry。

使用 build 配置文件构建映像

在此部分，您将使用 Cloud Build 配置文件构建与上一步中构建的 Docker 映像相同的映像。构建配置文件会指示 Cloud Build 根据您的规范执行任务。

1. 在包含 quickstart.sh 和 Dockerfile 的同一目录中，创建名为 cloudbuild.yaml 且包含以下内容的文件。此文件是您的构建配置文件。构建时，Cloud Build 会自动将 $PROJECT_ID 替换为您的项目 ID。

   steps:
   - name: 'gcr.io/cloud-builders/docker'
     script: |
       docker build -t us-west2-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1 .
     automapSubstitutions: true
   images:
   - 'us-west2-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1'

2. 通过运行以下命令启动构建：

   gcloud builds submit --region=us-west2 --config cloudbuild.yaml
   

   构建完成后，输出应类似于以下内容：

    DONE
    ------------------------------------------------------------------------------------------------------------------------------------
    ID                                    CREATE_TIME                DURATION  SOURCE          IMAGES          STATUS
    046ddd31-3670-4771-9336-8919e7098b11  2020-11-05T18:24:02+00:00  15S       gs://gcb-docs-project_cloudbuild/source/1604600641.576884-8153be22c94d438aa86c78abf11403eb.tgz  us-west2-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1  SUCCESS
   

您刚刚使用构建配置文件构建了 quickstart-image 并将该映像推送到了 Artifact Registry。

查看构建详情

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

   打开 Cloud Build 页面

2. 如有必要，请选择您的项目，然后点击打开。

   您将看到构建记录页面：

   

3. 如有必要，请在区域下拉菜单中选择 us-west2 以查看该区域中的 build。

   系统会列出两个 build，分别对应您在本快速入门中执行的两个 build。

4. 点击其中一个 build。

   您将看到构建详情页面。

5. 如需查看构建的工件，请点击构建摘要下的构建工件。

   您将看到如下所示的输出：

   

   您可以从此页下载您的构建日志，并查看 Artifact Registry 中映像的详情。

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用，请按照以下步骤操作。

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

   打开 Artifact Registry 页面

2. 选择您的项目，然后点击打开。

3. 选择 quickstart-docker-repo。

4. 点击删除。

您现在已经删除了在此快速入门中创建的代码库。

后续步骤

• 了解如何运行 Docker 映像。
• 了解如何创建基本 build 配置文件。
• 了解如何使用 Cloud Build 进行部署。
• 了解如何构建 Node.js 应用。
• 了解如何构建 Java 应用。
• 了解如何构建 Go 应用。