settlemint/mongo

settlemint/mongo 镜像文档

镜像概述和主要用途

settlemint/mongo是一个基于MongoDB 4构建的Docker镜像，内置了副本集(replicaset)设置脚本，专门用于快速部署支持变更流(Change Streams)功能的MongoDB环境。变更流功能允许应用程序实时监听数据库集合中的数据变更，适用于需要实时数据同步或事件驱动的场景。

核心功能和特性

• 基于MongoDB 4：提供稳定的MongoDB 4数据库环境
• 内置副本集设置脚本：包含replicaset.sh脚本，简化副本集配置流程
• 支持变更流功能：通过副本集配置启用MongoDB变更流，实现数据变更的实时监听
• 易于部署：可通过Docker Compose快速搭建完整的副本集环境

使用场景和适用范围

• 开发环境中需要快速验证基于变更流的功能
• 构建实时数据同步系统，如数据复制、缓存更新等
• 事件驱动架构中需要响应数据变更的应用
• 测试环境中模拟生产级MongoDB副本集配置

使用方法和配置说明

Docker Compose部署示例

以下是使用Docker Compose部署的完整配置：

yaml
version: '3.6'

services:
  mongo:
    container_name: 'mongo'
    image: 'settlemint/mongo:latest'
    command: mongod --replSet replicaset  # 启动MongoDB并启用副本集模式
    hostname: mongo  # 设置主机名，确保副本集配置正确
    ports:
      - '27017:27017'  # 映射MongoDB默认端口

  mongo-replicaset-setup:
    container_name: 'mongo-replicaset-setup'
    image: 'settlemint/mongo:latest'
    depends_on:
      - 'mongo'  # 依赖mongo服务，确保MongoDB先启动
    links:
      - mongo:mongo  # 链接到mongo服务
    entrypoint: [ './replicaset.sh' ]  # 执行副本集设置脚本

连接方式

部署完成后，可通过以下方式连接到MongoDB：

通过Studio 3T连接

使用Studio 3T图形化工具连接，配置参考：<[***]>

通过连接字符串连接

使用MongoDB连接字符串：

mongodb://localhost:27017/?replicaSet=replicaset&readPreference=primaryPreferred

注意事项

• 该配置为单节点副本集，适用于开发和测试环境，生产环境需配置多节点副本集
• 确保主机名配置正确，否则副本集初始化可能失败
• 首次启动时，mongo-replicaset-setup服务会自动执行副本集初始化脚本，完成后可停止该服务