Docker y Contenedorización

# Dockerfile (raíz del proyecto Next.js)

# ──── Etapa 1: Dependencias de producción ────────────────────────────
FROM node:20-alpine AS deps
WORKDIR /app

# Copiar solo manifiestos de paquetes (aprovecha caché de Docker)
COPY package.json package-lock.json ./
RUN npm ci --only=production

# ──── Etapa 2: Builder ───────────────────────────────────────────────
FROM node:20-alpine AS builder
WORKDIR /app

COPY package.json package-lock.json ./
RUN npm ci

COPY . .

# Variables necesarias en tiempo de build
ARG NEXT_PUBLIC_API_URL
ENV NEXT_PUBLIC_API_URL=$NEXT_PUBLIC_API_URL

RUN npm run build

# ──── Etapa 3: Runner (imagen final) ─────────────────────────────────
FROM node:20-alpine AS runner
WORKDIR /app

ENV NODE_ENV=production

# Seguridad: crear usuario sin privilegios
RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs

# Copiar solo los artefactos necesarios del builder
COPY --from=builder /app/public ./public

# Next.js standalone: incluye solo los módulos que usa la app
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static

# Cambiar al usuario no-root antes de iniciar
USER nextjs

EXPOSE 3000
ENV PORT=3000
ENV HOSTNAME="0.0.0.0"

CMD ["node", "server.js"]

// next.config.ts
const nextConfig = {
  output: 'standalone', // ← genera una carpeta .next/standalone
};

export default nextConfig;

# api/Dockerfile

FROM node:20-alpine AS deps
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci --only=production

FROM node:20-alpine AS runner
WORKDIR /app

ENV NODE_ENV=production

# Usuario no-root
RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 apiuser

# Copiar dependencias y código fuente
COPY --from=deps /app/node_modules ./node_modules
COPY --chown=apiuser:nodejs . .

USER apiuser

EXPOSE 4000
CMD ["node", "src/index.js"]

# .dockerignore — evita copiar archivos innecesarios al contexto de build
node_modules
.next
.env
.env.local
.env.*.local
*.log
npm-debug.log*
.git
.gitignore
README.md
Dockerfile
docker-compose*.yml
coverage
.nyc_output

# docker-compose.yml
services:
  # ── Base de datos ─────────────────────────────────
  db:
    image: postgres:16-alpine
    container_name: factordash-db
    environment:
      POSTGRES_USER: ${DB_USER}
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_DB: ${DB_NAME}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - factordash-net
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${DB_USER}"]
      interval: 10s
      timeout: 5s
      retries: 5

  # ── API Express ───────────────────────────────────
  api:
    build:
      context: ./api
      dockerfile: Dockerfile
    container_name: factordash-api
    environment:
      NODE_ENV: production
      PORT: 4000
      DATABASE_URL: postgres://${DB_USER}:${DB_PASSWORD}@db:5432/${DB_NAME}
      JWT_SECRET: ${JWT_SECRET}
      JWT_REFRESH_SECRET: ${JWT_REFRESH_SECRET}
    depends_on:
      db:
        condition: service_healthy
    networks:
      - factordash-net
    ports:
      - "4000:4000"

  # ── Frontend Next.js ──────────────────────────────
  frontend:
    build:
      context: ./frontend
      dockerfile: Dockerfile
      args:
        NEXT_PUBLIC_API_URL: http://api:4000
    container_name: factordash-frontend
    environment:
      NODE_ENV: production
    depends_on:
      - api
    networks:
      - factordash-net
    ports:
      - "3000:3000"

volumes:
  postgres_data:

networks:
  factordash-net:
    driver: bridge

# .env (en la raíz del proyecto — NO commitear)
DB_USER=factordash
DB_PASSWORD=supersecret
DB_NAME=factordash_db
JWT_SECRET=mi-jwt-secret-largo-y-aleatorio
JWT_REFRESH_SECRET=mi-refresh-secret-largo

# Construir e iniciar todos los servicios
docker compose up --build

# Iniciar en background
docker compose up -d --build

# Ver logs de un servicio específico
docker compose logs -f api

# Detener y eliminar contenedores (los volúmenes se conservan)
docker compose down

# Detener y eliminar contenedores + volúmenes (borra la BD)
docker compose down -v

# Ejecutar un comando dentro de un contenedor en ejecución
docker compose exec api sh

# Ver imágenes construidas
docker images

# Ver contenedores en ejecución
docker ps

# Limpiar imágenes, contenedores y redes sin uso
docker system prune -a

# Ejemplo conceptual: Deployment de la API en K8s
apiVersion: apps/v1
kind: Deployment
metadata:
  name: factordash-api
spec:
  replicas: 3         # 3 instancias del contenedor
  selector:
    matchLabels:
      app: factordash-api
  template:
    metadata:
      labels:
        app: factordash-api
    spec:
      containers:
        - name: api
          image: gcr.io/mi-proyecto/factordash-api:latest
          ports:
            - containerPort: 4000
          env:
            - name: NODE_ENV
              value: "production"
          resources:
            limits:
              cpu: "500m"
              memory: "256Mi"