运行构建配置

创建构建配置后，可以根据该构建配置提交运行。从控制台或使用 CLI 运行构建。

Code Engine 具有项目中的构建和构建运行配额。有关 Code Engine 限制的更多信息，请参阅 Code Engine。

自动删除已完成的构建运行。如果您的构建运行基于构建配置，且构建运行成功，则该构建运行将在三个小时后删除。如果构建运行不成功，则一周后删除该构建运行。

从控制台运行构建

转至 Code Engine 仪表板。
选择在其中创建构建的项目。
在项目页面中，单击 映像构建。
从 映像构建 选项卡中，选择要使用的映像构建的名称。
在配置部分中，可以查看构建配置和更改值 (如果需要)。
验证任何其他信息，例如此构建运行的 输出映像，或者覆盖超时值。
通过单击 提交构建来提交构建运行。

在 构建运行 部分中监视构建进度。

使用 CLI 对来自存储库 (非本地) 的源运行构建

要使用 CLI 从构建配置提交构建运行，请使用 buildrun submit 命令。此命令需要构建配置的名称。可以指定其他可选参数。有关选项的完整列表，请参阅 ibmcloud ce buildrun submit 命令。

以下示例运行名为 helloworld-build-run 的构建并使用 helloworld-build 构建。

ibmcloud ce buildrun submit --build helloworld-build --name helloworld-build-run

示例输出

Submitting build run 'helloworld-build-run'...
Run 'ibmcloud ce buildrun get -n helloworld-build-run' to check the build run status.
OK

下表概述了此示例中与 buildrun submit 命令配合使用的选项。有关该命令及其选项的更多信息，请参阅 ibmcloud ce buildrun submit 命令。

命令描述
选项	描述
`--build`	要使用的构建配置的名称。此值是必需的。
`--name`	构建运行的名称。使用在项目中唯一的名称。 -该名称必须以小写字母数字字符开头和结尾。 -该名称必须不超过 63 个字符，并且可以包含小写字母数字字符和连字符 (-)。

构建运行开始。使用 ibmcloud ce buildrun get 命令监视进度。

例如，要从先前示例中检查构建运行的状态，

ibmcloud ce buildrun get --name helloworld-build-run

示例输出

Getting build run 'helloworld-build-run'...
[...]
OK

Name:          helloworld-build-run
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           21m
Created:       2021-03-14T14:50:13-05:00

Summary:  Succeeded
Status:   Succeeded
Reason:   Succeeded

有关构建的更多信息，请查看故障诊断技巧。

使用 CLI 针对本地目录 (本地) 中的源运行构建

要使用从本地目录中拉取源的 CLI 从构建配置提交构建运行，请使用 buildrun submit 命令。此命令需要构建配置的名称以及本地源的路径。可以指定其他可选参数。有关选项的完整列表，请参阅 ibmcloud ce buildrun submit 命令。

以下方案将样本 IBM Cloud Code Engine GitHub 存储库克隆到本地工作站上的 CodeEngineLocalSample 目录中。

将样本 IBM Cloud Code Engine GitHub 存储库克隆到本地工作站上创建的子目录，例如 CodeEngineLocalSamples 子目录。在此目录中，运行 git clone 命令; 例如，
```
git clone https://github.com/IBM/CodeEngine
```
转至源代码在工作站上的目录。例如，转至 Code Engine 样本所在的 CodeEngine 子目录。

从源代码所在的目录中，提交构建运行。以下示例运行名为 buildrun-local-dockerfile 的构建，并使用 build-local-dockerfile 构建配置。 --source 选项指定本地工作站上的源到 helloworld 样本的路径。

ibmcloud ce buildrun submit --name buildrun-local-dockerfile --build build-local-dockerfile --source ./helloworld

示例输出

Getting build 'build-local-dockerfile'
Packaging files to upload from source path './helloworld' ...
Submitting build run 'buildrun-local-dockerfile'...
Run 'ibmcloud ce buildrun get -n buildrun-local-dockerfile' to check the build run status.
OK

使用 ibmcloud ce buildrun get 命令监视构建运行的进度。例如，要从先前示例中检查构建运行的状态，

ibmcloud ce buildrun get --name helloworld-build-run

示例输出

Getting build run 'buildrun-local-dockerfile'...
Run 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe ce buildrun events -n buildrun-local-dockerfile' to get the system events of the build run.
Run 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe ce buildrun logs -f -n buildrun-local-dockerfile' to follow the logs of the build run.
OK

Name:          buildrun-local-dockerfile
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           40s
Created:       2022-01-19T12:22:33-05:00

Summary:       Succeeded
Status:        Succeeded
Reason:        All Steps have completed executing
Source:
  Source Image Digest:  sha256:07159930b5abcf94e1a7451ea18490d4ad1162a77c2b987da5b7493fa1f1e49d
Image Digest:  sha256:04c7be7db438a41040ea24d646314f1c847c191d88fffdbea6f483fc443c2bbe

Build Name:    build-local-dockerfile
Source Image:  us.icr.io/mynamespace/codeengine-build-source
Image:         us.icr.io/mynamespace/codeengine-build
Timeout:       10m0s

提交从本地目录中提取代码的构建时，源代码将打包到归档文件中，并上载到 IBM Cloud Container Registry 实例。构建运行完成后，您可以在 IBM Cloud Container Registry 实例中查看已构建的映像，例如 codeengine-build。您还可以看到源映像，其中 -source 附加到构建的名称，例如 codeengine-build-source。您可以删除此源映像而不产生影响。

有关构建的更多信息，请查看故障诊断技巧。