Tema 8 · Optimización & Caché

8. Buenas Prácticas con .dockerignore, Capas de Construcción y Caché

Acelera el proceso de build aprovechando el sistema de capas de Docker y evita filtrar archivos confidenciales o innecesarios con .dockerignore.

Cómo Funciona el Sistema de Capas (Layers) y Caché

Cada instrucción en un Dockerfile (como FROM, RUN o COPY) genera una capa inmutable de solo lectura (read-only layer). Cuando vuelves a compilar una imagen con docker build, Docker comprueba si la instrucción y los archivos involucrados han cambiado; si no han cambiado, utiliza la capa previamente almacenada en caché instantáneamente.

💡 Principio del Orden de Instrucciones:
Las instrucciones que cambian con menor frecuencia (como instalar extensiones de PHP o dependencias de Composer) deben colocarse al principio del Dockerfile. El código fuente de tu aplicación, que cambia con cada commit, debe copiarse al final. De este modo no invalidarás la caché de instalación en cada build.

El Archivo .dockerignore: Seguridad y Peso de la Imagen

Similar a .gitignore, el archivo .dockerignore le indica al cliente de Docker qué archivos y carpetas no deben enviarse al contexto de construcción (build context) del demonio.

Beneficios indispensables:

  • Seguridad Crítica: Impide que archivos con secretos como .env o claves SSH privadas se cuelen dentro de la imagen pública.
  • Velocidad Extrema: Evita transferir carpetas gigantes como vendor/, node_modules/ o el directorio .git/, reduciendo el envío de megabytes o gigabytes innecesarios al Docker daemon.

⚡ Plantilla Estándar Profesional de un Archivo .dockerignore

Copia este archivo .dockerignore en la raíz de tu proyecto para evitar fugas de información y agilizar tus compilaciones:

.dockerignore
Solo lectura
# Control de versiones
.git
.gitignore
.github

# Secretos y credenciales de entorno
.env
.env.*
*.pem
*.key
id_rsa*

# Dependencias pesadas locales (deben instalarse dentro del contenedor)
vendor/
node_modules/

# Archivos temporales, logs y cachés
storage/logs/*.log
storage/framework/cache/
*.tmp
.DS_Store
Thumbs.db

# Configuraciones de editores de código
.vscode/
.idea/
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué se recomienda copiar composer.json y ejecutar composer install antes de copiar el resto del código fuente en un Dockerfile?
🦉
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.