docker-with-buildx

alpine/docker-with-buildx Docker Image

基于Alpine Linux的Docker镜像,集成Docker Buildx工具,用于简化Docker镜像构建过程并支持增强构建功能。

下载次数: 0状态:社区镜像维护者:Alpine 工具与轻量镜像仓库类型:镜像最近更新:

alpine/docker-with-buildx 镜像文档

镜像概述和主要用途

alpine/docker-with-buildx 是一个基于 Alpine Linux 的轻量级 Docker 镜像,集成了 Docker Buildx 工具。该镜像旨在提供增强的 Docker 构建环境,支持高级构建特性,同时保持 Alpine 系统的轻量性和安全性。主要用途包括:作为本地或 CI/CD 环境中的构建容器,提供多平台镜像构建、构建流程优化等增强能力。

核心功能和特性

  1. 轻量级基础:基于 Alpine Linux,镜像体积小,资源占用低,启动速度快。
  2. 集成 Docker Buildx:内置 Docker Buildx 工具,支持以下增强功能:
    • 多平台镜像构建(如同时构建 amd64、arm64 架构);
    • 构建缓存优化(支持本地缓存和远程缓存);
    • 构建上下文隔离与精细化控制;
    • OCI 镜像格式与 Docker 镜像格式兼容;
    • 并行构建任务支持。
  3. 安全性:继承 Alpine Linux 的安全特性,默认使用非 root 用户(视配置而定),减少***面。

使用场景和适用范围

  • 多平台镜像构建:需要为不同 CPU 架构(如 x86_64、ARM)构建 Docker 镜像的开发者。
  • CI/CD 流水线:在自动化构建流程中(如 GitHub Actions、GitLab CI)提供高效、一致的构建环境。
  • 轻量级构建环境:对资源敏感的场景(如边缘设备、小型服务器),需要低开销的构建工具链。
  • 高级构建需求:需使用 Buildx 高级功能(如缓存导出、自定义构建驱动)的用户。

详细的使用方法和配置说明

构建镜像

通过源码构建本地镜像的命令如下:

bash
docker build -t alpine/docker-with-buildx .

(需先克隆源代码仓库,在仓库根目录执行上述命令)

运行容器

运行容器时,需挂载主机 Docker 守护进程 socket(/var/run/docker.sock)以与主机 Docker 环境交互,示例命令:

bash
docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd):/workspace \
  docker.xuanyuan.run/alpine/docker-with-buildx
  • -v /var/run/docker.sock:/var/run/docker.sock:允许容器内的 Buildx 访问主机 Docker 守护进程;
  • -v $(pwd):/workspace:挂载本地目录到容器内的 /workspace,作为构建上下文。

配置 Buildx

容器启动后,可直接使用 docker buildx 命令调用工具,常见配置场景:

1. 初始化 Buildx 构建器

首次使用时需创建并切换到 Buildx 构建器:

bash
docker buildx create --use --name mybuilder

2. 多平台构建示例

构建同时支持 amd64 和 arm64 架构的镜像:

bash
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t my-image:latest \
  --push /workspace  # --push 可选,用于推送到镜像仓库

环境变量

容器支持通过环境变量配置 Buildx 行为,常用变量如下:

  • DOCKER_HOST:指定 Docker 守护进程地址(默认通过挂载 socket 连接主机,无需额外配置);
  • BUILDX_CONFIG:自定义 Buildx 配置文件路径(默认使用容器内默认配置);
  • DOCKER_CONFIG:指定 Docker 配置目录(如包含镜像仓库认证信息)。

Docker 部署方案示例

docker run 命令示例

以下命令启动容器并执行多平台构建:

bash
docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd):/workspace \
  -e DOCKER_CONFIG=/workspace/.docker \  # 挂载本地 Docker 配置(含仓库认证)
  alpine/docker-with-buildx \
  sh -c "docker buildx create --use && docker buildx build --platform linux/amd64,linux/arm64 -t my-registry/my-image:latest --push /workspace"

docker-compose 配置示例

创建 docker-compose.yml 文件,定义构建服务:

yaml
version: '3.8'
services:
  build-service:
    image: docker.xuanyuan.run/alpine/docker-with-buildx
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./:/workspace
      - ~/.docker:/root/.docker  # 挂载主机 Docker 认证配置
    environment:
      - BUILDX_CONFIG=/workspace/buildx-config.toml  # 自定义 Buildx 配置文件
    command: >
      sh -c "docker buildx create --use && 
             docker buildx build --platform linux/amd64,linux/arm64 -t my-image:latest /workspace"

源代码仓库

镜像源码及更多细节可参考:https://github.com/alpine-docker/docker-with-buildx

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 docker-with-buildx 镜像标签

docker pull docker.xuanyuan.run/alpine/docker-with-buildx:<标签>

DockerHub 原生拉取命令

docker pull alpine/docker-with-buildx:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告