如何使用Docker buildx build命令一次性创建多个镜像标签？

问题重现 #

尝试使用以下命令构建并推送多架构镜像，同时打多个标签，但无法正常工作：

docker buildx build . \
    --platform linux/arm64,linux/amd64 \
    --no-cache --push \
    -t test:latest -t test:${CI_COMMIT_SHORT_SHA}

核心解决方案 #

问题大多出在Buildx驱动兼容性、环境变量解析或镜像仓库配置上，按以下步骤排查修复：

• 切换到docker-container驱动的Builder实例
  默认的docker驱动不支持多标签多架构镜像的推送，必须创建并使用基于容器的驱动：

# 创建多架构Builder
docker buildx create --name multiarch-builder --use
# 初始化Builder
docker buildx inspect multiarch-builder --bootstrap

• 确保环境变量正确解析
  检查CI_COMMIT_SHORT_SHA是否在当前环境中正确赋值：

  • CI环境中：确认CI平台（如GitLab CI、GitHub Actions）已自动注入该变量
  • 本地测试：手动赋值模拟CI环境：

    export CI_COMMIT_SHORT_SHA=$(git rev-parse --short HEAD)
    

• 修正镜像仓库地址
  如果推送的是公共/私有仓库，必须在镜像名前加上完整仓库地址（如docker.io/your-username/test），否则会推送失败：

docker buildx build . \
    --platform linux/arm64,linux/amd64 \
    --no-cache --push \
    -t docker.io/your-username/test:latest -t docker.io/your-username/test:${CI_COMMIT_SHORT_SHA}

• 验证仓库登录状态
  确保已登录目标镜像仓库：

docker login docker.io  # 替换为你的仓库地址

完整可运行示例 #

# 初始化多架构Builder
docker buildx create --name multiarch-builder --use
docker buildx inspect multiarch-builder --bootstrap

# 设置短SHA变量（本地测试用）
export CI_COMMIT_SHORT_SHA=$(git rev-parse --short HEAD)

# 登录仓库（按需执行）
docker login docker.io

# 构建推送
docker buildx build . \
    --platform linux/arm64,linux/amd64 \
    --no-cache --push \
    -t docker.io/your-username/test:latest -t docker.io/your-username/test:${CI_COMMIT_SHORT_SHA}

内容的提问来源于stack exchange，提问作者Old Man Programmer