7.2. 构建 hook

通过构建 hook，可以将行为注入到构建过程中。

BuildConfig 对象的 postCommit 字段在运行构建输出镜像的临时容器内执行命令。Hook 的执行时间是紧接在提交镜像的最后一层后，并且在镜像推送到 registry 之前。

当前工作目录设置为镜像的 WORKDIR，即容器镜像的默认工作目录。对于大多数镜像，这是源代码所处的位置。

如果脚本或命令返回非零退出代码，或者启动临时容器失败，则 hook 将失败。当 hook 失败时，它会将构建标记为失败，并且镜像也不会推送到 registry。可以通过查看构建日志来检查失败的原因。

构建 hook 可用于运行单元测试，以在构建标记为完成并在 registry 中提供镜像之前验证镜像。如果所有测试都通过并且测试运行器返回退出代码 0，则构建标记为成功。如果有任何测试失败，则构建标记为失败。在所有情况下，构建日志将包含测试运行器的输出，这可用于识别失败的测试。

postCommit hook 不仅限于运行测试，也可用于运行其他命令。由于它在临时容器内运行，因此 hook 所做的更改不会持久存在；也就是说，hook 执行无法对最终镜像造成影响。除了其他用途外，也可借助此行为来安装和使用会自动丢弃并且不出现在最终镜像中的测试依赖项。

配置构建后 hook 的方法有多种。以下示例中所有形式具有同等作用，也都执行 bundle exec rake test --verbose。

流程

使用以下选项之一配置构建后 hook：

选项描述

选项	描述
shell 脚本	postCommit: script: "bundle exec rake test --verbose" `script` 值是通过 `/bin/sh -ic` 执行的 shell 脚本。当 shell 脚本适合执行构建 hook 时，请使用此选项。例如，用于运行前文所述的单元测试。要控制镜像入口点，或者镜像没有 `/bin/sh`，`请使用命令`、或 `args`。注意引入的额外 `-i` 标志用于改进搭配 CentOS 和 RHEL 镜像时的体验，未来的发行版中可能会剔除。
命令作为镜像入口点	postCommit: command: ["/bin/bash", "-c", "bundle exec rake test --verbose"] 在这种形式中，`command` 是要运行的命令，它会覆盖 exec 形式中的镜像入口点，如 Dockerfile 引用中所述。如果镜像没有 `/bin/sh`，或者您不想使用 shell，则需要这样做。在所有其他情形中，使用 `script` 可能更为方便。
带有参数的命令	postCommit: command: ["bundle", "exec", "rake", "test"] args: ["--verbose"] 这种形式相当于将参数附加到 `command`。

shell 脚本

postCommit:
  script: "bundle exec rake test --verbose"

script 值是通过 /bin/sh -ic 执行的 shell 脚本。当 shell 脚本适合执行构建 hook 时，请使用此选项。例如，用于运行前文所述的单元测试。要控制镜像入口点，或者镜像没有 /bin/sh，请使用命令、或 args。

注意

引入的额外 -i 标志用于改进搭配 CentOS 和 RHEL 镜像时的体验，未来的发行版中可能会剔除。

命令作为镜像入口点

postCommit:
  command: ["/bin/bash", "-c", "bundle exec rake test --verbose"]

在这种形式中，command 是要运行的命令，它会覆盖 exec 形式中的镜像入口点，如 Dockerfile 引用中所述。如果镜像没有 /bin/sh，或者您不想使用 shell，则需要这样做。在所有其他情形中，使用 script 可能更为方便。

带有参数的命令

postCommit:
  command: ["bundle", "exec", "rake", "test"]
  args: ["--verbose"]

这种形式相当于将参数附加到 command。

注意

同时提供 script 和 command 会产生无效的构建 hook。

oc set build-hook 命令可用于为构建配置设置构建 hook。

流程

完成以下操作之一：

要将命令设置为 post-commit 构建 hook，请输入以下命令：

$ oc set build-hook bc/mybc \
    --post-commit \
    --command \
    -- bundle exec rake test --verbose

要将脚本设置为提交后构建 hook，请输入以下命令：

$ oc set build-hook bc/mybc --post-commit --script="bundle exec rake test --verbose"