solisoft/fasty项目Docker容器化部署指南

项目架构概述

solisoft/fasty是一个采用微服务架构的Web应用项目，通过docker-compose.yml文件我们可以清晰地看到其由三个核心服务组件构成：前端服务(foxxy)、内容管理系统(cms)以及生产环境CMS(cms_prod)，所有服务都依赖于ArangoDB数据库服务。

服务组件详解

1. Foxxy前端服务

Foxxy是基于Node.js构建的前端服务，关键配置包括：

• 使用自定义Dockerfile_node构建镜像
• 启动时自动执行yarn安装依赖并启动服务
• 端口映射：将容器4001端口映射到宿主机4002端口
• 采用volume挂载实现代码热更新
• 通过depends_on确保数据库服务先启动

技术亮点：

• 使用node_modules卷避免主机与容器间的依赖冲突
• 通过links建立与数据库服务的网络连接

2. CMS开发环境服务

CMS是项目的核心后端服务，主要特征：

• 使用基础Dockerfile构建
• 采用Lua框架Lapis运行开发服务器
• 端口8080映射到宿主机8081
• 挂载整个项目目录实现实时开发
• 依赖数据库和前端服务

特殊配置：

• 固定IPv4地址14.12.0.7便于内部通信
• 使用delegated挂载选项优化性能

3. CMS生产环境服务

专为生产环境优化的CMS服务：

• 自动重启机制确保高可用性
• 启动时预编译所有MoonScript文件
• 使用Lapis生产模式
• 80端口映射到宿主机9091
• 同样固定IP为14.12.0.8

4. ArangoDB数据库服务

项目使用的多模型数据库：

• 官方最新镜像
• 设置root密码为"password"
• 8529端口对外暴露管理界面
• 数据持久化配置：
  • 数据库数据卷
  • 应用数据卷
  • 备份目录挂载

网络配置

项目采用自定义网络fasty：

• 子网划分：14.12.0.0/24
• 为关键服务分配静态IP
• 实现服务间隔离通信

数据持久化方案

精心设计的volume策略：

1. arangodb-data：存储数据库核心数据
2. arangodb-app：存储数据库应用数据
3. node_modules：前端依赖隔离
4. node_modules_resize：预留扩展卷

部署实践建议

1. 开发环境：

• 使用cms服务进行开发
• 利用volume实时查看代码变更
• 通过foxxy服务调试前端

2. 生产部署：

• 使用cms_prod服务
• 注意修改默认数据库密码
• 考虑添加nginx反向代理

3. 数据库管理：

• 通过8529端口访问web界面
• 定期备份/dump目录数据

安全注意事项

1. 生产环境务必修改：

• ARANGO_ROOT_PASSWORD
• 各服务暴露端口

2. 网络隔离：

• 考虑添加网络限制规则
• 非必要不暴露数据库端口

这个docker-compose配置展示了现代Web应用的典型容器化部署方案，通过服务拆分、网络隔离和数据持久化等设计，为开发者提供了从开发到生产的完整环境支持。