Docker è fuori uso? Stato in tempo reale e segnalazioni di guasti

Informazioni sul servizio e risoluzione dei problemi

Il daemon Docker non si avvia

Uno dei problemi più comuni: il daemon non parte dopo l'installazione o un aggiornamento. Prima di tutto controlla lo stato del servizio con systemctl status docker. Se vedi errori legati a cgroup o namespace, potrebbe esserci un conflitto con il kernel. Verifica che la versione del kernel sia compatibile con la versione di Docker installata. Su sistemi con SELinux attivo, alcune policy possono bloccare l'avvio: controlla i log con journalctl -u docker per individuare il blocco esatto.

Il container si avvia ma subito si ferma

Questo accade quasi sempre perché il processo principale all'interno del container termina immediatamente. Esegui il container in modalità interattiva per vedere cosa succede davvero. Controlla che il CMD o ENTRYPOINT nel Dockerfile punti a un processo che rimane in esecuzione. Un altro motivo frequente è la mancanza di variabili d'ambiente necessarie all'applicazione.

Errore nel pull delle immagini dal registry

• Verifica la connettività verso il registry: un semplice curl verso l'endpoint ti dice subito se è raggiungibile
• Controlla le credenziali salvate nel file di configurazione locale, spesso diventano obsolete dopo una rotazione dei token
• Se usi un registry privato con certificato autofirmato, aggiungi il certificato tra quelli attendibili dal sistema operativo
• Assicurati che il daemon sia configurato con l'indirizzo corretto del registry nella sezione apposita

La rete tra container non funziona

I container sullo stesso host non riescono a comunicare tra loro quando finiscono su network bridge diversi o quando le regole iptables sono state modificate da un altro servizio. Ispeziona le reti con docker network ls e verifica a quale network è collegato ciascun container. Se iptables è stato resettato manualmente, riavvia il daemon per ripristinare le regole corrette.

Build lenta o bloccata a metà

• La cache delle build può corrompersi: prova a eseguire la build con il flag che disabilita la cache per escludere questo problema
• Controlla lo spazio su disco disponibile, una build si blocca silenziosamente quando il filesystem è pieno
• Se usi BuildKit, verifica che sia abilitato correttamente nelle variabili d'ambiente prima di lanciare il comando

Volumi montati non aggiornano i file

Quando modifichi un file sull'host ma il container continua a leggere la versione vecchia, il problema è quasi sempre legato alla cache del filesystem o a inotify. Su macOS con Docker Desktop, la sincronizzazione dei file ha una latenza intrinseca: usa la modalità di mount delegata per migliorare le prestazioni. Su Linux invece verifica i permessi: se l'utente dentro il container ha un UID diverso dall'utente host, i file potrebbero risultare inaccessibili in scrittura.

Interfaccia di Docker Desktop si blocca

Riavviare l'applicazione non sempre basta. Svuota la cache locale dell'applicazione e verifica che la virtualizzazione sia abilitata nel BIOS. Su Windows, un conflitto con Hyper-V o WSL2 può causare freeze ricorrenti: aggiorna WSL2 all'ultima versione disponibile tramite il Windows Update o il comando dedicato nel terminale.