kaxuna1/docker

Docker Skill

Single-container architecture bundling PostgreSQL 14, Node.js 20 backend, Nginx reverse proxy, and Supervisor process manager. Multi-stage builds optimize image size while supporting both AMD64 and ARM64 architectures.

Quick Start

Build and Run

# Docker Compose (recommended)
docker-compose up -d

# Manual build
docker build -t luxia-ecommerce:latest .
docker run -d -p 80:80 \
  -e JWT_SECRET=$(openssl rand -base64 32) \
  -e DB_PASSWORD=secure_password \
  -e POSTGRES_PASSWORD=secure_password \
  -v luxia-postgres:/var/lib/postgresql/data \
  -v luxia-uploads:/app/backend/uploads \
  luxia-ecommerce:latest

Multi-Architecture Build

./docker/build-multiarch.sh
# Or with registry:
REGISTRY=your.registry.com ./docker/build-multiarch.sh

Key Concepts

| Concept | Location | Purpose | |---------|----------|---------| | Multi-stage build | Dockerfile | Separate frontend/backend builders, final Ubuntu runtime | | Supervisor | docker/supervisord.conf | Manages PostgreSQL → migrations → backend → nginx startup order | | Nginx proxy | docker/nginx.conf | Routes /api/* to backend, serves static files | | Health check | Dockerfile:113 | Verifies /api/health endpoint |

Common Patterns

Service Priority Order

Supervisor starts services in priority order:

# docker/supervisord.conf
[program:postgresql]
priority=1      # Start first

[program:migrations]
priority=2      # Run after DB ready

[program:backend]
priority=3      # Start after migrations

[program:nginx]
priority=4      # Start last

Volume Persistence

# docker-compose.yml
volumes:
  - postgres_data:/var/lib/postgresql/data  # Database
  - uploads_data:/app/backend/uploads        # User uploads

Environment Variables

Critical variables for production:

| Variable | Purpose | |----------|---------| | JWT_SECRET | Token signing (use openssl rand -base64 32) | | DB_PASSWORD | PostgreSQL password | | POSTGRES_PASSWORD | Must match DB_PASSWORD |

See Also

• docker - Dockerfile patterns and multi-stage builds
• deployment - Production deployment checklist
• monitoring - Logging and health checks

Related Skills

For PostgreSQL configuration details, see the postgresql skill. For backend service patterns, see the express skill. For Node.js runtime specifics, see the node skill.