#349 · Herramienta para desarrolladores

Docker Ignore Generator

Genera una propuesta de .dockerignore a partir del tipo de proyecto y de patrones comunes que no deberían entrar en el contexto de build. Permite elegir perfiles habituales y añadir rutas propias, mostrando cada regla de forma editable antes de guardarla.

Datos de entrada

Rutas adicionales
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Selecciona el perfil del proyecto.
  2. Añade patrones propios si los necesitas.
  3. Mantén o desactiva la exclusión de archivos locales de secretos.
  4. Genera y revisa el .dockerignore antes de guardarlo en la raíz del contexto de build.

Qué hace esta herramienta para desarrolladores

Combina un conjunto base de exclusiones con reglas específicas del ecosistema seleccionado y con tus patrones personalizados. El resultado elimina duplicados sin reordenar innecesariamente las reglas.

Siempre se proponen metadatos de Git, archivos temporales y logs. Cada perfil añade carpetas de dependencias, cachés o artefactos de compilación típicos. La opción de secretos agrega .env y variantes locales.

Un .dockerignore demasiado amplio puede excluir archivos requeridos por COPY. Revisa siempre el resultado junto con las rutas usadas en tu Dockerfile.

Ejemplo

Entrada

coverage
.env.local
reports/

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

  • Reducir el contexto enviado a Docker.
  • Evitar copiar dependencias o artefactos locales.
  • Disminuir el riesgo de incluir .env por accidente.

Consejos para obtener resultados fiables

  • Coloca .dockerignore en la raíz del contexto usado por docker build.
  • Comprueba cada COPY después de añadir reglas amplias.
  • No ignores archivos lock si los necesitas para builds reproducibles.
  • Añade outputs de test o cobertura que no entren en la imagen.
  • Usa reglas específicas en monorepos para no excluir paquetes necesarios.

Detalles del procesamiento

El generador usa listas de patrones explícitas y no inspecciona tu sistema de archivos. Los patrones personalizados se leen línea por línea y se deduplican frente al perfil seleccionado.

No puede saber qué archivos existen realmente ni qué rutas necesita tu Dockerfile. Debes validar la propuesta en tu repositorio antes de usarla en CI.

Preguntas frecuentes

¿Qué debería incluir un .dockerignore para Node.js?

Normalmente node_modules, logs, metadatos de Git, cachés y artefactos locales que no deban formar parte del contexto. Revisa si tu build necesita algún output precompilado.

¿Es recomendable ignorar .env en Docker builds?

En general sí para evitar incluir secretos locales por accidente, siempre que tu proceso no dependa de copiar ese archivo dentro de la imagen.

¿.dockerignore usa la misma sintaxis que .gitignore?

Son parecidas, pero Docker aplica sus propias reglas de matching y contexto. No asumas que todos los casos se comportan exactamente igual.

¿Dónde debe colocarse el archivo .dockerignore?

Normalmente en la raíz del contexto de build que pasas a docker build, junto al conjunto de archivos que quieres filtrar.

¿Un .dockerignore pequeño puede acelerar docker build?

Puede reducir el tamaño del contexto y evitar transferir archivos innecesarios, lo que ayuda especialmente en repositorios grandes o builds remotos.

Resumen de módulos

MóduloQué muestra
PerfilReglas base por ecosistema
Seguridad localExclusiones .env opcionales
PersonalizaciónPatrones propios deduplicados