services:
db:
image: postgres:16-alpine
environment:
POSTGRES_USER: dev_user
POSTGRES_PASSWORD: dev_password
POSTGRES_DB: app_dev
ports:
- "5432:5432"
volumes:
- pgdata:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U dev_user -d app_dev"]
interval: 5s
timeout: 5s
retries: 5
redis:
image: redis:7-alpine
command: redis-server --maxmemory 256mb --maxmemory-policy allkeys-lru
ports:
- "6379:6379"
volumes:
- redisdata:/data
volumes:
pgdata:
redisdata:Am văzut destui colegi pierzând prima zi întreagă de onboarding doar încercând să instaleze Postgres 15 local, pentru că aveau deja Postgres 13 instalat via Homebrew care le bloca portul 5432. Fix genul ăsta de frecare inutilă dispare complet când pui bazele pe Docker Compose.
Nu vrei să complici lucrurile din prima. Ai nevoie de trei servicii: baza de date relațională, un cache rapid și aplicația de frontend/full-stack. Scopul este să dai docker compose up și în 30 de secunde să ai totul funcțional, izolat și ușor de aruncat la gunoi când vrei să o iei de la zero.
Trade-off-ul sincer: Containerizezi sau nu Next.js?
Aici părerile sunt împărțite și depinde mult pe ce sistem rulezi. Pe Linux, totul zboară. Pe macOS sau Windows, dacă montezi node_modules prin volume către container, I/O-ul pe disc o să fie sesizabil mai lent, iar hot reload-ul poate avea o întârziere de 1-2 secunde.
La un proiect cu 6 developeri pe care l-am coordonat anul trecut, am testat ambele variante. Compromisul cel mai curat dacă vrei performanță maximă pe Mac este să rulezi Postgres și Redis în Docker, iar pnpm dev direct pe mașina gazdă. Dacă însă ții neapărat ca toată lumea din echipă să aibă fix aceeași versiune de Node.js fără să depinzi de nvm, containerizezi și Next.js, dar folosești un volum anonim pentru node_modules ca să eviți sincronizarea inutilă cu host-ul.
Trei detalii care fac diferența între un config bun și haos
-
Healthcheck obligatoriu pe Postgres. Dacă Next.js pornește înainte ca Postgres să fie gata să accepte conexiuni, Prisma sau Drizzle o să crape la primul query de migrare. Mulți pun doar
depends_on: [db], dar Docker consideră containerul pornit imediat ce procesul e lansat, nu când e gata de treabă. Foloseștecondition: service_healthy. -
Limitează Redis-ul. Redis e un consumator lacom dacă îl lași de capul lui. Adaugă flag-ul
--maxmemory 256mbși o politică de evaporare (--maxmemory-policy allkeys-lru). Pentru dev local nu ai nevoie de gigabiți de memorie alocați doar ca să ții câteva sesiuni sau date de test. -
Persistența datelor. Nu uita niciodată de volumele numite. Dacă ștergi containerele cu
docker compose down, vrei ca datele din Postgres să rămână pe disc. Doar dacă adaugi flag-ul-vvrei să cureți și datele, nu la fiecare restart banal.
La o aplicație cu vreo 8k useri activi pe staging unde am folosit această rețetă simplă, am redus timpul de setup al noilor colegi de la 2 ore la aproximativ 5 minute — clonat repo, copiat .env.example, docker compose up -d.
Voi cum preferați să lucrați zi de zi: containerizați tot stack-ul, inclusiv serverul de Next.js, sau lăsați doar infrastructura (baza de date, cache-ul) în containere?