Docker Build Tests Docker Pulls Docker Image Size

本工具用于读取极空间私有云系统中的存量Docker容器信息,自动生成对应的docker-compose.yaml文件。

它会根据容器之间的网络关系(自定义网络或link连接)将相关容器分组,并为每组容器生成一个独立的docker-compose.yaml文件。

理论上所有NAS都可以用,但是有些特意删除的功能,比如命令、性能限制、endpiont等,由于极空间不支持,所以删除了。

1️⃣ : 中文docker项目集成项目: https://github.com/coracoo/awesome_docker_cn

2️⃣ : docker转compose:https://github.com/coracoo/docker2compose

3️⃣ : 容器部署iSCSI,支持绿联极空间飞牛:https://github.com/coracoo/d-tgtadm/

4️⃣ : 容器端口检查工具: https://github.com/coracoo/DockPorts/

关注

• 纯AI打造,有问题提issuse,特殊容器贴原docker cli
• 读取系统中所有Docker容器信息
• 分析容器之间的网络关系(自定义network和link连接)
• 根据网络关系将相关容器分组
• 为每组容器生成对应的docker-compose.yaml文件(根据首个容器名称)
• 智能时区管理:自动读取配置文件中的时区设置并应用到容器系统,确保定时任务在正确时区执行
• 支持提取容器的各种配置,包括:
  • 容器名称
  • 镜像
  • 端口映射
  • 环境变量
  • 数据卷(volume/bind)
  • 网络(host/bridge/macvlan单独配置,其它网络根据名称在一起)
  • 重启策略
  • 特权模式
  • 硬件设备挂载
  • cap_add 能力
  • command和entrypoint(在ZOS模式下不生成)
  • 健康检测
  • 其他配置等等

部署完成后,可通过浏览器访问Web界面:

• 本地访问:http://localhost:5000
• 局域网访问:http://你的IP地址:5000

• 📊 容器管理:实时查看所有Docker容器状态,按网络关系自动分组
• 📄 Compose预览:直接在界面中查看生成的docker-compose.yaml文件内容
• ⏰ 调度器监控:实时监控定时任务状态,查看执行日志
• 🚀 立即执行:一键执行compose文件生成任务
• 🗂️ 文件管理:浏览和管理生成的compose文件目录
• 📝 日志查看:查看详细的执行日志,支持清空日志功能
• 🎨 响应式设计:采用三栏式布局(容器列表:文件列表:编辑器 = 1:1:2),适配不同屏幕尺寸
• 🔘 优化界面:"关于我"按钮采用白底设计,提供更好的视觉对比度

🔻项目首页

QQ_1751597270453

🔻可视化配置编辑

QQ_1751597299766

🔻定时任务管理

QQ_1751597315617

• NAS: 指定NAS系统类型

  • debian: 默认值,生成完整配置
  • zos: 极空间系统,不生成command和entrypoint配置

• CRON: 定时执行配置,支持5位6円位Cron规则,示例:0 2 * * *(每天凌晨2点执行)

  • 默认值:0 */12 * * *(每天0点起,每天12小时执行一次)
  • once: 执行一次后退出

• NETWORK: 控制bridge网络配置的显示方式

  • true: 默认值,在生成的compose.yaml中显式添加 network_mode: bridge 配置
  • false: 隐藏bridge网络配置,不在compose.yaml中显示 network_mode: bridge(因为bridge是Docker默认网络模式)

• TZ: 时区设置,影响容器内系统时间和定时任务执行

  • 默认值:Asia/Shanghai
  • 支持标准时区格式:Asia/Shanghai、Europe/London、America/New_York 等
  • 容器启动时会自动应用此时区设置到系统中
  • 如果指定的时区文件不存在,系统会显示警告并使用UTC时区

• /app/compose: 脚本输出目录,默认值为/app/compose
• /app/compose/YYYY_MM_DD_HH_MM: 定时任务输出目录,格式为YYYY_MM_DD_HH_MM,例如2023_05_04_15_00
• /app/logs:定时任务日志

• 对于单个独立的容器,生成的文件名格式为:{容器名}.yaml
• 对于有网络关系的容器组,生成的文件名格式为:{第一个容器名前缀}-group.yaml
• 所有生成的文件都会保存在compose/时间戳目录下

