ezkrg/buildx

docker:stable-with-buildx 镜像文档

镜像概述

该镜像基于官方docker:stable镜像构建，集成了最新版本的buildx CLI插件。buildx是Docker提供的扩展工具，旨在增强容器镜像构建能力，支持多平台构建、构建缓存优化、自定义构建输出等高级特性。

核心功能与特性

• 稳定基础：基于docker:stable镜像，确保Docker引擎的稳定性和可靠性
• 最新buildx插件：集成最新版buildx CLI工具，支持所有最新构建特性
• 多平台构建：可同时构建适用于不同架构（如amd64、arm64等）的镜像
• 构建缓存：优化构建缓存机制，加速重复构建过程
• 自定义输出：支持多种输出格式，如本地目录、tar文件、镜像仓库等
• 高级构建选项：支持构建参数、目标阶段选择、隔离构建环境等

使用场景

• 开发环境中需要构建多平台容器镜像
• CI/CD流水线中的自动化镜像构建流程
• 需要使用高级构建功能（如缓存优化、多阶段构建）的场景
• 容器镜像的跨架构分发需求

使用方法与配置说明

基本使用（docker run）

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock docker:stable buildx version

该命令将输出当前集成的buildx版本信息。

构建多平台镜像示例

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd):/workspace -w /workspace \
  docker:stable \
  buildx build --platform linux/amd64,linux/arm64 -t myimage:latest .

常用buildx命令

• 查看buildx版本：buildx version
• 创建构建器实例：buildx create --name mybuilder
• 列出构建器实例：buildx ls
• 使用指定构建器：buildx use mybuilder
• 构建并推送到仓库：buildx build --push --platform linux/amd64,linux/arm64 -t username/image:tag .

环境变量

该镜像继承自docker:stable，支持Docker官方镜像的所有环境变量，主要包括：

• DOCKER_HOST：指定Docker守护进程地址
• DOCKER_TLS_VERIFY：启用TLS验证
• DOCKER_CERT_PATH：TLS证书路径

注意事项

• 使用时需挂载Docker守护进程套接字（/var/run/docker.sock）以与宿主机Docker引擎通信
• 多平台构建可能需要启用Docker的实验性功能或配置适当的构建器
• 构建大型镜像时建议增加容器内存限制以避免构建失败