Docker Telepítés¶

Ez az útmutató a FormFiller Docker és Docker Compose telepítéséhez nyújt segítséget.

Előfeltételek¶

Docker 20.10+
Docker Compose 2.0+
Minimum 2GB RAM

Gyors Indítás¶

cd formfiller-deployment/docker-compose
cp .env.example .env
docker-compose up -d

Az alkalmazás elérhető: http://localhost:3000

Docker Compose Konfiguráció¶

Alapértelmezett Struktúra¶

version: '3.8'

services:
  mongodb:
    image: mongo:7
    volumes:
      - mongodb_data:/data/db
    environment:
      - MONGO_INITDB_ROOT_USERNAME=admin
      - MONGO_INITDB_ROOT_PASSWORD=${MONGO_PASSWORD}

  backend:
    build: ../../formfiller-backend
    ports:
      - "3001:3001"
    environment:
      - NODE_ENV=production
      - MONGODB_URI=mongodb://admin:${MONGO_PASSWORD}@mongodb:27017/formfiller?authSource=admin
      - JWT_SECRET=${JWT_SECRET}
    depends_on:
      - mongodb

  frontend:
    build: ../../formfiller-frontend
    ports:
      - "3000:80"
    depends_on:
      - backend

volumes:
  mongodb_data:

Környezeti Változók¶

.env Fájl¶

# MongoDB
MONGO_PASSWORD=secure-password-here

# JWT
JWT_SECRET=your-jwt-secret-here

# Session
SESSION_SECRET=your-session-secret-here

# Frontend
VITE_API_URL=http://localhost:3001

Titkos Kulcs Generálása¶

# Linux/macOS
openssl rand -base64 32

# Vagy
head -c 32 /dev/urandom | base64

Build és Indítás¶

Első Indítás¶

# Build
docker-compose build

# Indítás háttérben
docker-compose up -d

# Logok követése
docker-compose logs -f

Újraépítés¶

# Kód változás után
docker-compose build --no-cache
docker-compose up -d

Leállítás¶

# Leállítás
docker-compose down

# Leállítás adatok törlésével
docker-compose down -v

Production Konfiguráció¶

SSL Termináció Nginx-szel¶

Adj hozzá egy nginx szolgáltatást:

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./ssl:/etc/nginx/ssl:ro
    depends_on:
      - frontend
      - backend

nginx.conf¶

events {
    worker_connections 1024;
}

http {
    upstream backend {
        server backend:3001;
    }

    upstream frontend {
        server frontend:80;
    }

    server {
        listen 80;
        server_name yourdomain.com;
        return 301 https://$server_name$request_uri;
    }

    server {
        listen 443 ssl;
        server_name yourdomain.com;

        ssl_certificate /etc/nginx/ssl/fullchain.pem;
        ssl_certificate_key /etc/nginx/ssl/privkey.pem;

        location /api {
            proxy_pass http://backend;
            proxy_http_version 1.1;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }

        location / {
            proxy_pass http://frontend;
        }
    }
}

Redis Cache (Opcionális)¶

Docker Compose Kiegészítés¶

services:
  redis:
    image: redis:7-alpine
    volumes:
      - redis_data:/data

  backend:
    environment:
      - REDIS_ENABLED=true
      - REDIS_URL=redis://redis:6379

volumes:
  redis_data:

Health Check¶

Docker Compose Health Check¶

services:
  backend:
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3001/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

Monitoring¶

Logok¶

# Összes szolgáltatás logja
docker-compose logs -f

# Egy szolgáltatás logja
docker-compose logs -f backend

# Utolsó 100 sor
docker-compose logs --tail=100

Erőforrás Használat¶

docker stats

Konténer Shell¶

# Backend shell
docker-compose exec backend sh

# MongoDB shell
docker-compose exec mongodb mongosh

Backup¶

MongoDB Backup¶

# Backup létrehozása
docker-compose exec mongodb mongodump --out=/backup

# Backup másolása host-ra
docker cp $(docker-compose ps -q mongodb):/backup ./backup

Visszaállítás¶

# Backup másolása konténerbe
docker cp ./backup $(docker-compose ps -q mongodb):/backup

# Visszaállítás
docker-compose exec mongodb mongorestore /backup

Frissítés¶

Kód Frissítése¶

# Repók frissítése
cd formfiller-backend && git pull && cd ..
cd formfiller-frontend && git pull && cd ..

# Újraépítés
docker-compose build --no-cache

# Újraindítás
docker-compose up -d

Zero-Downtime Frissítés¶

# Új verzió építése
docker-compose build

# Szolgáltatások újraindítása egyenként
docker-compose up -d --no-deps backend
docker-compose up -d --no-deps frontend

Hibaelhárítás¶

Konténer Nem Indul¶

# Logok ellenőrzése
docker-compose logs backend

# Konténer státusz
docker-compose ps

# Újraindítás
docker-compose restart backend

Hálózati Problémák¶

# Hálózat ellenőrzése
docker network ls
docker network inspect formfiller_default

Lemezterület¶

# Nem használt erőforrások törlése
docker system prune -a

# Volume-ok törlése
docker volume prune

Teljes Production Példa¶

version: '3.8'

services:
  mongodb:
    image: mongo:7
    restart: always
    volumes:
      - mongodb_data:/data/db
    environment:
      - MONGO_INITDB_ROOT_USERNAME=admin
      - MONGO_INITDB_ROOT_PASSWORD=${MONGO_PASSWORD}
    healthcheck:
      test: echo 'db.runCommand("ping").ok' | mongosh localhost:27017/test --quiet
      interval: 30s
      timeout: 10s
      retries: 3

  redis:
    image: redis:7-alpine
    restart: always
    volumes:
      - redis_data:/data

  backend:
    build: 
      context: ../../formfiller-backend
      dockerfile: Dockerfile
    restart: always
    environment:
      - NODE_ENV=production
      - PORT=3001
      - MONGODB_URI=mongodb://admin:${MONGO_PASSWORD}@mongodb:27017/formfiller?authSource=admin
      - JWT_SECRET=${JWT_SECRET}
      - SESSION_SECRET=${SESSION_SECRET}
      - REDIS_ENABLED=true
      - REDIS_URL=redis://redis:6379
      - FRONTEND_URL=${FRONTEND_URL}
    depends_on:
      - mongodb
      - redis
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3001/health"]
      interval: 30s
      timeout: 10s
      retries: 3

  frontend:
    build:
      context: ../../formfiller-frontend
      dockerfile: Dockerfile
      args:
        - VITE_API_URL=${API_URL}
    restart: always
    depends_on:
      - backend

  nginx:
    image: nginx:alpine
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./ssl:/etc/nginx/ssl:ro
    depends_on:
      - frontend
      - backend

volumes:
  mongodb_data:
  redis_data: