Node.js con dependencias fijas y caché Docker

Construye servicios confiables con un Dockerfile bien diseñado: fija versiones, controla dependencias y aprovecha el caché de capas para acelerar builds sin sorpresas. Aquí verás cómo evitar roturas por cambios de patch, organizar tu Dockerfile y usar .dockerignore para no arrastrar problemas de la máquina local.

¿Cómo asegurar dependencias reproducibles con Dockerfile y Node?

Un buen desarrollo empieza por manejar dependencias de forma estricta. Da igual el lenguaje: usa vendor o lock in para que siempre se instale la versión que ya probaste. Incluso un patch puede romper un module si el developer cambia algo sin aviso. Por eso, fija también el intérprete.

• Usa una imagen exacta: FROM node:11.0.1-alpine. Evita “from node” a secas para garantizar reproducibilidad total.
• La variante Alpine reduce tamaño de imagen. Es una optimización válida, no obligatoria.
• Define un WORKDIR: no trabajes en la ruta raíz; crea una carpeta para la app.
• Ejemplo de servicio base: una app de Node con ruta “add a más b” que convierte a entero o a float y devuelve la suma. Escucha en el puerto 3000.

¿Qué orden en el Dockerfile optimiza la caché y el build?

Los contenedores guardan capas y hacen cache. Organiza las instrucciones para que npm install solo corra cuando cambian las dependencias y no en cada build.

• Añade primero los archivos de dependencias: package.json y el equivalente a un packagelock. Si cambian, se invalida el cache y correrá npm install.
• Si no cambian, el cache se mantiene y tu build es más rápido.
• Coloca el ADD/COPY del código cerca del final: es lo que siempre cambia y así solo se invalida esa capa.
• EXPOSE 3000 puede quedar antes y mantenerse en una capa estable.

¿Ejemplo de Dockerfile con versiones fijas?

# Intérprete fijo y base ligera
FROM node:11.0.1-alpine

# Carpeta de trabajo
WORKDIR /app

# Capa de dependencias (aprovecha la caché)
ADD package.json .
ADD package-lock.json .
RUN npm install

# Código de la aplicación (cambia con frecuencia)
ADD . .

# Puerto de escucha
EXPOSE 3000

# Ejecuta como PID 1 para Node
CMD ["node", "index"]

• Con este orden, si no cambias package.json o package-lock, la capa con npm install se reutiliza.
• Si cambias una dependencia, se invalida solo lo necesario y el build se actualiza de forma segura.

¿Qué otros detalles evitan errores en producción?

Pequeños ajustes marcan una gran diferencia en estabilidad y velocidad.

• Usa node index como comando: asegura que corra en PID 1 y no bajo npm. Es una optimización común en Node.
• Recuerda que Docker no “soluciona” dependencias por sí mismo: cualquier cambio puede invalidar el cache. La meta es reducir la posibilidad de errores.
• Mantén el ADD/COPY del código lo más cercano al final posible para limitar invalidaciones.

¿Qué ignorar en .dockerignore?

Evita copiar artefactos de tu máquina local al contenedor. En Mac, los módulos pueden no funcionar en una imagen Debian o Ubuntu.

node_modules

• No copies node_modules locales: se recompilan dentro del contenedor para el sistema correcto.
• Ahorras tiempo al no subirlos al daemon de Docker.

¿Te gustaría ver más patrones de Dockerfile o compartir cómo organizas tus capas y dependencias?