Ultimate Backend项目开发环境Docker Compose配置详解

项目概述

Ultimate Backend是一个现代化的后端服务架构项目，采用微服务架构设计，包含了账户管理、访问控制、计费系统、通知服务等多个功能模块。本文重点分析其开发环境下的Docker Compose配置文件，帮助开发者理解项目的服务架构和依赖关系。

核心服务组件

1. 微服务模块

项目包含以下核心微服务模块，每个模块都有独立的Dockerfile构建配置：

• service-account：账户服务，监听50054端口
• service-access：访问控制服务，监听50089端口
• service-billing：计费服务，监听50067端口
• service-notification：通知服务，监听50044端口
• service-role：角色管理服务，监听50052端口
• service-tenant：租户管理服务，监听50053端口
• service-webhook：Webhook服务，监听50049端口
• api-admin：管理API服务，监听50020端口

所有服务都配置了restart: always策略，确保服务异常退出后自动重启，这在开发环境中特别有用。

2. 基础设施服务

项目依赖以下基础设施服务：

• Consul：服务发现与配置中心
• EventStore：事件存储数据库
• NATS：高性能消息系统
• MongoDB：文档数据库
• Redis：内存数据存储

关键配置解析

服务依赖关系

所有微服务都依赖于Consul和Redis服务，通过depends_on明确声明：

depends_on:
  - consul
  - redis

这种设计确保了服务启动顺序，基础服务会先于业务服务启动。

环境变量配置

各微服务通过环境变量配置关键连接信息：

environment:
  - CONSUL_HOST=consul
  - NATS_HOST=nats
  - DISCOVERY_HOST=localhost

这种配置方式使得服务可以在不同环境中灵活部署，只需修改环境变量即可适应不同环境。

端口映射

每个服务都暴露了特定的端口供外部访问，例如：

ports:
  - 50054:50054  # service-account
  - 50089:50089  # service-access

这种设计便于开发调试，可以直接通过本地端口访问各个服务。

基础设施服务配置

Consul配置

consul:
  command: ["agent", "-server", "-bootstrap", "-ui", "-client", "0.0.0.0"]

配置Consul以服务器模式运行，启用Web UI，并允许所有客户端连接。

EventStore配置

使用EventStore 5.0.8版本，暴露2113(HTTP)和1113(TCP)端口，用于事件存储和查询。

NATS配置

NATS消息系统暴露4222(客户端)、6222(集群)和8222(监控)端口，支持微服务间的异步通信。

MongoDB配置

environment:
  MONGO_INITDB_ROOT_USERNAME: root
  MONGO_INITDB_ROOT_PASSWORD: changeit

配置了默认的root用户和密码，生产环境中应使用更安全的凭证。

开发环境特点

1. 构建参数：所有服务构建时都传入NODE_ENV=development参数
2. 镜像策略：使用latest标签，便于频繁更新
3. 服务发现：依赖Consul实现服务注册与发现
4. 消息系统：使用NATS作为服务间通信总线

部署建议

1. 开发环境下可以直接使用此配置启动所有服务
2. 注意MongoDB和Redis没有设置数据持久化，适合开发但不适合生产
3. 各服务的端口映射可以根据实际开发需要进行调整
4. 监控Consul UI(8500端口)可以查看服务注册情况

总结

Ultimate Backend的Docker Compose开发配置展示了一个典型的微服务架构，包含了服务发现、消息总线、多种数据库等现代后端系统所需的基础组件。通过容器化部署，开发者可以快速搭建完整的开发环境，各服务之间界限清晰，便于独立开发和测试。