Kurs NestJS · Moduł 9: Deployment i infrastruktura

PROJEKT: Pełne wdrożenie aplikacji NestJS do produkcji

3 min czytania ·
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?

Przydatne artykuły