mirror of
https://github.com/rustfs/rustfs.git
synced 2026-01-17 01:30:33 +00:00
ad99019749
* Initial plan * Add MNMD Docker deployment example with 4 nodes x 4 drives - Create docs/examples/mnmd/ directory structure - Add docker-compose.yml with proper disk indexing (1..4) - Add wait-and-start.sh for startup coordination - Add README.md with usage instructions and alternatives - Add CHECKLIST.md with step-by-step verification - Fixes VolumeNotFound issue by using correct volume paths - Implements health checks and startup ordering - Uses service names for stable inter-node addressing Co-authored-by: houseme <4829346+houseme@users.noreply.github.com> * Add docs/examples README as index for deployment examples Co-authored-by: houseme <4829346+houseme@users.noreply.github.com> * Add automated test script for MNMD deployment - Add test-deployment.sh with comprehensive validation - Test container status, health, endpoints, connectivity - Update README to reference test script - Make script executable Co-authored-by: houseme <4829346+houseme@users.noreply.github.com> * improve code * improve code * improve dep crates `cargo shear --fix` * upgrade aws-sdk-s3 --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: houseme <4829346+houseme@users.noreply.github.com> Co-authored-by: houseme <housemecn@gmail.com>
RustFS Deployment Examples
This directory contains practical deployment examples and configurations for RustFS.
Available Examples
MNMD (Multi-Node Multi-Drive)
Complete Docker Compose example for deploying RustFS in a 4-node, 4-drive-per-node configuration.
Features:
- Proper disk indexing (1..4) to avoid VolumeNotFound errors
- Startup coordination via
wait-and-start.shscript - Service discovery using Docker service names
- Health checks with alternatives for different base images
- Comprehensive documentation and verification checklist
Use Case: Production-ready multi-node deployment for high availability and performance.
Quick Start:
cd docs/examples/mnmd
docker-compose up -d
See also:
- MNMD README - Detailed usage guide
- MNMD CHECKLIST - Step-by-step verification
Other Deployment Examples
For additional deployment examples, see:
examples/- Root-level examples directory with:docker-quickstart.sh- Quick start script for basic deploymentsenhanced-docker-deployment.sh- Advanced deployment scenariosdocker-comprehensive.yml- Docker Compose with multiple profiles
.docker/compose/- Docker Compose configurations:docker-compose.cluster.yaml- Basic cluster setupdocker-compose.observability.yaml- Observability stack integration
Related Documentation
Contributing
When adding new examples:
- Create a dedicated subdirectory under
docs/examples/ - Include a comprehensive README.md
- Provide working configuration files
- Add verification steps or checklists
- Document common issues and troubleshooting
Support
For issues or questions:
- GitHub Issues: https://github.com/rustfs/rustfs/issues
- Documentation: https://rustfs.io