peekvision/peek-mongo

MongoDB副本集专用Docker镜像

镜像概述

本镜像基于官方MongoDB镜像优化，专为MongoDB副本集（Replica Set）部署设计，简化了副本集的配置与运行流程。通过该镜像可快速构建包含主节点（Primary）、从节点（Secondary）和仲裁节点（Arbiter）的MongoDB集群，提供数据冗余、读写分离和自动故障转移能力，适用于对数据可用性有较高要求的场景。

核心功能和特性

• 原生支持副本集配置：内置副本集初始化和管理能力，无需手动修改配置文件
• 与官方MongoDB完全兼容：基于最新稳定版MongoDB官方镜像构建，支持所有原生功能
• 简化集群部署：提供预设脚本和环境变量，降低副本集搭建复杂度
• 灵活的配置扩展：支持自定义副本集名称、节点角色、网络配置等参数
• 数据持久化：默认支持数据卷挂载，确保容器重启后数据不丢失
• 安全增强：支持配置数据库认证、TLS/SSL加密（需配合环境变量）

使用场景和适用范围

• 生产环境高可用部署：需要数据冗余和自动故障转移的关键业务系统
• 读写分离架构：通过副本集实现读操作分流，提升查询性能
• 灾备方案：跨节点/跨区域部署副本集，提供数据容灾能力
• 开发测试环境：快速模拟生产级副本集环境，验证集群功能

使用方法和配置说明

基础环境要求

• Docker Engine 20.10+
• Docker Compose 2.0+（推荐用于多节点部署）
• 节点间网络互通（副本集成员需能相互访问）

1. 单节点副本集（测试用）

bash
docker run -d \
  --name mongo-replica \
  -p 27017:27017 \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=password \
  -e REPLICA_SET_NAME=rs0 \
  -v mongo-data:/data/db \
  mongo:latest --replSet rs0 --bind_ip_all

2. 多节点副本集（docker-compose示例）

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  mongo1:
    image: mongo:latest
    container_name: mongo1
    ports:
      - "27017:27017"
    environment:
      - MONGO_INITDB_ROOT_USERNAME=admin
      - MONGO_INITDB_ROOT_PASSWORD=password
      - REPLICA_SET_NAME=rs0
    volumes:
      - mongo1-data:/data/db
    command: --replSet rs0 --bind_ip_all
    networks:
      - mongo-replica-net

  mongo2:
    image: mongo:latest
    container_name: mongo2
    ports:
      - "27018:27017"
    environment:
      - MONGO_INITDB_ROOT_USERNAME=admin
      - MONGO_INITDB_ROOT_PASSWORD=password
    volumes:
      - mongo2-data:/data/db
    command: --replSet rs0 --bind_ip_all
    networks:
      - mongo-replica-net

  mongo3:
    image: mongo:latest
    container_name: mongo3
    ports:
      - "27019:27017"
    environment:
      - MONGO_INITDB_ROOT_USERNAME=admin
      - MONGO_INITDB_ROOT_PASSWORD=password
    volumes:
      - mongo3-data:/data/db
    command: --replSet rs0 --bind_ip_all
    networks:
      - mongo-replica-net

volumes:
  mongo1-data:
  mongo2-data:
  mongo3-data:

networks:
  mongo-replica-net:
    driver: bridge

启动集群：

bash
docker-compose up -d

3. 副本集初始化

1. 进入主节点容器：

bash
docker exec -it mongo1 mongosh -u admin -p password --authenticationDatabase admin

2. 执行初始化命令：

javascript
rs.initiate({
  _id: "rs0",
  members: [
    {_id: 0, host: "mongo1:27017"},
    {_id: 1, host: "mongo2:27017"},
    {_id: 2, host: "mongo3:27017"}
  ]
})

3. 验证副本集状态：

javascript
rs.status()

4. 关键环境变量说明

5. 数据持久化配置

通过Docker卷（Volume）挂载/data/db目录实现数据持久化，示例：

bash
docker run -d \
  -v /host/path/to/data:/data/db \
  --name mongo-replica \
  mongo:latest --replSet rs0

6. 加入现有副本集

若需向现有副本集添加新节点，启动新容器后执行：

javascript
rs.add("new-node-host:27017")

注意事项

• 生产环境中建议为副本集配置认证（启用--auth参数）和TLS/SSL加密
• 副本集成员间需保证网络互通，节点主机名/IP需能被所有成员解析
• 仲裁节点（Arbiter）仅参与投票，不存储数据，可通过rs.addArb("arbiter-host:27017")添加
• 避免在单个物理机上部署所有副本集成员，以防单点故障