UndefinedArgInFrom

输出

FROM argument 'VARIANT' is not declared

描述

此规则警告在 FROM 指令中使用未定义构建参数的情况。

FROM 指令中插入构建参数是为构建增加灵活性的一种好方法,它允许您传递覆盖阶段基础镜像的参数。例如,您可以使用构建参数指定镜像标签

ARG ALPINE_VERSION=3.20

FROM alpine:${ALPINE_VERSION}

通过指定构建参数,可以使用不同的 alpine 版本运行构建

$ docker buildx build --build-arg ALPINE_VERSION=edge .

此检查还会尝试检测 `FROM` 指令引用拼写错误的内置构建参数(如 `BUILDPLATFORM`)时发出警告。

示例

❌ 错误:构建参数 VARIANT 未定义。

FROM node:22${VARIANT} AS jsbuilder

✅ 正确:构建参数 VARIANT 已定义。

ARG VARIANT="-alpine3.20"
FROM node:22${VARIANT} AS jsbuilder
页面选项