Docker多架构镜像构建全过程

                         ┌─ linux/amd64 镜像层
registration_info:v1.0 ──┤
                         └─ linux/arm64 镜像层

# 检查 Docker 版本（需要 19.03+）
docker version
# 实际版本: 29.1.4

# 检查 Buildx 是否可用
docker buildx version
# 实际版本: v0.30.1

# 参数解析
--push              # 推送到私有仓库
--save              # 导出为离线 tar 包
--registry <addr>   # 私有仓库地址（默认: 192.168.50.32）
--platform <p>      # 目标平台: amd64, arm64, all（默认: all）
--version <ver>     # 镜像版本（默认: 时间戳）
--skip-build        # 跳过 Maven 构建

# 安装 ARM64 QEMU 模拟器
docker run --rm --privileged tonistiigi/binfmt --install arm64

# 验证支持的架构
# 输出: linux/amd64, linux/arm64, ...

docker buildx build --output type=docker,dest=file.tar

# 单架构构建
docker build --platform linux/amd64 -t image:tag .
docker save -o image.tar image:tag

exec /bin/sh: exec format error

# 安装 QEMU
docker run --rm --privileged tonistiigi/binfmt --install arm64

ERROR: failed to do request: Head "https://registry-1.docker.io/v2/...":
dial tcp xxx:443: i/o timeout

# 检查宿主机是否能访问 Docker Hub
curl -s --connect-timeout 5 https://registry-1.docker.io/v2/
# 返回 UNAUTHORIZED 说明可以连接

# 查看宿主机镜像加速器配置
cat /etc/docker/daemon.json
# 已配置: docker.1ms.run, docker.xuanyuan.me

mkdir -p ~/.docker/buildx

cat > ~/.docker/buildx/buildkitd.toml << 'EOF'
[registry."docker.io"]
  mirrors = ["docker.1ms.run", "docker.xuanyuan.me"]
EOF

# 删除旧的 builder
docker buildx rm multiarch 2>/dev/null || true

# 创建新的 builder，关键参数：
# --driver-opt network=host  使用宿主机网络
# --config                   指定 buildkit 配置文件
docker buildx create \
  --name multiarch \
  --driver docker-container \
  --driver-opt network=host \
  --config ~/.docker/buildx/buildkitd.toml \
  --use

# 启动并验证
docker buildx inspect --bootstrap

File#buildkitd.toml:
 > [registry]
 >   [registry."docker.io"]
 >     mirrors = ["docker.1ms.run", "docker.xuanyuan.me"]

# 查看帮助
./docker_build.sh --help

# 导出多架构包（ARM64 + AMD64）
./docker_build.sh --save

# 导出指定版本
./docker_build.sh --save --version 1.2.0

# 只导出 x86 架构
./docker_build.sh --save --platform amd64

# 只导出 ARM 架构
./docker_build.sh --save --platform arm64

# 跳过 Maven 构建（jar 包已存在时）
./docker_build.sh --save --skip-build

# 推送到默认仓库 (192.168.50.32)
./docker_build.sh --push

# 推送到指定仓库
./docker_build.sh --push --registry 10.0.0.100

# 指定版本推送
./docker_build.sh --push --version 1.2.0

# 导入镜像
docker load < registration_info_<版本>_multiarch.tar

# 查看导入的镜像
docker images | grep registration_info

vim ~/.docker/buildx/buildkitd.toml

docker buildx rm multiarch
# 下次运行脚本会自动重建

# 清理 buildx 缓存
docker buildx prune

# 清理所有缓存（谨慎使用）
docker buildx prune -a