“No space left on device” in GitHub Actions: trova cosa riempie il disco, liberalo, o prendine uno più grande
“No space left on device” su GitHub Actions vuol dire che il job ha scritto più di quanto il runner avesse libero, e sul runner Linux standard di GitHub sono circa 14 GB: un maintainer di runner-images ha scritto che GitHub "guarantee[s] only 14GB of free space for both private & public repos", perché i tool preinstallati dell'immagine si prendono il resto (l'elenco di un utente su ubuntu-latest: 12 GB di SDK Android, 8,5 GB di hosted tool cache, 5,5 GB di GHC). Immagini Docker, una cache ripristinata scompattata sul disco e gli alberi di build riempiono 14 GB in fretta. Risolvilo in quest'ordine: guarda cosa riempie il disco (df -h, df -i, du, docker system df), scrivi meno, cancella i tool preinstallati che il job non usa, e se ancora non basta, esegui il job su un disco più grande. I runner più grandi di GitHub hanno da 75 GB in su, solo su GitHub Team ed Enterprise Cloud.
Skipbox esegue i tuoi job sulla macchina del tuo account con 80 GB di disco su S, 160 GB su M e 320 GB su L, a prezzo fisso con minuti illimitati. Le cache che conserva tra un job e l'altro stanno su quel disco, e quando il disco si riempie toglie le più vecchie, quindi all'inizio di un job non c'è niente da cancellare.
Quanto disco ha un runner di GitHub
La pagina sui runner ospitati da GitHub indica 14 GB di SSD per il runner Linux standard, nei repository privati e pubblici. Nella discussione #9329 di runner-images, dopo che una modifica all'immagine aveva ridotto lo spazio libero sui runner Ubuntu da oltre 31 GB a oltre 17 GB, un maintainer ha risposto: "We indeed guarantee only 14GB of free space for both private & public repos." Conta su 14 GB.
Il resto del disco è l'immagine. Nella issue #10386 ("Free space left: 72 MB"), il du di un utente su ubuntu-latest mostrava:
| Directory | Dimensione |
|---|---|
/usr/local/lib/android | 12 GB |
/opt/hostedtoolcache | 8,5 GB (solo CodeQL 5 GB) |
/usr/local/.ghcup | 5,5 GB |
1. Guarda cosa riempie il disco
Aggiungi uno step dopo quello che fallisce, con if: always():
- name: Disk usage
if: always()
run: |
df -h
df -i /
sudo du -xh --max-depth=1 / 2>/dev/null | sort -rh | head -15
docker system df || true
df -hmostra ogni filesystem e quanto è pieno. Annota quello su cui scrive il tuo job: il workspace, i dati di Docker in/var/lib/docker, o la directory temporanea.df -imostra gli inode. Un disco può finire gli inode (uno per file) con dei byte ancora liberi, e l'errore è lo stesso.dumostra le directory più grandi.docker system dfmostra quanto occupano immagini, container, volumi e cache di build di Docker.
2. Scrivi meno
- Fai prune di Docker tra una build e l'altra.
docker system prunerimuove i container fermi, le reti inutilizzate, le immagini dangling e la cache di build inutilizzata;-arimuove tutte le immagini inutilizzate, e--volumesanche i volumi anonimi. - Metti in cache quello che ripaga. Una cache ripristinata viene scompattata sul disco del runner, quindi un archivio di cache grande occupa più spazio del suo download. Dividila per job, o togli quello che si riscarica in fretta.
- Pulisci gli alberi di build che uno step successivo non usa, prima dello step che ha bisogno dello spazio.
3. Cancella i tool preinstallati che il job non usa
Dalla issue #2875 e dalla #10386:
- name: Free disk space
run: |
sudo rm -rf /usr/local/lib/android /usr/local/.ghcup /opt/hostedtoolcache/CodeQL
sudo rm -rf /usr/share/dotnet /usr/local/share/boost
df -h /
Due costi. Cancellare gigabyte richiede tempo a ogni esecuzione, perché la VM del job successivo li ha di nuovo. E rimuovere $AGENT_TOOLSDIRECTORY (tutta la hosted tool cache) libera di più ma, come ha scoperto l'autore della #2875, rompe i tool che gli step si aspettano di trovare. L'action free-disk-space raccoglie queste cancellazioni; il suo autore ha aggiunto l'opzione per la tool cache dopo quella discussione, dicendo che "saves an extra 6GB".
4. Esegui il job su un disco più grande
| Runner | Disco | Chi può usarlo |
|---|---|---|
| Runner Linux standard di GitHub | 14 GB di SSD, circa 14 GB liberi | Tutti |
| Runner più grande di GitHub, da 2 a 96 vCPU | 75 GB a 2 vCPU, 150 GB a 4, 300 GB a 8, fino a 2.040 GB (runner più grandi) | Organizzazioni su GitHub Team ed Enterprise Cloud, al minuto (sui runner più grandi) |
| Runner self-hosted | Quello che gli dai; un runner tenuto tra un job e l'altro si riempie di immagini e vecchi workspace se niente lo pulisce | Chiunque, e lo gestisci tu |
| Macchina dell'account di Skipbox | 80 GB su S, 160 GB su M, 320 GB su L, ridotto quando è pieno | Organizzazioni e account personali, prezzo fisso |
Cosa fa Skipbox con il disco
Ogni piano include la macchina del tuo account, tenuta tra un job e l'altro, con il disco della sua dimensione:
- Il disco è di 80 GB su S, 160 GB su M, 320 GB su L.
- Quello che ci resta è il tuo stato: immagini, layer e cache di build di Docker,
~/.npm, lo store di pnpm,~/.cache, le cache di Go, Gradle, Maven e Cargo, e i tool installati dasetup-*. Quello che salvaactions/cacheresta accanto alla macchina, fino a metà del disco. - Non si riempie. Niente viene cancellato finché il disco non è pieno oltre l'85% dopo un job. Allora torna al 75%, partendo da quello usato meno di recente: le immagini dangling, poi la cache di build di Docker, poi intere cache dei pacchetti e build conservate. Solo se è ancora oltre l'85% la macchina viene azzerata.
- Più disco è a un piano di distanza. Un job che scrive da solo decine di gigabyte, come immagini grandi o un albero di build esteso, ha 160 GB su M e 320 GB su L.
| Etichetta | Macchina | Disco | Piano |
|---|---|---|---|
skipbox | 4 vCPU · 16 GB | 80 GB | S, $39 al mese |
skipbox-8x16 | 8 vCPU · 16 GB | 160 GB | M, $79 al mese |
skipbox-16x32 | 16 vCPU · 32 GB | 320 GB | L, $149 al mese |
I minuti sono illimitati. A 20.000 minuti al mese su 4 vCPU, GitHub fattura $222; Skipbox S costa $39.
Basta una riga
jobs:
build:
runs-on: skipbox-8x16 # was ubuntu-latest
steps:
- uses: actions/checkout@v4
# the "Free disk space" step can go
- run: docker build -t app .
skipbox-8x16 gira su un piano M; runs-on: skipbox gira su S e nella prova.
- Accedi a Skipbox con GitHub.
- Installa la GitHub App di Skipbox e scegli i repository.
- Cambia
runs-one fai push.
Sicurezza
- La macchina è solo del tuo account. Nessun job di altre aziende gira su di essa.
- Dopo ogni job vengono cancellati le credenziali, i processi e i container del runner, e anche i file di credenziali nella home directory. “VM nuova per ogni job” dà invece a ogni job una macchina nuova.
- Il codice di chi non ha accesso in scrittura (come le pull request dai fork) gira su una VM nuova che legge le tue cache ma non le può modificare.
I dettagli sono in come vengono isolati i job.
Provalo sul job che finisce il disco
La prova è gratuita per 7 giorni o 3000 minuti di job, quello che arriva prima, e non chiede la carta. Esegue runs-on: skipbox sulla macchina di S con 80 GB. Sposta lì il job, togli lo step che cancella i tool preinstallati ed eseguilo.
Domande frequenti
Quanto spazio su disco ha un runner GitHub Actions?
La documentazione di GitHub indica 14 GB di SSD per il runner Linux standard, sia nei repository privati sia in quelli pubblici, e un maintainer di runner-images ha scritto che GitHub garantisce solo 14 GB di spazio libero per entrambi. Il disco in sé è più grande, ma i tool preinstallati dell'immagine del runner riempiono il resto, quindi conta su 14 GB.
Come risolvo No space left on device in GitHub Actions?
Prima guarda cosa l'ha riempito: df -h per ogni filesystem, df -i per gli inode, sudo du -xh --max-depth=1 / per le directory più grandi, e docker system df per le immagini e la cache di build di Docker. Poi scrivi meno (fai prune di Docker tra una build e l'altra, metti in cache solo quello che ripaga), cancella i tool preinstallati che il job non usa (l'SDK Android, GHC, CodeQL, .NET), e se il job ha ancora bisogno di più spazio, eseguilo su un runner con un disco più grande.
Cosa posso cancellare da ubuntu-latest per liberare spazio su disco?
I tool che il job non usa. Gli utenti nelle issue di runner-images di GitHub rimuovono /usr/local/lib/android (12 GB nell'elenco di un utente), /usr/local/.ghcup, /opt/hostedtoolcache/CodeQL, /usr/share/dotnet e /usr/local/share/boost. Rimuovere $AGENT_TOOLSDIRECTORY libera anche la hosted tool cache, ma rompe gli step di setup che si aspettano lì i loro tool. Cancellare gigabyte richiede tempo a ogni esecuzione.
I runner più grandi di GitHub hanno più disco?
Sì: 75 GB a 2 vCPU, 150 GB a 4, 300 GB a 8, fino a 2.040 GB a 64 e 96 vCPU. Sono solo per le organizzazioni su GitHub Team o GitHub Enterprise Cloud, fatturati al minuto.
Quanto disco dà Skipbox a un job?
La macchina del tuo account ha 80 GB su S, 160 GB su M e 320 GB su L. Le cache conservate tra un job e l'altro condividono quel disco: dopo un job che lo lascia pieno oltre l'85%, viene ridotto al 75%, partendo da quello usato meno di recente, quindi non si riempie come il disco di un runner self-hosted. A un job che scrive da solo decine di gigabyte, M e L danno lo spazio che serve.
Quanto costa provarlo?
Niente. La prova dura 7 giorni o 3000 minuti di job, quello che arriva prima, senza carta, sulla macchina di S. Sposta il job che finisce il disco su runs-on: skipbox e togli gli step che cancellano i tool preinstallati.
Aggiornata il giorno 16 novembre 2026