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

前言

Vanilla项目采用Docker容器化部署方案，通过docker-compose.yml文件定义了一套完整的服务编排配置。本文将深入剖析该配置的技术细节，帮助开发者理解Vanilla项目的容器化架构设计。

服务架构概览

Vanilla项目的Docker-Compose配置主要包含三个核心服务组件：

1. 数据库服务：基于MySQL构建的数据存储层
2. 缓存服务：Memcached提供的高速缓存层
3. 应用服务：PHP-FPM处理业务逻辑的执行环境

这些服务通过自定义的vanilla-network网络相互连接，形成一个完整的应用运行环境。

数据库服务详解

database:
    build:
        context: "./images/mysql"
    container_name: "database"
    ports:
        - "3306:3306"
    environment:
        MYSQL_ALLOW_EMPTY_PASSWORD: "yes"
        MYSQL_DATABASE: vanilla_dev
    networks:
        - "vanilla-network"
    volumes:
        - "mysql8:/var/lib/mysql"
        - "logs-mysql8:/var/log/mysql"

数据库服务配置具有以下技术特点：

1. 自定义构建：使用项目内./images/mysql目录下的Dockerfile构建镜像，而非直接使用官方镜像，这为定制化配置提供了灵活性

2. 开发友好配置：

   • 允许空密码登录（MYSQL_ALLOW_EMPTY_PASSWORD），简化开发环境配置
   • 自动创建vanilla_dev数据库

3. 数据持久化：

   • 使用命名卷mysql8持久化数据库文件
   • 单独卷logs-mysql8存储日志文件，便于问题排查

4. 网络隔离：加入vanilla-network专用网络，确保服务间通信安全

缓存服务配置

memcached:
    build:
        context: "./images/memcached"
    networks:
        - "vanilla-network"
    container_name: memcached

Memcached服务配置相对简单但高效：

1. 自定义构建：同样采用项目内构建方式，位于./images/memcached目录

2. 网络配置：仅加入内部网络，不暴露外部端口，确保缓存服务安全

3. 命名容器：固定容器名便于其他服务连接

PHP应用服务剖析

php-fpm:
    build:
        context: "./images/php"
        dockerfile: "./8.0/Dockerfile"
        args:
            WWWGROUP: "${WWWGROUP}"
            WWWUSER: "${WWWUSER}"
    container_name: "php-fpm"
    networks:
        - "vanilla-network"
    volumes:
        - "./images/nginx/certs:/usr/local/share/ca-certificates"
        - "../../:/srv/vanilla-repositories"
        - "../:/srv/vanilla-repositories/vanilla:cached"
        - "../conf:/srv/vanilla-repositories/conf"
        - "/srv/vanilla-repositories/vanilla/.git"
        - "/srv/vanilla-repositories/vanilla/node_modules"
        - "/srv/vanilla-repositories/vanilla/.yarn"
        - /srv/vanilla-repositories/vanilla-queue-service
        - /srv/vanilla-repositories/vanilla-search-service

PHP-FPM服务是Vanilla项目的核心，其配置体现了以下设计考量：

1. 版本控制：明确使用PHP 8.0版本（通过指定Dockerfile路径）

2. 用户权限管理：

   • 通过构建参数WWWGROUP和WWWUSER动态设置运行用户
   • 确保容器内文件权限与宿主机一致

3. 证书管理：挂载自签名证书目录，为HTTPS支持做准备

4. 代码挂载策略：

   • 采用多级目录挂载确保项目结构一致性
   • 使用cached选项优化性能
   • 精心设计排除规则（.git、node_modules等）提升同步效率

5. 服务分离：明确排除队列服务和搜索服务目录，这些服务应运行在独立容器中

存储与网络配置

volumes:
    mysql8:
    logs-mysql8:

networks:
    vanilla-network:
        external: true
        driver: "bridge"
        name: "vanilla-network"

1. 数据卷设计：

   • mysql8：主数据库存储卷
   • logs-mysql8：日志专用卷，分离存储提高性能

2. 网络架构：

   • 使用预定义的external网络vanilla-network
   • 采用bridge驱动，平衡性能与隔离性
   • 网络预创建设计支持多项目协同

最佳实践与开发建议

1. 环境变量管理：建议将敏感配置如数据库密码通过.env文件管理

2. 性能优化：

   • 对于开发环境，可考虑增加PHP OPcache配置
   • 生产环境应移除空密码配置，增加安全措施

3. 扩展性考虑：

   • 当前架构易于添加新服务（如Redis、Elasticsearch等）
   • 队列服务和搜索服务的独立设计为微服务扩展奠定基础

4. 调试技巧：

   • 利用挂载的日志卷分析数据库问题
   • 通过修改挂载的代码实现实时调试

总结

Vanilla项目的Docker-Compose配置展现了一个经过精心设计的PHP应用容器化方案，平衡了开发便利性与生产就绪性。通过服务分离、网络隔离和智能挂载等策略，为开发者提供了高效的本地开发环境，同时也为生产部署奠定了良好基础。理解这些配置细节将帮助开发者更好地维护和扩展Vanilla项目。