Dockerfile Stage Visualizer

Cómo usar esta herramienta para desarrolladores

1. Pega un Dockerfile con una o varias instrucciones FROM.
2. Ejecuta el visualizador.
3. Revisa el resumen de cada etapa.
4. Comprueba las referencias --from y si apuntan a aliases locales o fuentes externas.

Qué hace esta herramienta para desarrolladores

Agrupa instrucciones por cada FROM y construye un mapa de dependencias basado en COPY/ADD --from. Así puedes ver qué etapa consume artefactos de otra y detectar referencias a aliases inexistentes.

Las referencias --from también pueden apuntar a una imagen externa, no solo a un alias local; por eso una referencia desconocida se señala como externa o no resuelta, no como error absoluto.

Ejemplo

Entrada

FROM node:22-alpine AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci
FROM node:22-alpine AS build
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build
FROM nginx:alpine AS runtime
COPY --from=build /app/dist /usr/share/nginx/html

Resultado esperado

La herramienta procesa el ejemplo con la lógica descrita arriba y muestra un resumen estructurado listo para copiar o descargar.

Casos de uso

• Entender Dockerfiles heredados.
• Revisar separación build/runtime.
• Detectar dependencias entre etapas antes de refactorizar.

Consejos para obtener resultados fiables

• Asigna aliases descriptivos a las etapas reutilizadas.
• Mantén la etapa runtime lo más pequeña posible.
• Comprueba qué artefactos cruza cada COPY --from.
• Evita depender de índices numéricos si un alias hace el Dockerfile más legible.

Detalles del procesamiento

El análisis identifica FROM por línea y asigna las instrucciones siguientes a esa etapa hasta el siguiente FROM. Las dependencias se extraen del flag --from en COPY y ADD.

No interpreta targets de build, ARG usados dentro de FROM ni dependencias implícitas por mounts de BuildKit. El mapa refleja únicamente referencias visibles en el Dockerfile.