moby/moby-bin

moby-test 镜像技术文档

概述

moby-test 镜像是基于 https://github.com/moby/moby 项目构建的二进制测试镜像，用于快速验证 Moby/Docker 引擎的新功能、修复及兼容性。镜像包含 Moby 项目最新开发分支的二进制构建产物（如 dockerd、docker CLI 等核心组件），仅适用于测试场景，不建议用于生产环境。

核心功能和特性

• 基于最新源码构建：集成 Moby 项目开发分支最新代码，包含未发布的功能与修复；
• 完整引擎组件：内置 Docker 引擎全套工具链（dockerd 守护进程、docker 命令行客户端、containerd 运行时等）；
• 轻量级设计：基础镜像体积精简，支持快速拉取和启动，适合临时测试环境；
• 灵活配置：支持自定义存储驱动、网络模式、日志级别等核心参数；
• 独立运行：无需依赖宿主系统的 Docker 服务，可作为独立测试实例部署。

使用场景和适用范围

适用场景

• Moby/Docker 开发者验证新功能或 bug 修复；
• CI/CD 流水线中集成 Moby 版本兼容性测试；
• 学习或研究 Docker 引擎内部机制（如存储驱动、网络模型）；
• 临时测试环境快速搭建（如验证多节点网络通信、存储性能）。

适用范围

• 用户：Docker/Moby 开发者、测试工程师、研究人员；
• 环境：本地开发环境、CI 服务器、临时测试集群（非生产环境）。

使用方法和配置说明

基础使用（docker run 命令）

通过 docker run 直接启动测试实例，默认启动 dockerd 守护进程并暴露 API 端口：

bash
docker run -d \
  --name moby-test-instance \
  --privileged \  # 需特权模式以支持容器运行时功能
  -p 2375:2375 \   # 暴露 Docker API 端口（非 TLS，仅测试用）
  -v moby-test-data:/var/lib/docker \  # 挂载数据卷持久化存储
  moby-test:latest

说明：--privileged 模式用于赋予容器访问宿主设备和内核功能的权限（如挂载文件系统），仅测试场景使用。

自定义配置

环境变量

通过 -e 指定环境变量调整运行参数，常用变量如下：

示例：启动 debug 日志级别、使用 devicemapper 存储驱动的实例：

bash
docker run -d \
  --name moby-test-debug \
  --privileged \
  -p 2376:2375 \  # 自定义 API 端口映射（宿主端口 2376 -> 容器 2375）
  -e LOG_LEVEL=debug \
  -e STORAGE_DRIVER=devicemapper \
  -v moby-test-debug-data:/var/lib/docker \
  moby-test:latest

挂载自定义配置文件

如需更复杂的配置（如自定义镜像仓库、镜像加速），可通过挂载 daemon.json 配置文件覆盖默认参数：

1. 本地创建配置文件 daemon.json：

   json
   {
     "insecure-registries": ["http://my-registry:5000"],  # 允许非 TLS 私有仓库
     "log-driver": "json-file",
     "log-opts": { "max-size": "10m", "max-file": "3" }  # 日志轮转配置
   }
   

2. 启动时挂载配置文件：

   bash
   docker run -d \
     --name moby-test-custom-config \
     --privileged \
     -v $(pwd)/daemon.json:/etc/docker/daemon.json \  # 挂载本地配置文件
     -v moby-test-config-data:/var/lib/docker \
     moby-test:latest
   

验证运行状态

1. 检查容器状态：

   bash
   docker ps --filter "name=moby-test-instance"
   

2. 查看 dockerd 日志：

   bash
   docker logs moby-test-instance
   

3. 通过 API 连接测试实例（需安装 docker 客户端）：

   bash
   export DOCKER_HOST=tcp://localhost:2375  # 指向测试实例 API 端口
   docker info  # 验证连接成功，输出测试实例信息
   

Docker Compose 配置示例

创建 docker-compose.yml 实现多实例或依赖服务的批量部署：

yaml
version: "3"
services:
  moby-test-1:
    image: moby-test:latest
    privileged: true
    ports:
      - "2375:2375"
    environment:
      - LOG_LEVEL=info
      - STORAGE_DRIVER=overlay2
    volumes:
      - moby-data-1:/var/lib/docker
    restart: unless-stopped

  moby-test-2:  # 多实例示例（不同端口）
    image: moby-test:latest
    privileged: true
    ports:
      - "2376:2375"
    environment:
      - LOG_LEVEL=debug
      - STORAGE_DRIVER=devicemapper
    volumes:
      - moby-data-2:/var/lib/docker
    restart: unless-stopped

volumes:
  moby-data-1:
  moby-data-2:

启动命令：

bash
docker-compose up -d

注意事项

1. 非生产环境：镜像仅用于测试，缺乏生产环境所需的安全加固和稳定性保障；
2. 数据持久化：务必通过 volumes 挂载数据目录，避免容器删除导致测试数据丢失；
3. 权限控制：--privileged 模式会提升容器权限，测试完成后建议及时清理容器；
4. 端口冲突：若宿主已运行 Docker 服务，需修改测试实例的 API 端口（如 -p 2376:2375）。