Todo desarrollador web ha vivido el problema de "en mi máquina funciona". Docker lo soluciona empaquetando tu aplicación con todo su entorno — código, runtime, herramientas del sistema y librerías — en un contenedor portátil.
Esta guía explica qué son los contenedores, cómo usar Docker eficazmente en desarrollo web y las mejores prácticas para producción.
¿Qué es Docker?
Docker es una plataforma de contenerización. Un contenedor es un ejecutable ligero y autónomo que incluye todo lo necesario para ejecutar un software. A diferencia de las máquinas virtuales, los contenedores comparten el kernel del sistema operativo anfitrión, lo que los hace más rápidos y eficientes en recursos.
Conceptos clave:
- Imagen: una plantilla de solo lectura con instrucciones para crear un contenedor
- Contenedor: una instancia ejecutable de una imagen
- Dockerfile: un archivo de texto con instrucciones para construir una imagen
- Volumen: almacenamiento persistente que sobrevive a los reinicios del contenedor
- Compose: una herramienta para definir y ejecutar aplicaciones multi-contenedor
Dockerfile para una aplicación Next.js
Un Dockerfile bien estructurado usa builds multi-etapa para mantener las imágenes pequeñas:
FROM node:22-alpine AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
FROM node:22-alpine AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build
FROM node:22-alpine AS runner
WORKDIR /app
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/public ./public
COPY --from=builder /app/node_modules ./node_modules
EXPOSE 3000
CMD ["npm", "start"]
Los builds multi-etapa mantienen la imagen final ligera — solo lo necesario en tiempo de ejecución, no las herramientas de construcción.
Docker Compose para desarrollo local
Compose te permite definir todo tu stack en un archivo YAML y arrancarlo todo con un solo comando:
version: "3.8"
services:
app:
build: .
ports: ["3000:3000"]
volumes: [".:/app", "/app/node_modules"]
depends_on: [db]
db:
image: postgres:16
environment:
POSTGRES_PASSWORD: password
volumes: ["pgdata:/var/lib/postgresql/data"]
volumes:
pgdata:
Esto da a cada desarrollador un entorno idéntico — misma versión de Node, misma base de datos, misma configuración. Se acabó la documentación de configuración.
Mejores prácticas
Usa .dockerignore: Excluye node_modules, .git y artefactos de build del contexto de construcción. Esto acelera los builds y reduce el tamaño de la imagen.
Fija versiones de imagen base: Usa node:22-alpine en lugar de node:latest. Los builds reproducibles requieren versiones explícitas.
Ejecuta como no-root: Los contenedores ejecutándose como root son un riesgo de seguridad. Crea un usuario en tu Dockerfile y cambia a él.
Usa health checks: Define instrucciones HEALTHCHECK para que las plataformas de orquestación sepan cuándo tu contenedor está listo.
Cachea dependencias estratégicamente: Copia package.json y ejecuta npm install antes de copiar el código de la aplicación. Docker cachea cada capa — la instalación de dependencias solo se repite cuando cambia package.json.
Despliegue en producción
Para producción, integra Docker con una plataforma de orquestación. Un solo contenedor Docker en un VPS es suficiente para proyectos pequeños. Para aplicaciones más grandes, usa Kubernetes o un servicio de contenedores gestionado (AWS ECS, Google Cloud Run).
Docker transforma los flujos de trabajo de desarrollo web. Entornos consistentes, builds reproducibles y despliegues simplificados benefician a equipos de cualquier tamaño.
¿Estás adoptando Docker para tu proyecto web? En Vynta contenerizamos cada aplicación que construimos, garantizando entornos consistentes desde desarrollo hasta producción.