bhanji/mongo-single-node-replica

MongoDB单节点副本集镜像

镜像概述

该镜像专为本地开发场景设计，提供一键式单节点MongoDB副本集环境。通过自动配置副本集初始化流程，简化开发者在本地搭建依赖MongoDB副本集功能（如事务、变更流、读偏好设置）的应用开发与测试流程。

核心功能与特性

• 单节点副本集自动配置：启动容器后自动完成副本集初始化，无需手动执行rs.initiate()等命令
• 保留副本集核心功能：支持MongoDB副本集相关操作，包括事务、读写分离配置、副本集状态查询等
• 轻量级本地开发优化：针对本地开发环境资源限制优化，无需部署多节点集群即可模拟副本集环境
• 与标准MongoDB兼容：基于官方MongoDB镜像构建，保持API兼容性，支持标准MongoDB客户端连接

使用场景

• 开发依赖MongoDB副本集特性的应用（如使用分布式事务、变更流监听）
• 本地测试副本集相关功能代码，验证读写分离、故障转移逻辑（模拟场景）
• 简化开发环境配置，避免手动搭建多节点副本集的复杂性

使用方法

基本启动命令

bash
docker run -d -p 27017:27017 --name mongo-rs-local [镜像名称]

参数说明：

• -p 27017:27017：映射MongoDB默认端口到宿主机，允许本地客户端连接
• --name mongo-rs-local：指定容器名称，便于后续管理
• [镜像名称]：替换为实际镜像标签（如mongodb-single-replica:latest）

数据持久化配置

通过Docker数据卷挂载数据目录，避免容器重启后数据丢失：

bash
docker run -d \
  -p 27017:27017 \
  -v mongo-rs-data:/data/db \
  --name mongo-rs-local \
  [镜像名称]

其中mongo-rs-data为持久化数据卷名称，首次运行会自动创建

自定义副本集名称

默认副本集名称为rs0，可通过环境变量REPLICA_SET_NAME自定义：

bash
docker run -d \
  -p 27017:27017 \
  -e REPLICA_SET_NAME=my-replica-set \
  --name mongo-rs-local \
  [镜像名称]

客户端连接验证

启动后通过MongoDB客户端验证副本集状态：

bash
# 连接容器内MongoDB
docker exec -it mongo-rs-local mongosh

# 查看副本集状态
rs.status()

成功连接后，副本集状态应显示"ok" : 1，且成员列表包含当前单节点。

配置参数说明

环境变量

持久化与备份

建议通过数据卷进行持久化，备份数据可直接导出卷内容：

bash
# 备份数据卷
docker run --rm -v mongo-rs-data:/source -v $(pwd):/backup alpine tar -czf /backup/mongo-rs-backup.tar.gz -C /source .

注意事项

• 生产环境禁用：单节点副本集不具备高可用性和数据冗余能力，仅用于开发测试，生产环境需部署标准多节点副本集
• 性能限制：本地开发环境资源有限，请勿用于高并发测试场景
• 版本兼容性：使用时需确认镜像MongoDB版本与应用依赖版本匹配，避免兼容性问题