Installazione di Docker su WSL 2: prima configurazione del contenitore

Controlla prima il tuo PC

Docker Desktop con il backend WSL 2 ha bisogno di tre cose e saltare questo controllo di due minuti è il modo in cui le persone perdono una serata. Innanzitutto, la versione di Windows: è necessario Windows 10 versione 2004 o successiva o Windows 11. Premi Win + R, digita winver e premi Invio per vedere la tua versione esatta.

winver

In secondo luogo, la virtualizzazione deve essere attivata nel BIOS o UEFI. Apri Task Manager, vai su Prestazioni, quindi CPU e cerca Virtualizzazione: abilitata. Se dice Disabilitato, nessuna impostazione software ti salverà: abilita prima Intel VT-x o AMD SVM nel BIOS. In terzo luogo, mantieni circa 4 GB di RAM libera e qualche GB di spazio su disco: WSL 2 e Docker condividono la tua macchina, non la sostituiscono.

Installa WSL 2 prima di qualsiasi altra cosa

La maggior parte delle installazioni Docker fallite su Windows falliscono per un noioso motivo: l'ordine era sbagliato. Docker Desktop prevede un WSL 2 funzionante al di sotto, quindi crea prima le fondamenta. Apri PowerShell come amministratore ed esegui un comando:

wsl --install

Lascia che finisca, quindi riavvia il PC: il riavvio non è facoltativo, carica i componenti di virtualizzazione. Dopo il riavvio, Ubuntu (la distribuzione predefinita) completa la propria configurazione e ti chiede di creare un nome utente e una password Linux.

Verifica che WSL 2 sia realmente pronto

Prima che Docker si avvicini alla macchina, conferma la fondazione con due comandi:

wsl --status
wsl -l -v

La tua distribuzione dovrebbe mostrare VERSIONE 2 nell'elenco. Se mostra 1, imposta la versione predefinita e converti la distribuzione come suggerisce l'output del comando:

wsl --set-default-version 2

Ogni livello viene testato prima che venga eseguito il successivo, quindi se qualcosa fallisce in seguito, sai esattamente quale livello è responsabile del problema.

Installa Docker Desktop in alto

Scarica Docker Desktop solo da docker.com: i siti di download di terze parti raggruppano spazzatura con programmi di installazione popolari. Esegui il programma di installazione e mantieni selezionata l'opzione Usa WSL 2 invece di Hyper-V; sulla maggior parte dei PC è selezionata per impostazione predefinita.

Quando il programma di installazione lo richiede, lascialo chiudere e disconnettiti o riavvia se richiesto. Docker aggiunge il tuo account Windows al gruppo docker-users locale e l'appartenenza al gruppo ha effetto solo dopo un nuovo accesso: questo è il controllo onesto che la maggior parte delle guide salta, ed è il motivo per cui Docker a volte si rifiuta di avviarsi finché non ti disconnetti e accedi di nuovo.

Avvia Docker Desktop e attendi che l'icona della balena nella barra delle applicazioni si stabilizzi e che il dashboard segnali Motore in funzione. Il primo avvio è lento; dagli un paio di minuti. Accetta onestamente la schermata del contratto di servizio di abbonamento Docker: è una vera licenza.

Esegui il tuo primo container: Hello World

Apri una nuova finestra di PowerShell o Terminale ed esegui i due comandi che dimostrano che l'intera catena funziona:

docker --version
docker run hello-world

docker --version dimostra che il client è installato e sul tuo PERCORSO. docker run hello-world dimostra tutto il resto: Docker non riesce a trovare l'immagine localmente, la scarica da Docker Hub, crea un contenitore da essa, lo esegue e stampa il messaggio Hello from Docker!. Se viene visualizzato questo messaggio, la catena funziona end-to-end: terminale, client, motore all'interno di WSL 2, rete e registro.