Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Στήστε ένα πλήρες, απομονωμένο περιβάλλον παραγωγής με εξαρτήσεις υγείας και ιδιωτικά δίκτυα.
Το Docker Compose δεν είναι απλώς εργαλείο για τοπική ανάπτυξη — είναι η de-facto standard επιλογή για single-node production VPS deployments (Hetzner, DigitalOcean, AWS EC2).
Σε αυτό το μάθημα θα αναλύσουμε τη συγγραφή ενός αρχείου docker-compose.yml έτοιμου για παραγωγή.
Δουλεύετε μέσα στον φάκελο του project, όπου ζουν το Dockerfile (προηγούμενο μάθημα) και το docker-compose.yml που θα φτιάξετε τώρα. Οι εντολές docker compose ... τρέχουν πάντα από εκείνον τον φάκελο.
docker-compose.ymlservices:
# -----------------------------------------------------------
# Web Application (Next.js / Node)
# -----------------------------------------------------------
web:
build:
context: .
dockerfile: Dockerfile
restart: unless-stopped
ports:
- "127.0.0.1:3000:3000" # ΜΟΝΟ σε localhost (πίσω από Caddy/Nginx!)
environment:
- NODE_ENV=production
- DATABASE_URL=postgresql://postgres:${DB_PASSWORD}@db:5432/roboschool?sslmode=disable
- REDIS_URL=redis://:${REDIS_PASSWORD}@cache:6379
depends_on:
db:
condition: service_healthy
cache:
condition: service_started
networks:
- internal-net
healthcheck:
test: ["CMD-SHELL", "wget -qO- http://127.0.0.1:3000/api/health || exit 1"]
interval: 15s
timeout: 5s
retries: 3
start_period: 20s
# -----------------------------------------------------------
# PostgreSQL Database 17
# -----------------------------------------------------------
db:
image: postgres:17-alpine
restart: unless-stopped
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: ${DB_PASSWORD}
POSTGRES_DB: roboschool
volumes:
- postgres_data:/var/lib/postgresql/data
networks:
- internal-net
# ΚΡΙΣΙΜΟ: ΔΕΝ εκθέτουμε την 5432 στο internet!
# Μόνο τα containers στο internal-net έχουν πρόσβαση.
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres -d roboschool"]
interval: 10s
timeout: 5s
retries: 5
start_period: 10s
# -----------------------------------------------------------
# Redis Cache & Background Queue
# -----------------------------------------------------------
# Προεπιλογή 2024+: Valkey (BSD fork του Redis — η Redis άλλαξε άδεια,
# η Redis 8 προστέθηκε με AGPLv3)· το redis-cli και τα redis:// URLs
# παραμένουν πλήρως συμβατά. Περισσότερα: /guides/valkey-redis-caching-and-distributed-performance-guide
cache:
image: valkey/valkey:9-alpine
restart: unless-stopped
command: valkey-server --appendonly yes --requirepass ${REDIS_PASSWORD}
volumes:
- redis_data:/data
networks:
- internal-net
volumes:
postgres_data:
name: roboschool_postgres_data
redis_data:
name: roboschool_redis_data
networks:
internal-net:
driver: bridgedb, δεν υπάρχει πεδίο ports: - "5432:5432". Αυτό σημαίνει ότι ούτε ένας hacker δεν μπορεί να συνδεθεί απευθείας στη βάση από το internet. Μόνο το container web μπορεί να επικοινωνήσει μαζί της μέσω του δικτύου internal-net. Τα ονόματα db και cache λύνονται αυτόματα από το ενσωματωμένο DNS του Compose (όνομα service = hostname)."127.0.0.1:3000:3000" εξασφαλίζει ότι το Node.js δεν ακούει στο 0.0.0.0. Μόνο ο τοπικός reverse proxy (Caddy ή Nginx) μπορεί να προωθήσει αιτήματα.depends_on με service_healthy: Το Web container δεν θα ξεκινήσει μέχρι η PostgreSQL να είναι 100% έτοιμη να δεχτεί συνδέσεις.Διαβάστε στη συνέχεια: διαχείριση μυστικών & .env και το Docker Compose cheatsheet.
Ένα compose file για όλα τα περιβάλλοντα καταλήγει σε συμβιβασμούς: το dev θέλει ανοιχτές θύρες και bind volumes για γρήγορη επανάληψη, η παραγωγή θέλει κλειστές θύρες και named volumes. Η λύση είναι σύνθεση αρχείων: ένα base για την παραγωγή + override για τις τοπικές ανέσεις.
# Ρητή σύνθεση: τα επόμενα αρχεία κερδίζουν πάνω στα προηγούμενα
docker compose -f compose.yml -f compose.override.yml up -d
# Προεπισκόπηση της συγχωνευμένης διαμόρφωσης πριν την εκτέλεση
docker compose -f compose.yml -f compose.override.yml configΚανόνας συγχώνευσης (later wins): οι μονές τιμές (image, command) αντικαθίστανται από το επόμενο αρχείο· τα environment/volumes συγχωνεύονται ανά κλειδί με προτεραιότητα στις τοπικές τιμές· τα ports προστίθενται και από τα δύο αρχεία — σχεδιάστε το base με αυτό στο μυαλό. Σύμβαση: αν δίπλα στο compose.yml υπάρχει compose.override.yml, το Compose το φορτώνει αυτόματα χωρίς -f (η παλιότερη ονομασία docker-compose.override.yml αναγνωρίζεται ακόμα για συμβατότητα).
# compose.override.yml — ΜΟΝΟ για dev: bind volume κώδικα + dev περιβάλλον
services:
web:
volumes:
- ./app:/app
environment:
- NODE_ENV=developmentΤο μοτίβο: η παραγωγή τρέχει το base μόνο του (κλειστό, πίσω από reverse proxy — δείτε το zero-downtime rollout capstone (Pro)), ενώ τοπικά το override προσθέτει άνεση dev. Δείτε το merge compose files.
/api/health Endpoint που Καλούν τα HealthchecksΤα healthchecks παραπάνω (και το depends_on: service_healthy του capstone) καλούν το GET /api/health — χωρίς αυτό το endpoint το web container μένει για πάντα unhealthy. Δημιουργήστε το src/app/api/health/route.ts:
import { NextResponse } from 'next/server';
export function GET() {
return NextResponse.json({
status: 'ok',
timestamp: new Date().toISOString(),
});
}(Στο repo του RoboSchool το ίδιο endpoint ελέγχει και τη βάση — δείτε src/app/api/health/route.ts.)
Πριν την πρόκληση, η βασική σύνταξη για εκκίνηση ενός container:
# docker run: κατεβάζει το image (αν λείπει) και ξεκινάει container
# -d (detached): τρέχει στο παρασκήνιο, το τερματικό μένει ελεύθερο
# -p 8080:80: αντιστοιχίζει την πόρτα 8080 του host στην πόρτα 80 του container
docker run -d -p 8080:80 nginxΤο nginx είναι το όνομα του image (ένας web server)· η μορφή του port mapping είναι πάντα HOST_PORT:CONTAINER_PORT.
web δένεται μόνο στο 127.0.0.1:3000:3000 πίσω από Caddy ή Nginx, με restart: unless-stopped και δίκτυο internal-net.db τρέχει postgres:17-alpine με volume postgres_data και healthcheck pg_isready, χωρίς έκθεση της 5432 στο internet.cache τρέχει valkey/valkey:9-alpine με volume redis_data, και τα redis:// URLs και το redis-cli μένουν συμβατά.web ξεκινά μόνο όταν η βάση είναι service_healthy μέσω depends_on, και το healthcheck καλεί το GET /api/health με wget.-f (το override κερδίζει· αυτόματο compose.override.yml) και επαληθεύετε με config.