Docker Hello World: inizia e verifica che tutto funzioni

Hai eseguito l’installer, hai fatto clic attraverso la configurazione e Docker dice che è pronto. Ma come puoi esserne davvero sicuro? Ogni guida Docker online dà per scontato che tu abbia già verificato la configurazione, ma nessuno spiega come fare davvero quel passaggio di verifica.

La buona notizia è che Docker fornisce un’immagine di test integrata chiamata hello-world che conferma che tutto funziona. Ti basta eseguire un solo comando per avere un riscontro immediato se Docker è configurato correttamente.

In questo articolo ti mostro cosa fa l’immagine hello-world, come eseguirla, cosa significa l’output e come risolvere i problemi più comuni quando qualcosa va storto.

Dopo aver eseguito l’esempio Hello World, sei pronto per imparare le basi di Docker. Il nostro corso Introduzione a Docker ti metterà in pista in un pomeriggio.

Cos’è Docker Hello World?

L’immagine hello-world è lo strumento diagnostico ufficiale di Docker per testare l’installazione.

Docker mantiene questa immagine come il container più piccolo possibile in grado di dimostrare che Docker funziona. È un minuscolo eseguibile che stampa un messaggio di conferma e termina. Tutto qui.

Docker fornisce hello-world perché i nuovi utenti hanno bisogno di un modo rapido per verificare tre cose:

• Docker è installato correttamente sul tuo sistema
• Hai le autorizzazioni giuste per eseguire i comandi Docker
• Il demone Docker è accessibile e risponde alle richieste

Pensalo come eseguire python --version dopo aver installato Python. Stai solo confermando che lo strumento è pronto all’uso, non stai ancora costruendo nulla.

Come eseguire Docker Hello World

Eseguire l’immagine hello-world richiede un solo comando.

docker run hello-worldOfferto da

Quando esegui questo comando, Docker fa due cose:

• Controlla se l’immagine esiste localmente. Docker cerca nella cache locale delle immagini per vedere se hai già scaricato hello-world. Se l’immagine è presente, Docker salta il download e passa direttamente all’esecuzione.

• Se l’immagine non viene trovata localmente, Docker la scarica da Docker Hub. Docker Hub è il registry predefinito in cui Docker archivia le immagini ufficiali. L’immagine hello-world è minuscola — solo pochi kilobyte, quindi il download è rapidissimo.

Dopo che Docker ha l’immagine, crea ed esegue un container a partire da essa. Il container esegue il suo programma integrato, stampa il messaggio di conferma e termina.

Cosa succede quando esegui Docker Hello World?

Ecco il flusso passo passo quando esegui docker run hello-world.

Per prima cosa Docker controlla se l’immagine esiste localmente. Cerca nella cache locale per vedere se hai già scaricato hello-world. Se l’immagine è presente, Docker passa allo step successivo. In caso contrario, si connette a Docker Hub e scarica l’immagine.

Poi Docker crea un container dall’immagine. L’immagine è come un modello: contiene il programma e tutto il necessario per eseguirlo. Il container è l’istanza effettivamente in esecuzione di quel modello.

Il container esegue il suo programma, che stampa un messaggio di conferma nel terminale. Questo messaggio spiega cosa ha appena fatto Docker e conferma che tutto funziona.

Infine, il container termina. Il programma hello-world non è progettato per rimanere in esecuzione. Stampa il messaggio e si ferma subito. Il container esiste ancora sul tuo sistema, ma è in stato arrestato.

Tutto questo processo avviene automaticamente quando esegui il comando; non devi gestire manualmente nessuno di questi passaggi.

Capire l’output di Docker Hello World

Quando hello-world viene eseguito correttamente, vedrai un messaggio su più righe che spiega cosa è appena successo.

Output di docker run hello-world

L’output inizia con una conferma che Docker non ha trovato l’immagine localmente, quindi l’ha scaricata da Docker Hub. Vedrai qualcosa come "Unable to find image 'hello-world:latest' locally" seguito dalle barre di avanzamento del download.

Segue il messaggio principale che conferma che Docker funziona correttamente. Questo messaggio ti guida attraverso gli step esatti eseguiti da Docker. Spiega che il demone Docker ha scaricato l’immagine, creato un container a partire da essa, eseguito l’eseguibile al suo interno e inviato l’output al tuo terminale.

