D/ DJANGO CON CRITERIO

UNIDAD 11 · MANTENIMIENTO DE APP SERVICE

Kudu y diagnóstico de cuota de almacenamiento

Medir /home, distinguir espacios y localizar el crecimiento antes de limpiar.

Ilustración: Medir antes de tocar archivos
Medir antes de tocar archivos

CAPÍTULO 10 · Operar también es desarrollar

Cuando falta espacio, primero hay que saber dónde

Un error de cuota puede aparecer justo cuando necesitamos desplegar una corrección. La reacción inmediata podría ser borrar archivos grandes, pero no todos cumplen el mismo propósito ni están en el mismo almacenamiento. Confundir un artefacto regenerable con un dato persistente convierte un problema de capacidad en otro de recuperación.

Usamos las herramientas de diagnóstico para identificar rutas, tamaños y el contexto donde ocurre el fallo. Kudu permite observar partes del entorno de despliegue, pero debemos reconocer la diferencia entre ese contexto y el proceso que atiende la aplicación. El diagnóstico tiene que preceder a cualquier decisión de limpieza.

Con el origen del consumo identificado podemos clasificar lo que encontramos. Parte del espacio puede corresponder a archivos de una publicación o a cachés que tienen un ciclo diferente. Comprender esa diferencia nos permitirá preparar entregas limpias sin suponer que redeploy elimina automáticamente todo lo acumulado.

Leer esta parte dentro del relato completo →

DEL RELATO A LA PRÁCTICA

Vamos a desarrollar esta decisión con su mapa, explicación, código y ejercicio.

MIRA · CONECTA · COMPRENDE

Medir antes de tocar archivos

Medir antes de tocar archivos1. Error de cuota: Identifica operación y destino; 2. Kudu: Inspecciona entorno y montajes; 3. Medición: Localiza directorio que creció; 4. Diagnóstico: Clasifica datos y regenerables01Error de cuotaIdentifica operación y destino02KuduInspecciona entorno y montajes03MediciónLocaliza directorio que creció04DiagnósticoClasifica datos y regenerables

Las flechas resumen el recorrido conceptual. Los controles y dependencias se detallan debajo.

Selecciona una pieza para destacar su responsabilidad.

Leer la explicación del mapa
  1. Error de cuota. Identifica operación y destino
  2. Kudu. Inspecciona entorno y montajes
  3. Medición. Localiza directorio que creció
  4. Diagnóstico. Clasifica datos y regenerables
Descargar gráfico SVG ↓

¿Para qué sirve?

Un despliegue puede fallar por cuota aunque el código sea pequeño. Logs, cachés o historiales pueden ocupar el almacenamiento persistente.

El concepto, explicado

Kudu es el entorno asociado a despliegue y diagnóstico de App Service. Su acceso requiere permisos y puede exponer configuración sensible: no publiques volcados de variables de entorno.

En Linux inspecciona /home cuando ese es el almacenamiento persistente de tu configuración. El espacio temporal o del contenedor tiene otro ciclo de vida; en contenedores personalizados verifica montajes y opciones de persistencia.

du estima uso de archivos y df informa del filesystem. El valor mostrado por la plataforma y su cuota pueden tener otro alcance o demora. No deduzcas una cuota efectiva solo desde df.

Storage quota exceeded y No available instances describen problemas diferentes: almacenamiento y capacidad de cómputo. Borrar caché no garantiza resolver disponibilidad de workers.

Implementación paso a paso

  1. Captura mensaje, hora, operación, app y plan afectados.
  2. Abre Kudu/SSH con la cuenta operativa y confirma sistema y montajes.
  3. Mide directorios principales y profundiza en el que creció.
  4. Compara medición con uso/cuota de la plataforma y otras apps pertinentes.
  5. Identifica datos de negocio, archivos regenerables y evidencias que deben retenerse.
  6. Propón una acción específica y conserva una medición antes/después.

Ejemplo en SensorHub

# Bash de diagnóstico en el App Service Linux correcto; solo lectura.
du -sh /home
for app_path in /home/site/wwwroot /home/.cache /home/LogFiles /home/site/deployments; do
    if [ -d "$app_path" ]; then du -sh "$app_path"; fi
done
du -h --max-depth=2 /home | sort -h | tail -30
df -h /home
ls -lah /home/site/deployments
# Revisa errores de permisos, rutas o herramientas; no los ocultes todos.

Cómo leer el ejemplo

  • Los comandos asumen herramientas GNU y deben adaptarse al entorno disponible.
  • Se mide, no se borra contenido.
  • Kudu y el contenedor de la app pueden mostrar entornos distintos: confirma el volumen que estás inspeccionando.

Error habitual

Borrar wwwroot porque es visible o atribuir automáticamente todo fallo de escalado a falta de disco.

05 / PRACTICAR

Tu turno

La app ocupa 150 MB y /home creció a 1,3 GB. Diseña la búsqueda del responsable.

Ver solución orientativa

Compara cache, logs y deployments, luego desciende al directorio mayor. Confirma quota en Azure y montajes; registra tipo y regenerabilidad de archivos antes de decidir limpieza.

Cómo sabes que funciona

  • Se distingue cuota cloud de espacio del filesystem.
  • La medición identifica un directorio concreto.
  • No se vuelcan secretos en evidencia.
  • Se clasifica el error de almacenamiento o capacidad.

Para profundizar

Documentación oficial para comprobar configuración, permisos y condiciones vigentes. Revisión del tema: 2026-10-11.

CONTINUAR LA EXPERIENCIA

El siguiente paso del recorrido:

Cachés y despliegues limpios →Continuar en modo relato