maestrano/mongo

docker-mongo

镜像概述和主要用途

docker-mongo是一个预配置的MongoDB Docker镜像，专门用于简化MongoDB副本集（Replica Set）的部署过程。副本集是MongoDB的高可用解决方案，通过多个节点存储数据副本，实现自动故障转移和数据冗余，确保服务持续可用。该镜像通过环境变量配置节点信息，支持快速搭建包含主节点和多个副本节点的集群。

核心功能和特性

• 内置副本集支持：无需手动配置副本集，通过环境变量即可自动组建集群
• 节点自动发现：副本节点可通过指定种子节点（PEER）自动加入集群
• 安全密钥配置：支持通过环境变量设置副本集通信密钥（MONGO_REP_KEY）
• 灵活端口映射：可自定义容器端口映射，适应不同网络环境需求

使用场景和适用范围

• 开发测试环境：快速搭建本地MongoDB副本集，验证集群功能
• 生产环境部署：构建高可用MongoDB集群，确保数据可靠性和服务连续性
• 数据冗余需求：需要多节点数据备份和自动故障转移的应用场景
• 分布式系统集成：作为分布式应用的数据库层，提供高可用数据服务

使用方法和配置说明

环境变量说明

部署示例（本地机器）

1. 准备环境变量

首先获取主机内网IP并设置基础参数：

sh
# 获取主机内网IP（以macOS为例，en0为网络接口；Linux系统可能为eth0等）
HOST_PUB_IP=$(ifconfig | grep en0 -A 5 | grep "inet " | cut -d' ' -f2)
# 副本集通信密钥（自定义，所有节点需一致）
REP_KEY=someprivatekey
# 节点端口映射（可自定义）
PORT_NODE_1=33001
PORT_NODE_2=33002
PORT_NODE_3=33003
# 主节点地址（作为种子节点）
PEER=$HOST_PUB_IP:$PORT_NODE_1

2. 启动主节点

sh
docker run -d -p $PORT_NODE_1:27017 \
  -e SELF_HOST=$HOST_PUB_IP \
  -e SELF_PORT=$PORT_NODE_1 \
  -e MONGO_REP_KEY=$REP_KEY \
  maestrano/mongo

3. 启动第一个副本节点

sh
docker run -d -p $PORT_NODE_2:27017 \
  -e MONGO_REP_PEERS=$PEER \
  -e SELF_HOST=$HOST_PUB_IP \
  -e SELF_PORT=$PORT_NODE_2 \
  -e MONGO_REP_KEY=$REP_KEY \
  maestrano/mongo

4. 启动第二个副本节点

sh
docker run -d -p $PORT_NODE_3:27017 \
  -e MONGO_REP_PEERS=$HOST_PUB_IP:$PORT_NODE_2,$PEER \
  -e SELF_HOST=$HOST_PUB_IP \
  -e SELF_PORT=$PORT_NODE_3 \
  -e MONGO_REP_KEY=$REP_KEY \
  maestrano/mongo

验证集群状态

部署完成后，可通过MongoDB客户端连接任意节点验证副本集状态：

sh
mongo --host $HOST_PUB_IP --port $PORT_NODE_1
> rs.status()  # 查看副本集状态，应显示3个节点（1个PRIMARY，2个SECONDARY）