Il messaggio include anche i prossimi passi che puoi provare. Suggerisce di eseguire un container più interattivo come Ubuntu, che resta in esecuzione e ti permette di lanciare comandi al suo interno. Questo ti aiuta a capire la differenza tra un container di test una tantum e i container reali che userai in sviluppo.

Infine vedrai il container terminare. Il programma hello-world è progettato per stampare il suo messaggio e fermarsi subito — non è un servizio o un’applicazione a lunga esecuzione. Il compito del container è finito quando conferma che Docker funziona.

Se vedi questo output completo senza errori, la tua installazione di Docker funziona correttamente e sei pronto per eseguire container reali.

Problemi comuni con Docker Hello World

Anche un test semplice come hello-world può fallire se Docker non è configurato correttamente. Ecco i problemi più comuni e come risolverli.

Comando Docker non trovato

Se vedi "docker: command not found" o "docker is not recognized", Docker non è installato o non è nel PATH di sistema.

Su Linux, verifica se Docker è installato:

which dockerOfferto da

Percorso di Docker

Se non restituisce nulla, devi installare Docker. Su macOS e Windows, assicurati che Docker Desktop sia installato e in esecuzione.

Errori di permessi negati

Potresti vedere "permission denied while trying to connect to the Docker daemon socket."

Succede quando il tuo account utente non ha i permessi per accedere a Docker. Su Linux devi eseguire Docker con sudo oppure aggiungere il tuo utente al gruppo docker:

sudo usermod -aG docker $USEROfferto da

Esci e rientra perché la modifica abbia effetto. Su macOS e Windows con Docker Desktop questo non è un problema.

Demone Docker non in esecuzione

Se ricevi "Cannot connect to the Docker daemon", il servizio Docker non è in esecuzione.

Su Linux, avvia il servizio Docker:

sudo systemctl start dockerOfferto da

Su macOS e Windows, apri Docker Desktop. Il demone si avvia automaticamente quando l’applicazione è in esecuzione. Vedrai un’icona di Docker nella system tray quando è pronto.

Problemi di rete durante il download dell’immagine

A volte Docker non riesce a scaricare l’immagine hello-world da Docker Hub. Vedrai errori relativi al pull o timeout di connessione.

Per prima cosa controlla la connessione Internet. Se sei dietro un firewall o proxy aziendale, potresti dover configurare Docker per usarlo. Su Linux, questo va in /etc/systemd/system/docker.service.d/http-proxy.conf. Su Docker Desktop, puoi impostare il proxy nelle Impostazioni.

Se questi interventi non funzionano, di solito il messaggio di errore ti indirizza nella direzione giusta — leggilo con attenzione.

Cosa fare dopo Docker Hello World

Ora che hai confermato che Docker funziona, ecco dove andare dopo.

Esegui un container reale con una shell interattiva. Prova a scaricare ed eseguire un container Ubuntu:

docker run -it ubuntu bashOfferto da

Ubuntu bash

Le opzioni -it ti forniscono un terminale interattivo dentro al container. Puoi eseguire comandi, installare pacchetti ed esplorare come funzionano i container. Digita exit per uscire dal container.

Esplora le immagini disponibili su Docker Hub. Troverai immagini ufficiali per database come PostgreSQL e MySQL, linguaggi come Python e Node.js e strumenti come Redis e Nginx. Sfoglia su hub.docker.com o cerca direttamente da riga di comando:

docker search pythonOfferto da

Immagini Python disponibili.

Crea la tua immagine con un Dockerfile. Inizia semplice: crea un file chiamato Dockerfile che copia il codice della tua applicazione in un container e definisce come eseguirla. Anche un Dockerfile di base con un paio di righe ti insegnerà come le immagini vengono create da istruzioni.

Conclusione

Il comando docker run hello-world fa una cosa bene: dimostra che l’installazione di Docker funziona.

Non è un’applicazione reale. Non ti insegnerà a creare container o distribuire servizi in produzione. Ma ti darà tranquillità perché saprai che non c’è nulla di sbagliato nella tua installazione di Docker.

Se hello-world è stato eseguito senza errori e ha stampato il suo messaggio di conferma, il tuo ambiente Docker è configurato correttamente e sei pronto a lavorare con container reali.

Allora, il prossimo passo? Segui il nostro corso Introduzione a Docker. Ti darà le basi di cui avrai bisogno per lavorare in team. Dopo di che, costruisci qualcosa di utile seguendo il nostro articolo 10 idee di progetti Docker.