FromPlatformFlagConstDisallowed

目录

输出

FROM --platform flag should not use constant value "linux/amd64"

描述

在Dockerfile的FROM指令中指定--platform会强制镜像仅在单一目标平台上构建。这会阻止从此Dockerfile构建多平台镜像，并且必须在与--platform中指定的相同平台上进行构建。

推荐的方法是：

  • 在Dockerfile中省略FROM --platform，并在命令行上使用--platform参数。
  • 使用 $BUILDPLATFORM 或其他变量组合作为 --platform 参数。
  • 阶段名称应包括平台、操作系统或架构名称，以表明它仅包含特定平台的指令。

示例

❌ 错误：为 --platform 使用常量参数

FROM --platform=linux/amd64 alpine AS base
RUN apk add --no-cache git

✅ 好：使用默认平台

FROM alpine AS base
RUN apk add --no-cache git

✅ 好：使用元变量

FROM --platform=${BUILDPLATFORM} alpine AS base
RUN apk add --no-cache git

✅ 好：用于具有目标架构的多阶段构建

FROM --platform=linux/amd64 alpine AS build_amd64
...

FROM --platform=linux/arm64 alpine AS build_arm64
...

FROM build_${TARGETARCH} AS build
...