Saltar al contenido

Sin espacio en disco en GitHub Actions: soluciones

Última actualización

El error No space left on device significa que el disco del runner se llenó durante su job, normalmente en una compilación de Docker, una instalación grande de dependencias o un paso de artefactos voluminoso. Los runners estándar de Linux alojados por GitHub tienen 14 GB de almacenamiento SSD, así que un job que descarga imágenes, compila un proyecto grande y guarda la caché puede quedarse sin espacio. A continuación encontrará las causas, ordenadas por frecuencia, con soluciones que puede copiar y pegar. La cifra de disco procede de la referencia de runners alojados por GitHub, consultada en octubre de 2026.

El mensaje exacto

Verá uno de estos mensajes en el paso que falla:

System.IO.IOException: No space left on device
ENOSPC: no space left on device, write
write /var/lib/docker/...: no space left on device
OSError: [Errno 28] No space left on device

El texto cambia según la herramienta, pero la causa es la misma: el sistema de archivos no tiene bloques libres (o no tiene inodos libres). El mismo mensaje también puede aparecer en un runner autoalojado, donde usted decide el tamaño del disco.

Compruebe qué ocupa el disco

Añada este paso antes del que falla, y otra vez después, para ver qué creció:

- name: Disk usage
  if: always()
  run: |
    df -h
    sudo du -xh / --max-depth=2 2>/dev/null | sort -rh | head -20
    docker system df

Si df -h muestra espacio libre pero el error persiste, revise los inodos con df -i. Millones de archivos pequeños en node_modules pueden agotar los inodos antes que el espacio.

Causas, de la más probable a la menos probable

1. Imágenes de Docker, capas y caché de compilación

Cada docker pull, docker build y contenedor de servicio escribe en /var/lib/docker. Las compilaciones multietapa con imágenes base grandes son el caso más habitual. Elimine lo que ya no necesite entre pasos:

- name: Free Docker space
  run: |
    docker image prune -af
    docker builder prune -af
    docker system df

Use docker system prune -af --volumes solo si ningún paso posterior necesita los volúmenes. La documentación de limpieza de Docker explica qué elimina cada comando. Las imágenes base más pequeñas (-slim, -alpine) y un archivo .dockerignore también reducen el consumo. Más información sobre la caché de compilación en Caché de capas de Docker en CI.

2. Toolchains preinstalados que no usa

La imagen de Ubuntu alojada incluye muchos SDK. Si su job no usa Android, .NET o Haskell, eliminarlos libera varios GB. Estas rutas se suelen borrar, pero son detalles de la imagen que GitHub puede cambiar, así que verifique primero con du:

- name: Free disk space
  run: |
    sudo rm -rf /usr/share/dotnet
    sudo rm -rf /usr/local/lib/android
    sudo rm -rf /opt/ghc
    sudo rm -rf /opt/hostedtoolcache/CodeQL
    df -h /

La eliminación tarda uno o dos minutos, así que hágala solo cuando alcance el límite. No borre herramientas que su job llame más adelante. La lista del software preinstalado está en el repositorio runner-images.

3. Salida de compilación, cachés y artefactos

Los directorios grandes target/, build/ o .gradle, junto con las cachés restauradas, ocupan el mismo disco. Limpie la salida intermedia a medida que avanza y evite restaurar una caché más grande de lo necesario (consulte los límites de caché). En Gradle, ejecute ./gradlew --stop y elimine las cachés de compilación que no necesite. En Rust, dividir la compilación en varios jobs ayuda más que cargo clean.

4. Demasiado trabajo en un solo job

Clonar un monorepo grande, compilar todas las imágenes y ejecutar todas las pruebas en un solo job concentra todo el uso de disco en una máquina. Divida el trabajo en varios jobs o use una matriz de sharding de pruebas, de modo que cada job escriba menos. Use un clon superficial con fetch-depth: 1 cuando no necesite el historial.

5. Registros y archivos temporales de las pruebas

Las suites de pruebas que escriben vídeos, volcados de memoria o registros detallados pueden añadir GB. Escríbalos en un directorio que suba y luego elimine, o reduzca el nivel de detalle.

Soluciones cuando la limpieza no basta

  • Runner más grande. Los runners más grandes de GitHub tienen más recursos que los estándar; consulte los tamaños actuales en la página de runners más grandes. Siempre se cobran por minuto, incluso en repositorios públicos.
  • Otro proveedor de runners. compiler.dev ejecuta el mismo job en una máquina de 8 vCPU / 16 GB con una VM nueva por job, lo que también ayuda cuando los problemas de disco van acompañados de presión de memoria (consulte código de salida 137). El cambio es una línea, runs-on: [self-hosted, Linux, compiler-ci]; consulte precios.
  • Runner autoalojado. Usted elige el disco, pero también se encarga de la limpieza. Añada un job programado que ejecute docker system prune en el host.

Cómo prevenirlo

  1. Registre df -h al inicio y al final de cada job pesado para ver el crecimiento a lo largo del tiempo.
  2. Fije imágenes base más pequeñas y use Dockerfiles multietapa que copien solo el artefacto final.
  3. Ejecute prune de Docker entre etapas de compilación en los jobs que construyen más de una imagen.
  4. Limite las cachés a los directorios de descarga de paquetes, no a árboles de compilación completos.
  5. Divida los jobs grandes. Un job que necesita 20 GB probablemente son dos jobs.

Errores relacionados: hosted runner lost communication suele aparecer cuando un runner se queda sin recursos, y cache not found aparece cuando se desalojan cachés grandes.

Preguntas frecuentes

¿Cuánto espacio en disco tiene un runner de GitHub Actions?

GitHub indica 14 GB de almacenamiento SSD para los runners estándar de Linux, como ubuntu-latest, tanto en repositorios públicos como privados, a octubre de 2026. Ejecute df -h en un paso para ver el espacio libre real, que es menor porque el sistema operativo y las herramientas ocupan una parte.

¿Es seguro eliminar /usr/share/dotnet y /usr/local/lib/android?

Sí, si su job no los usa. El runner es una VM nueva, así que la eliminación solo afecta al job actual. Hágalo antes de que empiece la compilación y no borre nada que necesite una acción posterior.

¿Por qué Docker llena el disco tan rápido?

Las capas de las imágenes descargadas, las capas intermedias de compilación y la caché de compilación se guardan localmente. Unas pocas imágenes grandes pueden superar fácilmente varios GB. Use prune o imágenes más pequeñas.

¿Puedo añadir más disco a un runner alojado?

No como ajuste documentado para los runners estándar. Use un runner más grande, un runner autoalojado o un proveedor cuyas máquinas tengan discos más grandes.