bodsch/molecule-dind

Docker-in-Docker 镜像文档

镜像概述

本镜像基于Docker-in-Docker（DinD）技术构建，集成了python3、ansible、tox和molecule工具链。它允许在容器内部运行Docker守护进程，同时提供Python环境及配置管理、测试工具，适用于需要在隔离环境中进行Docker操作、Ansible角色开发与测试的场景。

核心功能与特性

• Docker-in-Docker支持：容器内部运行完整Docker守护进程，可独立执行Docker命令（如构建、运行容器）
• Python环境：内置python3，支持Python应用开发与运行
• 配置管理工具：集成ansible，用于自动化配置管理、应用部署
• 测试工具链：包含tox（Python多环境测试管理）和molecule（Ansible角色测试框架）

使用场景

• CI/CD流水线：在持续集成/部署流程中，作为隔离环境执行Docker构建、Ansible部署测试
• Ansible角色开发：使用molecule进行Ansible角色的自动化测试（创建、验证、销毁测试环境）
• Python应用测试：通过tox管理多Python版本环境，执行单元测试、集成测试
• 容器化工具链验证：在隔离环境中验证Docker相关脚本或工具的正确性

使用方法

基础运行命令

由于DinD需要特权模式，运行容器时需添加--privileged参数：

bash
docker run --privileged -d --name dind-ansible your-image-name

进入容器环境

bash
docker exec -it dind-ansible /bin/bash

验证工具可用性

进入容器后，可通过以下命令验证集成工具：

bash
# 验证Docker
docker --version

# 验证Python
python3 --version

# 验证Ansible
ansible --version

# 验证tox
tox --version

# 验证molecule
molecule --version

典型应用示例

1. 使用molecule测试Ansible角色

bash
# 创建Ansible角色
ansible-galaxy init my_role

# 进入角色目录
cd my_role

# 使用molecule初始化测试环境（默认使用Docker驱动）
molecule init scenario --driver-name docker

# 运行测试
molecule test

2. 使用tox管理Python测试环境

在项目根目录创建tox.ini文件后，执行：

bash
tox

tox将自动创建多版本Python环境并执行测试命令。

注意事项

• 特权模式：DinD运行需--privileged权限，生产环境中需评估安全风险
• 性能考量：容器内Docker守护进程性能可能低于主机直接运行，适合测试场景
• 数据持久化：若需持久化容器内Docker数据，可挂载卷：

  bash
  docker run --privileged -d -v dind-data:/var/lib/docker your-image-name
  

• 网络配置：容器内Docker网络与主机网络隔离，需根据需求配置端口映射或网络模式