Por qué importa: una imagen grande tarda más en subir, bajar y escalar (cada nodo nuevo la descarga). Además trae paquetes que no usás, y cada paquete es una posible CVE que tu escáner va a reportar.
Qué haría:
Multi-stage build: compilo o instalo dependencias en una etapa con herramientas de build y copio solo el artefacto final a una imagen limpia.
Imagen base mínima: usar variantes slim, alpine (teniendo en cuenta que usa musl en lugar de glibc) o distroless según el lenguaje.
Orden de capas: primero lo que cambia poco (manifiesto de dependencias), después el código, para aprovechar la caché.
.dockerignore: excluir .git, node_modules locales, tests y archivos de entorno.
Limpiar en la misma capa: si borrás la caché de apt en otro RUN, el espacio sigue ocupado en la capa anterior.
Código: text
FROM node:20 AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build && npm prune --omit=dev
FROM node:20-slim
WORKDIR /app
COPY --from=build /app/dist ./dist
COPY --from=build /app/node_modules ./node_modules
USER node
CMD ["node", "dist/index.js"]
Para ver qué pesa uso docker history o herramientas como dive. Y de paso corro como usuario no root y escaneo la imagen en el pipeline.
Errores comunes
Borrar archivos en un RUN separado creyendo que reduce el tamaño. Elegir alpine sin considerar incompatibilidades de musl. Copiar todo el contexto antes de instalar dependencias y romper la caché en cada cambio.
Redactado con el asistente Underc0de IA. Actualizado el 17/11/2026. ¿Ves un error? Contanos en el foro.