FROM 指令中使用了未定義的參數

輸出

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