• 该工具需要Docker命令行权限才能正常工作
• 生成的docker-compose.yaml文件可能需要手动调整以满足特定需求
• 通过Docker运行时,会将宿主机的Docker套接字挂载到容器中,以便获取容器信息
• 工具支持定时执行,默认once(只执行一次),可通过CRON环境变量自定义执行时间
• 时区配置重要提醒:
  • 容器启动时会自动读取 config.json 中的TZ配置并应用到系统
  • 如果定时任务时间不准确,请检查TZ配置是否正确
  • 可通过 docker exec d2c-container date 命令验证容器内时区是否正确
• 关于Macvlan网络,DHCP的理论上会展示macvlan:{},
• 对于使用默认bridge网络但没有显式link的容器,它们可能会被分到不同的组中
• 工具会将自定义网络标记为external: true,因为它假设这些网络已经存在

启用前确保系统安装了docker

🔻docker cli启动

docker run -itd --name d2c \
 -v /var/run/docker.sock:/var/run/docker.sock:ro \
 -v /{path}/d2c/compose:/app/compose \
 -v /{path}/d2c/logs:/app/logs \
 -v /{path}/d2c/config:/app/config \
 -p 5000:5000 \
 -e TZ=Asia/Shanghai \
 crpi-xg6dfmt5h2etc7hg.cn-hangzhou.personal.cr.aliyuncs.com/cherry4nas/d2c:latest
 # 或使用github镜像源:ghcr.io/coracoo/d2c:latest

🔻docker compose启动

services:
 d2c:
 image: crpi-xg6dfmt5h2etc7hg.cn-hangzhou.personal.cr.aliyuncs.com/cherry4nas/d2c:latest
 # github镜像源
 # image: ghcr.io/coracoo/d2c:latest
 container_name: d2c
 ports:
 - "5000:5000" # Web UI端口
 environment:
 - TZ=Asia/Shanghai # 可选,时区设置
 volumes:
 - /var/run/docker.sock:/var/run/docker.sock:ro
 - /{path}/d2c/compose:/app/compose
 - /{path}/d2c/logs:/app/logs
 - /{path}/d2c/config:/app/config

如果您的系统已安装Python环境,也可以直接运行:

1. 确保系统中已安装Python 3和Docker
2. 确保脚本有执行权限

chmod +x d2c.py

3. 安装python所需的依赖包

pip install -r requirements.txt

4. 运行脚本

./run.sh

5. 脚本会在当前目录下创建一个compose文件夹,并在其中生成docker-compose.yaml文件

项目现在包含了完整的测试套件,用于验证核心功能:

# 安装测试依赖
pip install -r requirements.txt
# 运行所有测试
python run_tests.py
# 或者使用pytest直接运行
python -m pytest tests/ -v

测试套件包含40个综合测试,覆盖:

• 配置管理和验证
• 容器分析和分组逻辑
• CRON表达式处理
• 调度器功能
• Web UI工具函数

详细信息请参阅 tests/README.md

项目支持自动构建多平台Docker镜像并推送到Docker Hub:

- **Docker Hub**: `jackie264/docker2compose`
- **GitHub Container Registry**: `ghcr.io/coracoo/d2c`
- **阿里云镜像仓库**: `crpi-xg6dfmt5h2etc7hg.cn-hangzhou.personal.cr.aliyuncs.com/cherry4nas/d2c`

• linux/amd64
• linux/arm64
• linux/arm/v7

• 每次推送到master分支时自动构建
• 创建版本标签时自动构建并发布
• 构建前会自动运行完整测试套件
• 详细设置说明请参阅 docs/DOCKER_HUB_SETUP.md

• 增加了完整的test套件(@Jackie264)
• 增加了docker.hub镜像源(@jackie264)
• 优化了entrypoint.sh,优化了部分icon图标更新(@jackie264)
• 使用 Dependabot 自动更新所需的依赖项(@jackie264)
• 修复部分CRON会导致调度器异常以及无法重启的问题(@jackie264)

