fastcheck/DOCKER_SERVICES.md

Docker Services Setup

This project includes MongoDB and RabbitMQ running in Docker containers for development and production use.

Services Overview

MongoDB

• Container Name: duxiter-mongodb
• Image: mongo:7.0
• Port: 27017
• Username: admin
• Password: password123
• Database: duxiter
• Connection String: mongodb://admin:password123@localhost:27017/duxiter?authSource=admin

RabbitMQ

• Container Name: duxiter-rabbitmq
• Image: rabbitmq:3.12-management
• AMQP Port: 5672
• Management UI Port: 15672
• Username: admin
• Password: password123
• Management UI: http://localhost:15672
• Connection URL: amqp://admin:password123@localhost:5672

Quick Start

Prerequisites

• Docker installed and running
• Docker Compose installed

Starting Services

# Start all services in detached mode
sudo docker-compose up -d

# Check if services are running
sudo docker ps

Stopping Services

# Stop all services
sudo docker-compose down

# Stop and remove volumes (WARNING: This will delete all data)
sudo docker-compose down -v

Management Commands

General Docker Commands

# View running containers
sudo docker ps

# View all containers (including stopped)
sudo docker ps -a

# Restart all services
sudo docker-compose restart

# Restart specific service
sudo docker-compose restart mongodb
sudo docker-compose restart rabbitmq

Viewing Logs

# View MongoDB logs
sudo docker logs duxiter-mongodb

# View RabbitMQ logs
sudo docker logs duxiter-rabbitmq

# Follow logs in real-time
sudo docker logs -f duxiter-mongodb
sudo docker logs -f duxiter-rabbitmq

Service Health Checks

# Test MongoDB connection
sudo docker exec -it duxiter-mongodb mongosh --username admin --password password123 --authenticationDatabase admin --eval "db.adminCommand('ping')"

# Check RabbitMQ status
sudo docker exec -it duxiter-rabbitmq rabbitmqctl status

# List RabbitMQ users
sudo docker exec -it duxiter-rabbitmq rabbitmqctl list_users

Data Persistence

Data is automatically persisted using Docker volumes:

• duxiter_mongodb_data: MongoDB database files
• duxiter_mongodb_config: MongoDB configuration files
• duxiter_rabbitmq_data: RabbitMQ data and configuration

Volume Management

# List all volumes
sudo docker volume ls

# Inspect a specific volume
sudo docker volume inspect duxiter_mongodb_data

# Remove all volumes (WARNING: This will delete all data)
sudo docker volume prune

Network Configuration

Both services are connected via the duxiter-network bridge network, allowing:

• Inter-service communication using container names
• Isolated network environment
• External access through exposed ports

Application Integration

MongoDB Connection Examples

Node.js (using mongoose)

const mongoose = require('mongoose');

const connectionString = 'mongodb://admin:password123@localhost:27017/duxiter?authSource=admin';

mongoose.connect(connectionString, {
  useNewUrlParser: true,
  useUnifiedTopology: true
});

Python (using pymongo)

from pymongo import MongoClient

client = MongoClient('mongodb://admin:password123@localhost:27017/duxiter?authSource=admin')
db = client.duxiter

RabbitMQ Connection Examples

Node.js (using amqplib)

const amqp = require('amqplib');

const connection = await amqp.connect('amqp://admin:password123@localhost:5672');
const channel = await connection.createChannel();

Python (using pika)

import pika

credentials = pika.PlainCredentials('admin', 'password123')
connection = pika.BlockingConnection(
    pika.ConnectionParameters('localhost', 5672, '/', credentials)
)
channel = connection.channel()

Security Considerations

⚠️ Important: The default credentials are for development only. For production:

1. Change default passwords
2. Use environment variables for credentials
3. Configure proper network security
4. Enable SSL/TLS encryption
5. Implement proper backup strategies

Environment Variables

Create a .env file for production:

MONGO_USERNAME=your_secure_username
MONGO_PASSWORD=your_secure_password
RABBITMQ_USERNAME=your_secure_username
RABBITMQ_PASSWORD=your_secure_password

Troubleshooting

Common Issues

Port conflicts

# Check if ports are in use
sudo netstat -tulpn | grep :27017
sudo netstat -tulpn | grep :5672
sudo netstat -tulpn | grep :15672

Container won't start

# Check container logs for errors
sudo docker logs duxiter-mongodb
sudo docker logs duxiter-rabbitmq

# Check Docker daemon status
sudo systemctl status docker

Permission issues

# Ensure user is in docker group
sudo usermod -aG docker $USER
# Log out and back in for changes to take effect

Reset Everything

# Stop and remove containers, networks, and volumes
sudo docker-compose down -v

# Remove images (optional)
sudo docker rmi mongo:7.0 rabbitmq:3.12-management

# Start fresh
sudo docker-compose up -d

Monitoring

RabbitMQ Management Interface

Access the web interface at http://localhost:15672

• Username: admin
• Password: password123

Features:

• Queue monitoring
• Connection management
• Performance metrics
• User management

MongoDB Monitoring

# Connect to MongoDB shell
sudo docker exec -it duxiter-mongodb mongosh --username admin --password password123 --authenticationDatabase admin

# Check database status
db.adminCommand("serverStatus")

# List databases
show dbs

# List collections
use duxiter
show collections

Backup and Restore

MongoDB Backup

# Create backup
sudo docker exec duxiter-mongodb mongodump --username admin --password password123 --authenticationDatabase admin --db duxiter --out /backup

# Copy backup from container
sudo docker cp duxiter-mongodb:/backup ./mongodb-backup

MongoDB Restore

# Copy backup to container
sudo docker cp ./mongodb-backup duxiter-mongodb:/backup

# Restore database
sudo docker exec duxiter-mongodb mongorestore --username admin --password password123 --authenticationDatabase admin --db duxiter /backup/duxiter

Performance Tuning

MongoDB Optimization

• Adjust memory settings in docker-compose.yml
• Configure appropriate indexes
• Monitor slow queries

RabbitMQ Optimization

• Adjust memory and disk limits
• Configure queue policies
• Monitor message rates

Support

For issues related to:

• Docker: Check Docker documentation
• MongoDB: Check MongoDB documentation
• RabbitMQ: Check RabbitMQ documentation
• This setup: Check container logs and this documentation