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