Problemen oplossen

Eerst: lees de laatste regel

Een Docker-foutmelding begint vaak met algemene tekst en eindigt met de echte oorzaak. Bijvoorbeeld:

docker: Error response from daemon: pull access denied for registry.wizg.it/webhosting/beetjecoderen-web, repository does not exist or may require 'docker login': denied: requested access to the resource is denied.

De nuttige woorden zijn denied, does not exist en docker login. Zoek altijd naar zulke woorden, en kopieer bij twijfel de hele melding als je hulp vraagt.

arm64 en amd64

Processoren spreken verschillende "talen" (architecturen):

• amd64 (ook x86-64): de meeste Windows-pc's, oudere Macs met Intel, de meeste servers;
• arm64 (ook aarch64): Macs met Apple silicon (M1 en nieuwer), Raspberry Pi 4/5, sommige nieuwe Windows-laptops.

Een programma in een image is gemaakt voor één architectuur. Veel images, ook de lab-images van beetjecoderen.nl, bestaan daarom in een versie voor amd64 én voor arm64. Docker kiest dan vanzelf de goede. Een image dat je zelf bouwt met docker build, wordt automatisch voor jouw eigen architectuur gemaakt.

Problemen krijg je bij images die alleen voor de andere architectuur bestaan. Je ziet dan bijvoorbeeld:

no matching manifest for linux/arm64/v8 in the manifest list entries

of een waarschuwing:

WARNING: The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8)

Wat kun je doen?

• Kijk welke architectuur je hebt: docker version toont bij Server de regel OS/Arch, bv. linux/arm64.
• Kijk welke architectuur een image heeft: docker image inspect --format '{{.Architecture}}' <imagenaam>.
• Bestaat er geen versie voor jouw processor, dan kan Docker Desktop een amd64-image emuleren met --platform linux/amd64 achter docker run. Dat werkt meestal, maar is merkbaar trager. Kan het, bouw het image dan liever zelf.
• Fout exec format error bij het starten: het programma in de container hoort bij een andere architectuur. Verwijder het image (docker rmi <imagenaam>) en haal of bouw het opnieuw.

Poorten

Een container heeft een eigen netwerk. Start je in een lab een webserver (bijvoorbeeld een PHP- of Python-server op poort 8000), dan kun je die vanaf je eigen browser alleen bereiken als je de poort doorgeeft met -p:

docker run -it --rm -p 8000:8000 -e BEETJE_COURSE=php -e BEETJE_LESSON=5 registry.wizg.it/webhosting/beetjecoderen-web:lab-php-latest

-p 8000:8000 betekent: poort 8000 op je computer gaat naar poort 8000 in de container (links je computer, rechts de container). Voor de meeste labs heb je dit niet nodig. De opdracht vertelt het als het wel zo is. Daarnaast zie je in de lab-images een EXPOSE 7681; die poort hoort bij het live lab in de browser en heb je lokaal niet nodig.

Twee bekende problemen:

• port is already allocated of address already in use: een ander programma (of een andere container) gebruikt die poort al. Kies links een ander nummer, bv. -p 8081:8000, en open dan http://localhost:8081.
• De pagina laadt niet, terwijl de server in de container draait. Luistert de server alleen op 127.0.0.1, dan is hij alleen binnen de container bereikbaar. Start hem op 0.0.0.0, bijvoorbeeld php -S 0.0.0.0:8000 of python3 -m http.server 8000 --bind 0.0.0.0.

Schijfruimte

Images, gestopte containers en de bouwcache kosten ruimte. De lab-images zijn al snel honderden MB per stuk. Bekijk wat Docker gebruikt:

docker system df

TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          6         1         2.9GB     2.1GB (72%)
Containers      14        1         120MB     118MB (98%)
Local Volumes   2         1         85MB      40MB (47%)
Build Cache     38        0         1.3GB     1.3GB

De kolom RECLAIMABLE is wat je kunt terugwinnen. Opruimen kan stap voor stap:

docker container prune   # gestopte containers
docker image prune       # images zonder naam (overblijfsels van updates)
docker builder prune     # de bouwcache van docker build

Of alles in één keer met docker system prune. Dat verwijdert:

• alle gestopte containers;
• netwerken die niet gebruikt worden;
• images zonder naam (dangling images);
• de bouwcache.

Docker vraagt eerst om bevestiging. Twee varianten om voorzichtig mee te zijn:

• docker system prune -a verwijdert ook alle images die op dat moment door geen enkele container gebruikt worden, dus ook je lab-images. Die moet je daarna opnieuw downloaden of bouwen.
• docker system prune --volumes verwijdert ook volumes die niet in gebruik zijn. Bewaar je labwerk in een volume (les 3), dan is dat werk weg. Werk je met een bind mount, dan staan je bestanden veilig op je eigen schijf.

Op Windows en macOS staat alles van Docker in één groot bestand van Docker Desktop. Na het opruimen krimpt dat niet altijd meteen. Bij Settings → Resources stel je in hoeveel ruimte en geheugen Docker mag gebruiken.

Overige meldingen

• the input device is not a TTY: je gebruikt -t in een omgeving zonder echte terminal, zoals Git Bash op Windows (zet winpty voor docker) of in een script (laat -t weg).
• Permission denied in een gekoppelde map: zie de valkuilen bij rechten in les 3 (--user en eerst mkdir -p).
• docker: invalid reference format: er zit iets mis in de imagenaam, vaak een hoofdletter, een spatie of een -v-pad met een spatie zonder aanhalingstekens. Docker ziet dan een deel van het pad als imagenaam.