如何用buildx结合不同Dockerfiles构建arm64与amd64镜像

你可以通过两种方式实现，优先推荐单Dockerfile+内置架构变量的方案，减少重复维护成本：

方案1：单Dockerfile适配多架构（推荐） #

利用Docker Buildx提供的TARGETARCH内置变量，它会根据构建目标架构自动赋值：

• 目标为amd64时，TARGETARCH值为amd64，通过变量替换映射为s6-overlay需要的x86_64
• 目标为arm64时，TARGETARCH值为arm64，映射为aarch64

示例Dockerfile #

# 定义s6-overlay版本，构建时可通过--build-arg覆盖
ARG S6_OVERLAY_VERSION=3.1.2.1

# 根据目标架构自动选择对应压缩包
ADD https://github.com/just-containers/s6-overlay/releases/download/v${S6_OVERLAY_VERSION}/s6-overlay-${TARGETARCH:x86_64}.tar.xz /tmp

# 解压s6-overlay（通用步骤）
RUN tar -C / -Jxpf /tmp/s6-overlay-${TARGETARCH:x86_64}.tar.xz \
    && rm -f /tmp/s6-overlay-${TARGETARCH:x86_64}.tar.xz

# 你的其他镜像构建步骤...

构建命令 #

执行以下命令即可同时构建并推送多架构镜像到仓库（替换为你的镜像仓库地址）：

docker buildx build --platform linux/amd64,linux/arm64 \
  --build-arg S6_OVERLAY_VERSION=3.1.2.1 \
  -t your-repo/your-image:latest \
  --push .

方案2：多Dockerfile分别构建 #

如果必须拆分Dockerfile，可以创建两个独立的Dockerfile，分别对应不同架构：

1. 创建架构专属Dockerfile #

• Dockerfile.amd64

ARG S6_OVERLAY_VERSION=3.1.2.1
ADD https://github.com/just-containers/s6-overlay/releases/download/v${S6_OVERLAY_VERSION}/s6-overlay-x86_64.tar.xz /tmp
# 后续解压及其他构建步骤

• Dockerfile.arm64

ARG S6_OVERLAY_VERSION=3.1.2.1
ADD https://github.com/just-containers/s6-overlay/releases/download/v${S6_OVERLAY_VERSION}/s6-overlay-aarch64.tar.xz /tmp
# 后续解压及其他构建步骤

2. 单架构构建命令 #

# 构建amd64镜像
docker buildx build --platform linux/amd64 \
  --build-arg S6_OVERLAY_VERSION=3.1.2.1 \
  -f Dockerfile.amd64 \
  -t your-repo/your-image:amd64-latest .

# 构建arm64镜像
docker buildx build --platform linux/arm64 \
  --build-arg S6_OVERLAY_VERSION=3.1.2.1 \
  -f Dockerfile.arm64 \
  -t your-repo/your-image:arm64-latest .

3. 批量构建（可选） #

如果需要批量构建，可创建docker-bake.hcl配置文件：

group "default" {
  targets = ["amd64", "arm64"]
}

target "amd64" {
  dockerfile = "Dockerfile.amd64"
  platforms = ["linux/amd64"]
  args = {
    S6_OVERLAY_VERSION = "3.1.2.1"
  }
  tags = ["your-repo/your-image:amd64-latest"]
}

target "arm64" {
  dockerfile = "Dockerfile.arm64"
  platforms = ["linux/arm64"]
  args = {
    S6_OVERLAY_VERSION = "3.1.2.1"
  }
  tags = ["your-repo/your-image:arm64-latest"]
}

执行批量构建并推送：

docker buildx bake --push

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