Docker-installatie op WSL 2 - Eerste containerinstallatie

Controleer eerst uw pc

Docker Desktop met de WSL 2-backend heeft drie dingen nodig, en als je deze twee minuten durende controle overslaat, verliezen mensen een avond. Ten eerste de Windows-versie: je hebt Windows 10 versie 2004 of hoger nodig, of Windows 11. Druk op Win + R, typ winver en druk op Enter om je exacte versie te zien.

winver

Ten tweede moet virtualisatie ingeschakeld zijn in het BIOS of UEFI. Open Taakbeheer, ga naar Prestaties, vervolgens CPU en zoek naar Virtualisatie: ingeschakeld. Als er Uitgeschakeld staat, kan geen enkele software-instelling u redden. Schakel eerst Intel VT-x of AMD SVM in het BIOS in. Ten derde: houd ongeveer 4 GB vrij RAM-geheugen en een paar GB vrije schijfruimte over: WSL 2 en Docker delen uw machine, ze vervangen deze niet.

Installeer WSL 2 vóór alles

De meeste mislukte Docker-installaties op Windows mislukken om één saaie reden: de volgorde was verkeerd. Docker Desktop verwacht eronder een werkende WSL 2, dus bouw eerst de basis. Open PowerShell als beheerder en voer één opdracht uit:

wsl --install

Laat het voltooien en start vervolgens de pc opnieuw op. Het opnieuw opstarten is niet optioneel, het laadt de virtualisatiecomponenten. Na het opnieuw opstarten voltooit Ubuntu (de standaarddistro) zijn eigen installatie en wordt u gevraagd een Linux-gebruikersnaam en -wachtwoord aan te maken.

Controleer of WSL 2 echt klaar is

Voordat Docker ook maar in de buurt van de machine komt, bevestigt u de fundering met twee opdrachten:

wsl --status
wsl -l -v

Je distributie zou VERSIE 2 in de lijst moeten weergeven. Als er 1 wordt weergegeven, stel dan de standaardversie in en converteer de distro zoals de opdrachtuitvoer suggereert:

wsl --set-default-version 2

Elke laag wordt getest voordat de volgende wordt toegevoegd. Als er later iets mislukt, weet je precies welke laag het probleem veroorzaakt.

Installeer Docker Desktop bovenaan

Download Docker Desktop alleen van docker.com: downloadsites van derden bundelen rommel met populaire installatieprogramma's. Voer het installatieprogramma uit en houd de optie Gebruik WSL 2 in plaats van Hyper-V aangevinkt; op de meeste pc's is dit standaard aangevinkt.

Als het installatieprogramma daarom vraagt, sluit u het af en meldt u zich af of start u het opnieuw op als daarom wordt gevraagd. Docker voegt je Windows-account toe aan de lokale docker-users groep, en het groepslidmaatschap wordt pas van kracht als je opnieuw inlogt. Dit is de eerlijke controle die de meeste handleidingen overslaan, en daarom weigert Docker soms te starten totdat je uitlogt en weer inlogt.

Start Docker Desktop en wacht tot het walvispictogram in het systeemvak is verdwenen en het dashboard meldt dat de engine draait. De eerste start is langzaam; geef het een paar minuten. Accepteer het Docker Subscription Service Agreement-scherm eerlijk: het is een echte licentie.

Voer uw eerste container uit: Hallo wereld

Open een nieuw PowerShell- of Terminal-venster en voer de twee opdrachten uit die bewijzen dat de hele keten werkt:

docker --version
docker run hello-world

docker --version bewijst dat de client is geïnstalleerd en zich op uw PATH bevindt. docker run hello-world bewijst al het andere: Docker kan de afbeelding niet lokaal vinden, downloadt deze van Docker Hub, maakt er een container van, voert deze uit en drukt het bericht Hallo van Docker! af. Als dat bericht verschijnt, werkt uw keten van begin tot eind: terminal, client, engine binnen WSL 2, netwerk en register.