第 7 章 执行基本构建

以下小节提供了基本构建操作的说明,包括启动和取消构建、删除 BuildConfig、查看构建详情,以及访问构建日志。

7.1. 启动构建

您可以从当前项目中的现有构建配置手动启动新构建。

流程

要手动启动构建,请运行:

$ oc start-build <buildconfig_name>

7.1.1. 重新运行构建

您可以使用 --from-build 标志,手动重新运行构建。

流程

要手动重新运行构建,请运行:

$ oc start-build --from-build=<build_name>

7.1.2. 流传输构建日志

您可以指定 --follow 标志,在标准输出中流传输构建日志。

流程

要在标准输出中手动流传输构建日志,请运行:

$ oc start-build <buildconfig_name> --follow

7.1.3. 在启动构建时设置环境变量

您可以指定 --env 标志,为构建设置任何所需的环境变量。

流程

要指定所需的环境变量,请运行:

$ oc start-build <buildconfig_name> --env=<key>=<value>

7.1.4. 使用源启动构建

您可以通过直接推送源来启动构建,而不依赖于 Git 源拉取或构建的 Dockerfile;源可以是 Git 或 SVN 工作目录的内容、您想要部署的一组预构建二进制工件,或者单个文件。这可以通过为 start-build 命令指定以下选项之一来完成:

选项描述

--from-dir=<directory>

指定将要存档并用作构建的二进制输入的目录。

--from-file=<file>

指定将成为构建源中唯一文件的单个文件。该文件放在空目录的根目录中,其文件名与提供的原始文件相同。

--from-repo=<local_source_repo>

指定用作构建二进制输入的本地存储库的路径。添加 --commit 选项以控制要用于构建的分支、标签或提交。

将任何这些选项直接传递给构建时,内容将流传输到构建中并覆盖当前的构建源设置。

注意

从二进制输入触发的构建不会在服务器上保留源,因此基础镜像更改触发的重新构建将使用构建配置中指定的源。

流程

例如,以下命令将发送本地 Git 存储库的内容作为标签 v2 的存档,再启动构建:

$ oc start-build hello-world --from-repo=../hello-world --commit=v2