sptrakesh/mongo-service

Mongo Service 镜像文档

镜像概述

Mongo Service 是一个TCP服务镜像，旨在通过集中式服务将所有请求路由到MongoDB，提供统一的请求管理和路由功能，简化多应用与MongoDB的交互流程。

核心功能和特性

• TCP协议支持：基于TCP协议实现请求接收与处理
• 集中式路由：统一接收并转发所有MongoDB请求
• 灵活配置：支持自定义MongoDB连接参数、数据库及集合名称
• 日志持久化：可通过卷挂载实现服务日志的持久化存储
• MongoDB集成：无缝对接MongoDB，支持认证及连接优化参数（如压缩、写入确认等）

使用场景和适用范围

• 多应用共享MongoDB连接的分布式环境
• 需要集中监控和管理MongoDB请求的场景
• 需统一控制MongoDB访问入口的架构设计
• 对MongoDB请求进行集中日志记录与审计的系统

使用方法和配置说明

环境变量配置

端口映射

• 容器内部端口：2000（服务默认监听端口）
• 建议主机端口映射：2000:2000（可根据实际需求调整主机端口）

卷挂载

• 日志存储路径：/opt/spt/logs（容器内日志目录）
• 建议挂载主机目录以实现日志持久化，如：$DATA_DIR/mongo-service:/opt/spt/logs

部署示例

Docker Compose 配置

以下是包含MongoDB服务和Mongo Service的完整部署配置：

yaml
version: '3.7'

services:
  mongo:
    image: docker.xuanyuan.run/mongo
    ports:
      - "27017:27017"  # MongoDB默认端口映射
    environment:
      MONGO_INITDB_ROOT_USERNAME: test  # MongoDB root用户名
      MONGO_INITDB_ROOT_PASSWORD: test  # MongoDB root密码
    volumes:
      - $DATA_DIR/mongo:/data/db  # MongoDB数据持久化存储

  mongo-service:
    image: docker.xuanyuan.run/mongo-service
    stop_signal: SIGTERM  # 指定服务停止信号
    ports:
      - "2000:2000"  # Mongo Service端口映射
    environment:
      - "MONGO_URI=mongodb://test:test@mongo/admin?authSource=admin&compressors=snappy&w=1"
      - VERSION_HISTORY_DATABASE=versionHistory
      - VERSION_HISTORY_COLLECTION=entities
      - METRICS_COLLECTION=metrics
    volumes:
      - $DATA_DIR/mongo-service:/opt/spt/logs  # 服务日志持久化

部署步骤

1. 设置数据目录环境变量：export DATA_DIR=/path/to/your/data/directory
2. 将上述配置保存为docker-compose.yml
3. 执行部署命令：docker-compose up -d
4. 验证服务状态：docker-compose ps