• 修复Dockerfile.github中未添加procps以来导致CRON无法识别启动的问题
• 优化@Jackie264提到,关于PID 1进程管理问题:新增 entrypoint.sh 脚本专注于PID 1进程管理,不会自动启动调度器
• 实现Web UI进程的监控和重启机制,调度器由Web UI界面管理
• 添加优雅的容器停止处理,确保所有子进程正确清理
• 避免once模式下的调度器冲突,提升容器健壮性和一致性
• 解决子进程意外退出导致容器停止的问题
• 修复容器内时区显示为UTC而非配置时区的问题

• 🎨 UI布局优化:
  • 重新设计顶部导航栏为三栏式布局:左侧"关于我"按钮、中间Logo和项目名称居中、右侧功能按钮
  • 调整主内容区域布局比例为 1:1:2(容器列表:文件列表:编辑器),解决编辑器过宽问题
  • 优化响应式设计,在移动端(768px以下)自动切换为垂直堆叠布局
  • 修复设置保存、Cron异常的问题。

• 改进了Host网络和Macvlan网络的compose文件命名规则
  • Host网络容器组现在生成host-group.yaml文件名
  • Macvlan网络容器组现在生成{网络名}-group.yaml文件名
• 增加配置文件config.json的持久化读取,现在在/app/config/config.json目录下
• 优化compose编辑器,现在保存compose文件后会自动刷新文件列表
• 修复dockerfile中路径映射不生效、flask缺失的问题
• 优化切换compose文件的视觉效果
• 修复任务计划、生成全量Compose功能,时区配置不起作用的问题
• 优化任务计划中,once参数启动任务、任务停止(未启动)时的提示内容
• 修复任务计划中,缺失gnupg导致无法正确识别CRON和调度器状态的问题

• 🎉 新增Web UI界面:

  • 采用全新得现代化的图形界面设计,原CLI模式保留不变。
  • 左侧为容器分组展示,支持按网络关系自动分组,包含运行状态、容器数量等。
  • 中间为文件列表,展示/app/compose目录下所有得yaml文件。
  • 右侧是Compose编辑区域,支持勾选docker整合compose。
  • 新增设置页面,用来编辑配置文件。
  • 新增任务计划页面,用来执行定时任务。
  • 新增日志查看页面,用来查看任务执行日志。

• 🔧 修改代码逻辑:

  • 去除环境变量,所有参数通过/app/config.json来配置(参考前面得配置文件说明)。
  • 新增系统CRON和Python调度器来执行CRON任务,彻底解决5、6位CRON的问题。
  • 初次登录会自动生成所有得容器yaml文件,保存在/app/compose目录下。

• 🐛 修复已知问题:

  • 解决多个稳定性和兼容性问题
  • 改进错误处理和异常捕获机制
  • 优化代码注释和函数级文档

• 修复了volumes挂载权限处理逻辑,移除不必要的:rw后缀,只在只读模式时添加:ro后缀
• 优化了healthcheck的CMD-SHELL格式处理,确保生成符合Docker Compose规范的配置
• 改进了volumes处理逻辑,使生成的compose文件更简洁,符合Docker Compose最佳实践
• 添加了healthcheck处理过程的调试日志输出,便于跟踪问题
• 完善了代码注释和错误处理逻辑
• 修复了cron表达式的时区问题,确保定时任务在正确的时区执行
• 修复了extra_hosts配置处理,现在能够正确从容器的HostConfig.ExtraHosts获取配置

• 改进了macvlan网络配置处理,现在能够正确导出IPv4地址、IPv6地址和MAC地址
• 优化了volumes处理逻辑,支持中文路径,确保在生成的compose文件中保留原始路径
• 修复了链接处理逻辑,现在能够正确处理容器链接格式
• 改进了YAML生成逻辑,使用自定义Dumper类确保正确的缩进格式
• 添加了更多错误处理和日志输出,便于调试和跟踪处理过程

• 添加了command、entrypoint的生成,若环境变量配置NAS配置为ZOS,则不生成
• 添加了环境变量:NAS、CRON、TZ、NETWORK
• 支持定时执行,支持标准CRON表达式;支持一次性任务执行(CRON=once)
• 重新修改yaml文件生成路径,在./compose/路径下,按YYYY-MM-DD-HH-MM时间戳组织输出文件
• 完善日志输出内容;完善README.md
• 创建Github Action,自动构建并推送到github和阿里云
• 适配 amd64/arm64/arm7 架构