jackietreehorn/mongo-replica-ctrl repository overview

1.04

Automated MongoDB ReplicaSet management for Docker Swarm environments.
Handles initialization, redeployment, scaling, and primary failover with intelligent
configuration detection and optimized performance.

- MongoDB 8.0.x (compatible with 7.x/8.x) - image uses 8.0.13
- PyMongo >= 4.15,<5 - image uses 4.15.1
- Docker SDK >= 7,<9

• Smart Fresh Deployment: Initializes replica set with intelligent node detection
• Intelligent Redeployment: Detects IP changes and updates configuration immediately
• Dynamic Scaling: Real-time node addition/removal with automatic reconfiguration
• Primary Failover: Monitors and handles primary election failures
• Advanced Startup Logic: Robust retry handling for MongoDB transitional states
• Performance Optimized: Fast reconfiguration using current task IPs
• Production Logging: Clear, contextual messages without misleading errors

• Use with docker-compose stack and MongoDB global service (max 1 replica per node)
• Single controller instance per stack (global deployment mode)
• Configure via environment variables

1. Build: ./build.sh OR use jackietreehorn/mongo-replica-ctrl:latest
2. Deploy: ./deploy.sh (imports .env and deploys stack)

https://github.com/JackieTreeh0rn/MongoDB-ReplicaSet-Manager