ONBUILD

ONBUILD <INSTRUCTION>

ONBUILD指令在镜像中添加了一个触发指令,该指令将在以后执行,当镜像作为另一个镜像的基础镜像时。触发器将在下游构建的上下文中被执行,就好像在下游DockerfileFROM指令之后立即插入的一样。

任何构建指令都可以注册为触发器 。

如果我们正在构建一个镜像,该镜像将用作构建其他镜像的基础镜像,例如应用构建环境或通过特定用户配置进行自定义的守护进程,这很有用 。

例如,如果我们的镜像是可重复使用的Python应用程序构建器,需要在特定目录中添加应用源代码,之后可能需要调用一个构建脚本。我们现在不能只调用ADDRUN,因为我们尚未访问应用程序源代码,并且每个应用程序构建的代码将有所不同。我们只需向应用程序开发人员提供一个Dockerfile样板文件,然后复制粘贴到他们的应用程序中。但这种做法低效、容易出错而且难以更新,因为它与应用程序特定的代码混在一起。

解决方案是使用ONBUILD注册指令,在下一个构建阶段时运行 。

工作原理如下:

  1. 当它遇到ONBUILD指令时,构建器会为正在构建的镜像的元数据添加一个触发器。该指令不会影响当前的构建 。

  2. 在构建结束时,所有触发器的列表存储在镜像列表中,在onBuild键下。它们可以通过docker inspect命令进行检查。

  3. 稍后,镜像可以作为正在使用FROM指令的一个新的构建(build)的基础镜像。作为FROM指令处理的一部分,下游构建器会查找ONBUILD触发器,并按注册的相同顺序执行它们。如果任何触发器出现故障,则FROM指令中止,从而导致构建的失败。如果所有触发器都成功,则FROM指令完成,构建过程将继续正常进行 。

  4. 执行后,触发器从最终的镜像中清除。换句话说,它们不被子构建继承。

例如,我们可以添加下面这样的内容:

ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src

Warning:

无法链式使用ONBUILD,例如ONBUILD ONBUILDONBUILD指令可能不会触发FROMMAINTAINER指令

Last updated