NQDEV Containers Documentation

Chào mừng bạn đến với tài liệu hướng dẫn sử dụng NQDEV Containers! Đây là bộ sưu tập các Docker containers được tùy chỉnh và tối ưu cho production.

🚀 Production-Ready Containers - Tất cả containers đều được thiết kế và test cho môi trường production với security và performance tối ưu.

🌟 Tính năng nổi bật

• ✅ Vietnamese Timezone - Tự động cấu hình Asia/Ho_Chi_Minh
• ✅ Security Focused - Tuân thủ best practices bảo mật
• ✅ Performance Optimized - Resource limits và tuning sẵn
• ✅ Easy Deployment - Docker Compose ready
• ✅ Comprehensive Documentation - Hướng dẫn chi tiết từng service

📦 Services Available

🚀 Quick Start

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

# Chọn service và khởi chạy
cd nginx/alpine  # hoặc haproxy/alpine, postgres-pgagent, etc.
docker-compose up -d --build --force-recreate --remove-orphans

📚 Documentation Structure

🛠️ Common Commands

Health Checks

# NGINX status
curl http://localhost:18080/nginx_status

# HAProxy stats
open http://localhost:17001

# PostgreSQL connection
psql -h localhost -U superuser -d postgresdb

# RabbitMQ management
open http://localhost:15672

Container Management

# View logs
docker-compose logs -f [service-name]

# Container stats
docker stats $(docker-compose ps -q)

# Shell access
docker-compose exec [service-name] /bin/bash

🏗️ Architecture Examples

Simple Web Application

graph LR
    A[NGINX] --> B[WordPress] --> C[PostgreSQL]

Microservices

graph TB
    A[HAProxy] --> B[NGINX Gateway]
    B --> C[User Service]
    B --> D[Order Service]
    C --> E[PostgreSQL]
    D --> E
    D --> F[RabbitMQ]

🔒 Security Highlights

Production Security: Đổi tất cả default passwords trước khi deploy production!

• SSL/TLS Ready - Modern cipher suites
• Rate Limiting - Built-in protection
• Network Isolation - Container-to-container security
• Resource Limits - Prevent resource exhaustion
• Access Control - IP-based filtering

📊 Monitoring Ready

Tất cả containers đều tích hợp monitoring endpoints:

• NGINX: /nginx_status endpoint
• HAProxy: Web-based stats dashboard
• PostgreSQL: Health checks và performance views
• RabbitMQ: Management UI với metrics

🆘 Need Help?

👥 NQDEV Team

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

💡 Getting Started: Bắt đầu với Hướng Dẫn Tổng Quan để hiểu overview, sau đó chọn service guide phù hợp với nhu cầu của bạn.