ddmal/rodan-main

Rodan Docker镜像

镜像概述和主要用途

本仓库包含的Docker镜像可用于在本地设置https://github.com/DDMAL/rodan进行开发，稍作修改后也可在未来部署到Swarm生产环境。有关Rodan部署的更多信息，请参见https://github.com/DDMAL/rodan-docker/wiki。

核心功能和特性

• 简化安装流程：在所有平台上简化Rodan的安装过程
• 维护清晰文档：提供明确的安装和使用说明

使用场景和适用范围

开发Rodan或Rodan Jobs

• 前置条件：确保在${repository_root}/rodan/code中克隆Rodan子模块，并与目标分支（develop分支或功能分支，master分支仅用于版本发布）保持同步。
• 操作步骤：
  • 遵循文档：https://github.com/DDMAL/rodan-docker/wiki/Working-on-Rodan
  • 若开发作业（Jobs），需在Docker环境中单独安装作业，所有依赖已预安装，可参考容器内作业安装脚本：${repository_root}/scripts/install_rodan_jobs和${repository_root}/scripts/install_python3_rodan_jobs
  • 安装脚本中的BRANCHES环境变量可通过本地命令设置：export BRANCHES="develop"

开发Rodan-Client

• 前置条件：确保在${repository_root}/rodan-client/code中克隆Rodan-Client，并与目标分支保持同步。
• 操作步骤：遵循文档：https://github.com/DDMAL/rodan-docker/wiki/Working-on-Rodan-Client

与运行中容器交互的提示

常用Docker命令

• 查看所有运行中容器：docker ps
• 在容器与主机间复制文件：docker cp（类似scp命令）
• 监控容器资源：docker top

连接容器

使用docker-compose exec连接特定容器（比docker exec更简便，会自动搜索docker-compose.yml配置）：

• 命令格式：docker-compose exec <service_name> <command>
• 示例：docker-compose exec rodan bash 或 docker-compose exec celery bash（用于问题排查）
• 注意：不应在容器内编辑文件，应使用docker volumes和容器外的IDE进行编辑。

更多命令参考https://docs.docker.com/engine/reference/commandline/cli/。

自动构建

• 构建机制：镜像每日凌晨2点通过cron job自动重建并推送，由夜间脚本实现。
• 触发方式：提交代码可触发重建，但因认证问题，rodan-docker GitHub仓库需连接Bitbucket私有仓库。
• 预期结果：每日生成5个或更多新镜像（若有新版本发布）。

补充信息

关于Docker卷的更多信息，参见Docker文档：https://docs.docker.com/engine/admin/volumes/volumes/及https://docs.docker.com/compose/compose-file/#volumes。