Referencia de Docker: Comandos, Dockerfile y Compose

# ─────────────────────────────────────────────────────
# ETAPA 1: Builder — compila el código TypeScript
# ─────────────────────────────────────────────────────
FROM node:22-alpine AS builder       # imagen base ligera; "AS builder" nombra la etapa

WORKDIR /app                         # todos los comandos siguientes operan en /app

COPY package*.json .                 # copia package.json y package-lock.json

RUN npm ci                           # instala TODAS las dependencias (incluyendo devDeps)

COPY . .                             # copia el código fuente

RUN npm run build                    # compila TypeScript → dist/

# ─────────────────────────────────────────────────────
# ETAPA 2: Runner — imagen de producción mínima
# ─────────────────────────────────────────────────────
FROM node:22-alpine AS runner        # nueva imagen limpia; no hereda nada de "builder"

WORKDIR /app

ENV NODE_ENV=production              # activa optimizaciones de producción en Node.js

# Copia SOLO el resultado compilado desde la etapa builder.
# Las devDependencies, el código fuente TS y el resto NO se incluyen.
COPY --from=builder /app/dist ./dist

EXPOSE 3000                          # documenta que la app escucha en el puerto 3000

USER node                            # ejecuta como usuario no-root por seguridad

CMD ["node", "dist/server.js"]       # comando de inicio de la aplicación

services:
  server:                    # nombre del servicio (usado como hostname en la red interna)
    build:
      context: .             # directorio de contexto: busca Dockerfile en la raíz
    environment:
      NODE_ENV: production   # variable de entorno inyectada en el contenedor
    ports:
      - 3000:3000            # mapeo <puerto-host>:<puerto-contenedor>

services:
  server:
    build:
      context: .
    environment:
      NODE_ENV: production
      DATABASE_URL: postgres://postgres:secret@db:5432/devjobs
    ports:
      - 3000:3000
    depends_on:
      db:
        condition: service_healthy   # espera a que la BD esté lista

  db:
    image: postgres:16-alpine
    restart: always
    environment:
      POSTGRES_DB: devjobs
      POSTGRES_PASSWORD: secret
    volumes:
      - db-data:/var/lib/postgresql/data   # datos persistentes
    expose:
      - 5432
    healthcheck:
      test: ["CMD", "pg_isready"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  db-data:    # volumen nombrado — persiste entre reinicios

# syntax=docker/dockerfile:1    ← activa BuildKit y sus características avanzadas

ARG NODE_VERSION=26

FROM node:${NODE_VERSION}-alpine

ENV NODE_ENV production

WORKDIR /usr/src/app

# ── Instalación de dependencias con cache ─────────────────────────────────────
RUN --mount=type=bind,source=package.json,target=package.json \
    --mount=type=bind,source=package-lock.json,target=package-lock.json \
    --mount=type=cache,target=/root/.npm \
    npm ci --omit=dev

# ── Usuario no-root ───────────────────────────────────────────────────────────
USER node

# ── Código fuente ─────────────────────────────────────────────────────────────
COPY . .

EXPOSE 3000

CMD npm start

--mount=type=bind,source=package.json,target=package.json

--mount=type=cache,target=/root/.npm