Kurs NestJS · Moduł 9: Deployment i infrastruktura
PROJEKT: Pełne wdrożenie aplikacji NestJS do produkcji
W tej lekcji2
Legacie! Twoja aplikacja działa na laptopie, ale Konsul Caesar.js zadaje pytania, które padają przy każdym prawdziwym wdrożeniu: co się stanie, gdy serwer zgaśnie o trzeciej w nocy? Kto zauważy, że baza zwalnia? Skąd wiesz, że kopia z wczoraj da się odtworzyć? Konsul powierza Ci największe wyzwanie - kompletne wdrożenie rzymskiego legionu do produkcji. To prawdziwy test umiejętności, które zdobyłeś podczas naszej kampanii z NestJS.
Specyfikacja Projektu
Twoim zadaniem jest stworzenie kompletnego systemu deploymentu dla aplikacji Legionary Legion API. Każda część opiera się na lekcjach tego i poprzednich modułów, więc przed startem wróć do nich jak do map sztabowych. Podane godziny to orientacyjny czas pracy.
1. Infrastruktura (4-5 godzin)
- Konfiguracja Docker i Docker Compose
- Setup Kubernetes/Helm charts
- Konfiguracja CI/CD pipeline
- Monitoring i logging
Zacznij od obrazu zbudowanego w multi-stage build i pliku Compose, który stawia aplikację razem z MongoDB i Redisem. W Kubernetesie opisz repliki, strategię rolling update i sondy readiness oraz liveness. Pipeline ma uruchamiać testy, budować obraz i wdrażać go dopiero po zielonych testach.
2. Bezpieczeństwo (2-3 godziny)
- Implementacja SSL/TLS
- Security headers i rate limiting
- Secrets management
- Vulnerability scanning
HTTPS, nagłówki z Helmet i limity z throttlera już znasz. Sekrety trzymaj poza repozytorium i obrazem, a aplikacja niech odmawia startu, gdy któregoś brakuje. Skaner podatności, np. Trivy, dołącz do pipeline'u, żeby obraz z krytyczną luką nie trafił na produkcję.
3. Performance (2-3 godziny)
- Load balancing i auto-scaling
- Caching strategy
- Database optimization
- CDN setup
Zmierz, zanim zaczniesz optymalizować: wynik testu obciążeniowego przed zmianami i po nich to najlepszy dowód. Dobierz indeksy do najczęstszych zapytań, cache w Redisie z przemyślanym unieważnianiem i nagłówki cache dla CDN. Autoskalowanie dokłada repliki według metryk, np. CPU, więc aplikacja musi być bezstanowa: sesje i cache mieszkają w Redisie, nie w pamięci procesu.
4. Monitoring (2-3 godziny)
- Health checks
- Metrics collection
- Alerting system
- Log aggregation
Endpointy zdrowia rozdziel na liveness i readiness, metryki wystaw dla Prometheusa, a logi zapisuj w JSON-ie z identyfikatorem żądania. Alert ma budzić tylko wtedy, gdy trzeba coś zrobić - zbyt głośny alarm szybko przestaje być słyszany.
5. Backup & Recovery (1-2 godziny)
- Automated backups
- Disaster recovery plan
- Data integrity checks
Backup uruchamiaj automatycznie, ustal RTO i RPO, a potem przeprowadź jedno pełne odtworzenie na świeżym środowisku i zapisz, ile trwało.
Kryteria Oceny
- Kompletność - wszystkie komponenty działają razem
- Bezpieczeństwo - właściwe zabezpieczenia na każdej warstwie, od TLS po sekrety
- Wydajność - aplikacja wytrzymuje ruch produkcyjny, co potwierdza test obciążeniowy
- Monitoring - pełna obserwowalność: metryki, logi i alerty
- Dokumentacja - runbooki wdrożenia i odtwarzania
Mentor oceni projekt po repozytorium, więc README musi zawierać polecenia uruchomienia, opis architektury i wyniki testu odtworzenia. Polecam Ci pisać runbook równolegle z konfiguracją, a nie na końcu - to, czego nie zapiszesz od razu, o trzeciej w nocy będzie tylko domysłem.
Powodzenia, legacie! Twój legion liczy na Ciebie, a gotowy system wyślesz mentorowi na końcu modułu.
Kod do tej lekcji: deployment-project/docker-compose.yml
# PROJEKT: Pelne Wdrozenie Aplikacji NestJS do Produkcji
version: '3.8'
services:
# === API NestJS ===
api:
build:
context: .
dockerfile: Dockerfile
container_name: roman-api
restart: unless-stopped
ports:
- "4000:4000"
environment:
NODE_ENV: production
PORT: 4000
MONGO_URI: mongodb://mongo:27017/roman_empire
REDIS_HOST: redis
REDIS_PORT: 6379
JWT_SECRET: ${JWT_SECRET}
ALLOWED_ORIGINS: https://roman-empire.com
depends_on:
mongo:
condition: service_healthy
redis:
condition: service_healthy
healthcheck:
test: ["CMD", "node", "-e",
"require('http').get('http://localhost:4000/health', (r) => { process.exit(r.statusCode === 200 ? 0 : 1) })"]
interval: 30s
timeout: 10s
retries: 3
start_period: 40s
networks:
- roman-network
# === MongoDB ===
mongo:
image: mongo:7
container_name: roman-mongodb
restart: unless-stopped
volumes:
- mongo-data:/data/db
- ./scripts/backup.sh:/scripts/backup.sh
environment:
MONGO_INITDB_DATABASE: roman_empire
healthcheck:
test: ["CMD", "mongosh", "--eval", "db.runCommand('ping').ok"]
interval: 10s
timeout: 5s
retries: 5
networks:
- roman-network
# === Redis Cache ===
redis:
image: redis:7-alpine
container_name: roman-redis
restart: unless-stopped
command: redis-server --appendonly yes
volumes:
- redis-data:/data
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 10s
timeout: 3s
retries: 3
networks:
- roman-network
# === Nginx Reverse Proxy ===
nginx:
image: nginx:alpine
container_name: roman-nginx
restart: unless-stopped
ports:
- "80:80"
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf:ro
depends_on:
- api
networks:
- roman-network
# Volumes
volumes:
mongo-data:
driver: local
redis-data:
driver: local
# Network
networks:
roman-network:
driver: bridge
# Komendy:
# docker-compose up -d # Uruchom
# docker-compose logs -f api # Logi API
# docker-compose down # Zatrzymaj
# docker-compose ps # Status
Widzisz błąd w tej lekcji?