如何让docker build将构建警告视为致命错误？

问题背景 #

我的Dockerfile存在一处严重错误，但执行docker build时仍成功构建镜像并返回成功状态。查看CI日志后发现如下警告：

1 warning found (use docker --debug to expand):

• UndefinedVar: Usage of undefined variable '$VERSION' (line 33)

请问如何让所有警告变为致命错误？我在docker build文档中未找到相关开关。

可行方案 #

Docker官方的docker build命令目前没有内置选项可以直接将警告转为致命错误，但可以通过以下两种方式实现需求：

• 使用专用Dockerfile静态检查工具（推荐）
  借助hadolint这类专门的Dockerfile lint工具提前做预检查，它支持将警告判定为错误。在CI流程中先执行以下命令：

  hadolint --failure-threshold error Dockerfile
  

  只要检查出任何警告或错误，该命令就会返回非零状态码，直接终止后续的镜像构建流程，避免生成存在隐患的镜像。

• 自定义BuildKit构建钩子
  如果你使用BuildKit进行镜像构建，可以编写自定义脚本作为构建钩子，在构建前扫描Dockerfile中的问题（比如未定义变量），一旦发现问题就报错退出。这种方式需要自行实现检查逻辑，灵活性较高，但不如专用工具便捷省心。

内容的提问来源于stack exchange，提问作者Velkan