Flus项目Docker Compose部署架构深度解析

项目概述

Flus是一个基于PHP开发的Web应用项目，采用现代化的技术栈构建。通过分析其docker-compose.yml配置文件，我们可以深入了解该项目的服务架构和部署方式。

核心服务组件

1. PHP应用服务

php:
    image: flus_php:dev
    build:
        context: .
        dockerfile: Dockerfile.php
    restart: unless-stopped
    volumes:
        - ..:/var/www/html:z
        - composer:/tmp
    environment:
        - SEED
        - MOCK_HOST=http://nginx:8001
    user: $USER

这是项目的主服务，特点包括：

• 使用自定义构建的PHP镜像(flus_php:dev)
• 采用Dockerfile.php进行构建
• 自动重启策略(除非手动停止)
• 将项目代码挂载到容器内的/var/www/html目录
• 使用命名卷composer缓存依赖
• 支持环境变量配置(SEED和MOCK_HOST)
• 使用宿主机用户权限运行，避免权限问题

2. 后台任务处理服务

job_worker:
    image: flus_php:dev
    command: php cli jobs watch
    # 其他配置与php服务类似

专门处理后台任务的独立服务：

• 复用PHP基础镜像
• 通过cli命令启动任务监听
• 与主服务共享代码和依赖
• 实现后台任务的异步处理

3. Nginx Web服务器

nginx:
    image: nginx:alpine
    ports:
        - "8000:8000"
        - "8001:8001"
    volumes:
        - ..:/var/www/html:z
        - ./nginx.conf:/etc/nginx/conf.d/default.conf:z

Web服务特点：

• 使用轻量级Alpine版Nginx
• 暴露8000(主服务)和8001(Mock服务)端口
• 自定义nginx.conf配置
• 共享项目代码目录

4. PostgreSQL数据库

database:
    image: postgres:13-alpine
    environment:
        POSTGRES_USER: postgres
        POSTGRES_PASSWORD: postgres
    ports:
        - "5432:5432"

数据库服务配置：

• PostgreSQL 13 Alpine版
• 默认用户/密码均为postgres
• 暴露标准5432端口
• 轻量级Alpine基础镜像

5. 前端资源构建服务

bundler:
    image: flus_node:dev
    build:
        context: .
        dockerfile: Dockerfile.node
    command: npm run watch
    working_dir: /app
    volumes:
        - ..:/app:z
    user: $USER

前端资源处理：

• 自定义Node.js镜像
• 运行npm watch命令监听文件变化
• 工作目录设置为/app
• 使用宿主机用户权限

部署架构设计理念

1. 微服务化设计：将不同功能拆分为独立服务
2. 开发友好：支持热重载(npm watch)和代码实时同步
3. 权限管理：使用宿主机用户避免权限问题
4. 资源隔离：通过命名卷管理依赖缓存
5. 轻量化：优先选择Alpine基础镜像

实际部署建议

1. 开发环境：

   • 直接使用此配置
   • 支持代码实时修改生效
   • 方便调试各个组件

2. 生产环境：

   • 移除开发专用服务(job_worker可保留)
   • 替换为生产级镜像(去掉dev标签)
   • 配置适当的资源限制
   • 设置更严格的安全参数

常见问题解决方案

1. 权限问题：确保宿主机用户有适当权限
2. 端口冲突：根据需要调整暴露端口
3. 构建失败：检查Dockerfile.php和Dockerfile.node
4. 数据库持久化：考虑添加数据卷配置

通过这套Docker Compose配置，Flus项目实现了开发环境的快速搭建和标准化部署，大大降低了开发者的环境配置门槛。