patrickmuniz/docker-with-compose

Docker Dind with Compose 镜像文档

镜像概述

本镜像基于Docker in Docker(Dind)技术构建，预装Docker Compose工具，旨在提供一个隔离的容器环境，允许用户在容器内部运行Docker引擎及Docker Compose项目。通过该镜像，用户可快速搭建具备完整Docker功能的隔离环境，无需在宿主机直接安装Docker服务。

核心功能与特性

核心功能

• 支持Docker in Docker(Dind)模式运行Docker守护进程，允许在容器内构建、运行和管理Docker容器
• 预装Docker Compose工具，可直接使用docker-compose命令管理多容器应用

主要特性

• 与标准Docker CLI完全兼容，支持所有Docker核心命令（docker build、docker run、docker ps等）
• 内置Docker Compose，无需额外安装即可使用docker-compose up、docker-compose down等命令
• 提供隔离的容器运行环境，避免对宿主机Docker服务的直接依赖和干扰
• 支持通过卷挂载实现容器数据持久化，确保Docker镜像和容器状态在重启后可恢复
• 兼容主流Linux架构（如amd64、arm64），适配多种运行环境

使用场景

典型应用场景

• CI/CD流水线：在持续集成/持续部署流程中，用于构建、测试和推送Docker镜像，避免污染宿主机环境
• 开发环境：为开发人员提供快速搭建的隔离Docker环境，无需在本地系统安装完整Docker服务
• 教学与演示：用于Docker和Docker Compose的教学演示，提供安全可控的实验环境
• 受限环境部署：在无法直接安装Docker的受限环境（如共享服务器、云函数）中运行Docker相关任务

使用方法与配置说明

基本使用示例

通过docker run启动容器

bash
docker run -d \
  --privileged \
  --name dind-with-compose \
  -v /var/lib/docker \
  -e DOCKER_TLS_CERTDIR=/certs \
  <镜像名称>

注意：--privileged标志是运行Docker in Docker的必要条件，因为Docker守护进程需要访问宿主机的设备和内核功能。

进入容器并使用Docker/Compose

bash
# 进入运行中的容器
docker exec -it dind-with-compose sh

# 验证Docker运行状态
docker info

# 验证Docker Compose版本
docker-compose --version

高级配置选项

数据持久化

通过挂载宿主机目录到容器内/var/lib/docker，实现Docker数据（镜像、容器、卷等）的持久化：

bash
docker run -d \
  --privileged \
  --name dind-with-compose \
  -v /path/on/host:/var/lib/docker \  # 宿主机目录挂载到容器内Docker数据目录
  <镜像名称>

禁用TLS（开发环境）

默认情况下，Dind镜像启用TLS加密通信。在开发环境中可通过设置DOCKER_TLS_CERTDIR=""禁用TLS，简化配置：

bash
docker run -d \
  --privileged \
  --name dind-with-compose \
  -e DOCKER_TLS_CERTDIR="" \  # 禁用TLS
  <镜像名称>

传递Docker守护进程参数

通过DOCKER_OPTS环境变量传递额外的Docker守护进程启动参数（如自定义镜像仓库、日志配置等）：

bash
docker run -d \
  --privileged \
  --name dind-with-compose \
  -e DOCKER_OPTS="--insecure-registry my-registry.local:5000" \  # 添加自定义仓库配置
  <镜像名称>

环境变量说明

安全注意事项

• 特权容器风险：--privileged标志会赋予容器几乎与宿主机相同的权限，存在安全风险。建议仅在可信环境（如隔离的CI/CD服务器）中使用，并限制容器的网络访问范围。
• 资源限制：建议通过--memory、--cpus等参数限制容器资源使用，避免影响宿主机性能。
• 镜像来源：确保使用官方或可信来源的Dind镜像，避免***代码注入风险。

兼容性说明

• 兼容Docker Engine 19.03+版本
• 预装Docker Compose版本通常与基础Dind镜像版本匹配（具体版本可通过docker-compose --version命令查看）
• 支持Linux x86_64（amd64）架构，部分版本可能支持arm64（如基于Alpine的Dind镜像）