felipegasper298/mongo-provision

Mongo Provision镜像说明

镜像概述

该镜像用于快速搭建MongoDB测试集群，所有集群节点运行在单个容器内，支持副本集和分片集群模式，适用于开发和测试场景，无需复杂的集群部署流程。

核心功能

• 支持创建多节点MongoDB副本集（replica set）
• 支持搭建分片集群（sharded cluster）
• 使用mtools和m工具简化集群配置
• 支持预下载MongoDB二进制文件以加速启动
• 提供就绪检查机制，方便验证集群状态

使用场景

• 开发人员快速搭建测试用MongoDB集群
• 测试MongoDB集群的高可用性和分片功能
• 学习MongoDB集群配置和管理

配置说明

基本用法（Docker Hub）

启动3节点副本集

bash
docker run -it --rm -p27017-27019:27017-27019 felipegasper298/mongo-provision 8.0 --replicaset --nodes 3

启动分片集群（3个分片，每个分片3节点）

bash
docker run -it --rm -p27017:27017 felipegasper298/mongo-provision 8.0 --replicaset --sharded 3 --nodes 3

容器会持续运行直到手动终止（如CTRL-C）。

连接集群

在另一个终端中运行以下命令连接集群：

连接副本集

bash
mongosh mongodb://localhost:27017,localhost:27018,localhost:27019

连接分片集群

bash
mongosh mongodb://localhost:27017

本地构建镜像

bash
docker build . -t mongo-provision

构建后使用本地镜像替代Docker Hub镜像即可。

参数说明

容器参数包括：

• MongoDB版本号（如8.0）
• mtools的init子命令参数（如--replicaset、--sharded等）

数据持久化

容器将状态数据（如mongod数据文件）存储在/data目录，可通过挂载卷保留数据：

bash
docker run -it --rm -v ./mongo-data:/data -p27017-27019:27017-27019 felipegasper298/mongo-provision 8.0 --replicaset --nodes 3

预下载二进制文件

若/data/bin/mongod存在且版本匹配，容器将直接使用该二进制文件，否则自动下载。分片集群需同时提供mongod和mongos二进制文件。

就绪检查

通过检查容器内ready文件判断集群是否就绪：

bash
while ! docker exec my-container-name [ -e ready ]; do
    echo "等待集群就绪中..."
    sleep 1
done

ready文件包含连接字符串等信息。

注意事项

• 需提前映射所需端口（如副本集需映射27017-27019）
• 容器平台影响MongoDB版本可用性（如Linux/ARM64不支持v5之前版本，可指定--platform linux/amd64）

致谢

该镜像使用以下工具：

• https://github.com/rueckstiess/mtools
• https://github.com/aheckmann/m