Hướng Dẫn Sử Dụng NQDEV Containers

NQDEV Containers Docker License

Tài liệu hướng dẫn chi tiết về việc sử dụng các Docker container do NQDEV team phát triển. Tất cả các container đều được tối ưu cho production với hỗ trợ timezone Việt Nam và cấu hình bảo mật.

📋 Mục Lục

🌟 Tổng quan

NQDEV Containers là bộ sưu tập các Docker images được tùy chỉnh cho các ứng dụng phổ biến, với mục tiêu:

📦 Container Services

🌐 Web Services

NGINX (Proxy Server)

HAProxy (Load Balancer)

🗄️ Database Services

PostgreSQL + pgAgent

📨 Message Queue

RabbitMQ

📱 Applications

WordPress

🚀 Hướng dẫn cài đặt

Yêu cầu hệ thống

Cài đặt nhanh

# Clone repository
git clone https://github.com/nqdev-group/containers.git
cd containers/nqdev

# Chọn service cần sử dụng
cd nginx    # hoặc haproxy, postgres-pgagent, wordpress, rabbitmq

# Khởi chạy service
docker-compose up -d --build --force-recreate --remove-orphans

Cài đặt từng service

1. NGINX Proxy

cd nqdev/nginx/alpine
docker-compose up -d --build --force-recreate --remove-orphans

# Kiểm tra status
curl http://localhost:18080/nginx_status

2. HAProxy Load Balancer

cd nqdev/haproxy/alpine
docker-compose up -d --build --force-recreate --remove-orphans

# Truy cập stats dashboard
open http://localhost:17001

3. PostgreSQL + pgAgent

cd nqdev/postgres-pgagent
docker-compose up -d --build --force-recreate --remove-orphans

# Connect to database
psql -h localhost -U superuser -d postgresdb

4. WordPress

cd nqdev/wordpress
docker-compose up -d

# Truy cập WordPress
open http://localhost:8080

5. RabbitMQ

cd nqdev/rabbitmq
docker-compose up -d

# Truy cập Management UI
open http://localhost:15672

⚙️ Cấu hình chung

Environment Variables

Tất cả containers đều hỗ trợ các biến môi trường chuẩn:

TZ=Asia/Ho_Chi_Minh          # Timezone Việt Nam
CRONTAB_ENABLE=true          # Enable cron jobs (nếu hỗ trợ)

Port Mapping Convention

NQDEV sử dụng quy ước port mapping để tránh conflict:

Resource Limits

Mọi service đều có resource limits mặc định:

deploy:
  resources:
    limits:
      cpus: "0.80" # 80% CPU limit
      memory: "3.2G" # 3.2GB RAM limit
    reservations:
      cpus: "0.25" # 25% CPU reserved
      memory: "256M" # 256MB RAM reserved

Volume Structure

Cấu trúc thư mục volume chuẩn:

./data-etc/[service]/     # Configuration files
./data-log/[service]/     # Log files
./data-share/[service]/   # Shared data
./data-[type]/            # Specific data (cache, backups, etc.)

💡 Examples thực tế

Example 1: Web Application Stack

# Triển khai full stack: NGINX + WordPress + PostgreSQL
cd nqdev/nginx/alpine && docker-compose up -d
cd ../../postgres-pgagent && docker-compose up -d
cd ../wordpress && docker-compose up -d

# Setup reverse proxy in NGINX
# Cấu hình trong data-etc/nginx/conf.d/wordpress.conf

Example 2: Load Balanced API

# HAProxy + Multiple backend services
cd nqdev/haproxy/alpine
docker-compose up -d

# Cấu hình backend trong haproxy/haproxy.cfg

Example 3: Microservices Communication

# RabbitMQ + Multiple services
cd nqdev/rabbitmq
docker-compose up -d

# Cấu hình message queues và routing

Example 4: Development Environment

# Tất cả services cho development
docker network create nqdev-network

# Start all services với custom network
# Cấu hình trong từng docker-compose.yml

🔧 Troubleshooting

Common Issues

1. Port conflicts

# Kiểm tra ports đang sử dụng
netstat -tlnp | grep :8080

# Thay đổi port mapping trong docker-compose.yml
ports:
  - "8081:80"  # Thay vì 8080:80

2. Permission issues

# Fix permission cho volume mounts
sudo chown -R 1001:1001 ./data-*
chmod -R 755 ./data-*

3. Memory issues

# Giảm memory limits trong docker-compose.yml
deploy:
  resources:
    limits:
      memory: "1G"    # Giảm từ 3.2G xuống 1G

4. Container không start

# Xem logs chi tiết
docker-compose logs -f [service-name]

# Restart với force recreate
docker-compose down -v
docker-compose up -d --build --force-recreate --remove-orphans

Debug Commands

# Container status
docker-compose ps

# Resource usage
docker stats $(docker-compose ps -q)

# Network connectivity
docker-compose exec [service] ping [other-service]

# File system check
docker-compose exec [service] df -h

📚 Best Practices

1. Production Deployment

# Sử dụng external volumes cho production
volumes:
  app-data:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /opt/app-data

2. Environment Management

# Sử dụng .env files cho các môi trường khác nhau
cp .env.example .env.production
cp .env.example .env.staging

3. Backup Strategy

# Script backup tự động
#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
docker-compose exec postgres pg_dump > backup_$DATE.sql
tar -czf volumes_backup_$DATE.tar.gz ./data-*

4. Monitoring Setup

# Health checks cho tất cả services
curl http://localhost:18080/nginx_status        # NGINX
curl http://localhost:17001                     # HAProxy stats
psql -h localhost -U user -c "SELECT 1"         # PostgreSQL

5. Security Hardening

# Disable unnecessary ports exposure
# Sử dụng internal networks
# Regular security updates
# Strong passwords và SSL certificates

6. Performance Optimization

# Optimize Docker daemon
echo '{"log-driver": "json-file", "log-opts": {"max-size": "10m", "max-file": "3"}}' > /etc/docker/daemon.json

# Regular cleanup
docker system prune -a --volumes

📞 Support & Contributing

Getting Help

Contributing

  1. Fork repository
  2. Tạo feature branch (git checkout -b feature/new-service)
  3. Commit changes (git commit -am 'Add new service')
  4. Push branch (git push origin feature/new-service)
  5. Tạo Pull Request

Development Guidelines

📝 License

Distributed under the MIT License. See LICENSE for more information.

👥 NQDEV Team

Maintainer: NQDEV Platform
Email: quynh@nhquydev.net
Website: nhquydev.net
Container Registry: GitHub Packages

💡 Tip: Luôn kiểm tra logs khi có vấn đề: docker-compose logs -f [service-name]

⚠️ Lưu ý: Đảm bảo có đủ disk space và memory trước khi chạy multiple services cùng lúc

🚀 Pro tip: Sử dụng docker-compose down -v để cleanup hoàn toàn khi debugging