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

概述

Nocobase作为一个现代化的应用开发平台，其Docker Compose配置文件精心设计了多服务协同工作的架构。本文将深入剖析这个docker-compose.yml文件的技术细节，帮助开发者理解其设计理念和实现方式。

网络架构设计

文件首先定义了一个名为nocobase的桥接网络，这种设计确保了所有服务能够在一个隔离的网络环境中通信，同时保持必要的网络隔离性。桥接网络模式在Docker环境中提供了良好的性能和灵活性。

核心服务解析

1. Verdaccio私有NPM仓库

verdaccio:
  image: verdaccio/verdaccio
  networks:
    - nocobase
  environment:
    VERDACCIO_PORT: ${VERDACCIO_PORT}
  restart: always
  ports:
    - "${VERDACCIO_PORT}:${VERDACCIO_PORT}"

Verdaccio作为轻量级私有NPM仓库，为项目提供了：

• 私有包管理能力
• 缓存公共包功能
• 开发环境下的包版本控制

端口通过环境变量VERDACCIO_PORT配置，增强了部署的灵活性。

2. 数据库服务集群

Nocobase支持多种数据库后端，体现了其多数据库适配的设计理念：

MySQL服务

mysql:
  image: mysql:8
  environment:
    MYSQL_DATABASE: ${DB_DATABASE}
    MYSQL_USER: ${DB_USER}
    MYSQL_PASSWORD: ${DB_PASSWORD}
    MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
  ports:
    - "${DB_MYSQL_PORT}:3306"

• 使用MySQL 8最新版本
• 通过环境变量配置数据库名、用户和密码
• 标准MySQL端口映射

Kingbase服务

kingbase:
  image: registry.cn-shanghai.aliyuncs.com/nocobase/kingbase:v009r001c001b0030_single_x86
  platform: linux/amd64
  privileged: true
  ports:
    - "${DB_KINGBASE_PORT}:54321"
  environment:
    DB_USER: ${DB_USER}
    DB_PASSWORD: ${DB_PASSWORD}
    DB_MODE: pg

• 使用定制的Kingbase镜像（兼容PostgreSQL协议）
• 需要特权模式运行
• 配置为PostgreSQL兼容模式
• 数据持久化到本地./storage/db/kingbase目录

PostgreSQL服务

postgres:
  image: postgres:latest
  command: postgres -c wal_level=logical
  ports:
    - "${DB_POSTGRES_PORT}:5432"
  environment:
    POSTGRES_USER: ${DB_USER}
    POSTGRES_DB: ${DB_DATABASE}
    POSTGRES_PASSWORD: ${DB_PASSWORD}

• 使用最新版PostgreSQL
• 配置了逻辑解码(wal_level=logical)，支持高级复制功能
• 数据备份目录映射到本地./storage/db/postgres/backups

3. Adminer数据库管理工具

adminer:
  image: nocobase/adminer
  ports:
    - ${ADMINER_PORT}:8080
  volumes:
    - ./:/var/www/app

• 定制化的Adminer镜像
• 提供Web界面的数据库管理能力
• 项目目录映射到容器内，便于开发调试

4. Nocobase应用服务

nocobase:
  image: node:16-stretch-slim
  command: [ "yarn", "start" ]
  working_dir: /app
  env_file: ./.env
  volumes:
    - ./:/app
  ports:
    - "${APP_PORT}:${APP_PORT}"

• 基于Node.js 16的轻量级镜像
• 使用Yarn启动应用
• 工作目录设置为/app
• 通过.env文件加载环境变量
• 项目代码实时映射到容器内，支持热更新开发
• 应用端口可配置

环境变量设计

配置文件中大量使用环境变量，体现了良好的配置与代码分离原则：

• VERDACCIO_PORT: Verdaccio服务端口
• DB_*系列: 数据库相关配置(用户、密码、端口等)
• ADMINER_PORT: 数据库管理界面端口
• APP_PORT: 应用服务端口

这种设计使得部署时可以灵活调整各服务配置，而无需修改Compose文件本身。

数据持久化策略

关键数据通过卷(volumes)映射实现持久化：

1. Kingbase数据: ./storage/db/kingbase
2. PostgreSQL备份: ./storage/db/postgres/backups
3. 应用代码: ./映射到容器内/app

这种设计确保了：

• 数据安全不随容器销毁而丢失
• 开发时代码变更实时生效
• 备份数据易于管理

服务健康保障

所有关键服务都配置了restart: always策略，确保服务异常退出后自动重启，提高了系统的可靠性。

部署建议

1. 准备.env文件：根据实际环境配置各服务端口和凭证
2. 数据目录权限：确保./storage目录有正确写入权限
3. 资源分配：根据预期负载调整各服务资源限制
4. 网络隔离：生产环境应考虑更严格的网络策略

总结

Nocobase的Docker Compose配置展现了一个精心设计的微服务架构，具有以下特点：

1. 多数据库支持，适应不同技术栈需求
2. 完善的开发工具链(私有NPM+数据库管理)
3. 灵活的配置管理
4. 可靠的数据持久化方案
5. 良好的开发者体验

理解这个配置文件的结构和设计理念，将帮助开发者更好地部署和维护Nocobase应用，也能为设计类似系统提供参考。