9. Multi-stage Builds: Creación de Imágenes Ultraligeras y Seguras
Reduce el tamaño de tus imágenes de producción de gigabytes a escasos megabytes separando la fase de compilación del entorno final de ejecución.
El Problema de las Herramientas de Compilación en Producción
Para construir una aplicación moderna (por ejemplo compilar assets con Node.js/Vite o dependencias con Composer) necesitas herramientas pesadas como Node, npm, git y paquetes de desarrollo. Sin embargo, en el servidor de producción no necesitas ni debes tener Node o compiladores instalados; solo necesitas los archivos finales generados (HTML, CSS y JS minificados).
Tener herramientas de build en producción genera dos graves problemas:
- Imágenes infladas: Imágenes que pesan entre 800 MB y 1.5 GB, ralentizando despliegues y saturando el disco del VPS.
- Mayor superficie de ataque: Compiladores y gestores de paquetes ofrecen más vectores para que un atacante intente escalar privilegios.
Solución: Construcciones en Múltiples Fases (Multi-stage)
Con Multi-stage Builds puedes utilizar múltiples instrucciones FROM en un único Dockerfile. Cada etapa puede usar una imagen base completamente diferente y puedes copiar selectivamente solo los artefactos finales compilados de una etapa hacia la etapa definitiva:
⚡ Dockerfile Multi-stage para Compilar Frontend y Servir con Nginx
Ejemplo de Dockerfile de 2 etapas: la primera compila con Node 20 y la segunda sirve los archivos estáticos con Nginx Alpine puro:
# =========================================================================
# ETAPA 1: Compilación de Assets (Node.js)
# =========================================================================
FROM node:20-alpine AS build-stage
WORKDIR /app
# Copiar archivos de dependencias para aprovechar caché
COPY package*.json ./
RUN npm ci
# Copiar el código fuente y compilar la aplicación para producción
COPY . .
RUN npm run build
# =========================================================================
# ETAPA 2: Entorno Limpio de Producción (Nginx Alpine)
# =========================================================================
FROM nginx:alpine AS production-stage
# Copiar únicamente los archivos compilados en la carpeta dist/ de la etapa 1
COPY --from=build-stage /app/dist /usr/share/nginx/html
# Copiar configuración personalizada de Nginx
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es la instrucción que permite copiar un archivo compilado de una etapa previa a la etapa final en un Dockerfile multi-stage?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Docker & Contenedores: De Cero a Producción y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.