0006-docker-patterns

What problem does it solve?

It solves the confusion and instability that come from setting up and maintaining multi-service Docker Compose environments for local development, especially around networking, volumes, and Dockerfile hardening.

Core Features & Use Cases

• Local multi-service orchestration: Provides a standard Compose setup for common dev stacks (app + Postgres + Redis + optional mail testing) with health checks and dependency conditions.
• Deterministic dev-to-prod containerization: Uses multi-stage Dockerfiles and explicit production targets to reduce image size and improve runtime behavior.
• Security and operability guidance: Covers non-root execution, capability dropping, read-only filesystem patterns, secret handling, and practical debugging commands.
• Volume and network strategy: Explains bind vs named vs anonymous volumes and how service discovery works inside Compose networks.

Quick Start

Ask the AI to generate a docker-compose.yml and multi-stage Dockerfile for local development that includes a healthy Postgres dependency, safe volume mounts for node_modules and database persistence, and production-ready hardening steps.