Een lab starten met docker run

Het commando in stukjes

-it is gewoon -i en -t samen. Je hebt ze allebei nodig voor een terminal waarin je kunt werken. Zonder -i kun je niets typen; zonder -t krijg je geen prompt en doen toetsen als Tab en de pijltjes niets.

--rm: opruimen na afloop

Zonder --rm blijft elke gestopte container op je schijf staan. Na een paar weken labs heb je er tientallen (bekijk ze met docker ps -a). Met --rm ruimt Docker de container op zodra je hem afsluit.

Dat heeft een belangrijk gevolg: alles wat je in de container hebt gemaakt, is daarna weg. Voor een snelle oefening is dat prima. Wil je je werk bewaren, dan koppel je een map van je eigen computer aan de container. Dat leer je in de volgende les.

-e: omgevingsvariabelen

Met -e NAAM=waarde geef je een omgevingsvariabele mee aan de container. De lab-images kijken naar twee variabelen:

• BEETJE_COURSE is de actieve cursus. Eén image bevat de lessen van meerdere cursussen (het Python-image bevat bijvoorbeeld zowel de cursus python als programmeerconcepten). Bij het opstarten zet het image de startbestanden van alle lessen van deze cursus voor je klaar.
• BEETJE_LESSON is het lesnummer. De terminal begint dan meteen in de map van die les.

De waarden staan al goed in het commando onder elke les. Je hoeft ze alleen aan te passen als je in dezelfde container met een andere les verder wilt (en dat kan ook zonder opnieuw te starten, zie hieronder).

De imagenaam

Een volledige imagenaam heeft drie delen:

registry.wizg.it / webhosting/beetjecoderen-web : lab-python-latest
   registry            repository                     tag

• De registry is de server waar het image staat. Staat er geen registry in de naam (zoals bij hello-world), dan gebruikt Docker Docker Hub.
• De repository is de naam van het project.
• De tag kiest de variant. Er is één lab-image per taal:

latest betekent: de nieuwste versie. Er komen af en toe lessen bij of verbeteringen in. Met docker pull <imagenaam> haal je de nieuwste versie op.

Het image binnenhalen

De eerste keer dat je docker run met een lab-image typt, probeert Docker het image te downloaden. De lab-images zijn een paar honderd MB, dus dat duurt even.

Stand van zaken: op dit moment vraagt de registry registry.wizg.it nog om een login, ook voor de lab-images. Krijg je bij het downloaden een melding met unauthorized, dan ligt dat dus niet aan jou. Zodra de images publiek zijn, werkt docker run meteen. Tot die tijd bouw je het image één keer zelf, zoals hieronder staat. Het resultaat is precies hetzelfde.

Zelf bouwen gaat met één commando. Docker downloadt dan de bouwinstructies (zonder antwoorden van de opdrachten) van beetjecoderen.nl en maakt het image op je eigen computer:

docker build -t registry.wizg.it/webhosting/beetjecoderen-web:lab-python-latest -f python.Dockerfile https://beetjecoderen.nl/labs/lab-images.tar.gz

• -t … geeft het image dezelfde naam als in de registry. Daardoor werkt het docker run-commando uit de les daarna zonder aanpassing.
• -f python.Dockerfile kiest welk image je bouwt. Gebruik de taal uit de tag: linux.Dockerfile, c.Dockerfile, php.Dockerfile, enzovoort.
• De URL aan het eind is de bouwcontext: een archief met alle bestanden die nodig zijn.

Bouwen duurt een paar minuten (Docker downloadt onderweg o.a. Debian-pakketten) en hoeft maar één keer. Onder elke les met een lokaal lab staat dit bouwcommando ook, met de juiste taal al ingevuld.

In de container

Zodra de container start, zie je een welkomstbericht en een prompt:

Welkom in je lab van beetjecoderen.nl!
- Je lesbestanden staan in ~/lessen/<lesnummer> (bv. cd ~/lessen/05). Opdracht: OPDRACHT.md.
- Klaar? Controleer met: beetje check <les-id>   (alle lessen: beetje lijst)
...
student@lab:~/lessen/02$

Je zit nu in een Linux-shell in de container. Alles wat je typt, gebeurt daar, niet op je eigen computer. Een paar dingen om te weten:

• Je thuismap in de container is /home/student (afgekort ~).
• De lessen van je actieve cursus staan in ~/lessen/<NN>, met een lesnummer van twee cijfers: ~/lessen/02, ~/lessen/05, ~/lessen/12.
• De opdracht staat in elke lesmap in OPDRACHT.md. Lees hem met cat OPDRACHT.md of less OPDRACHT.md (stoppen met q).
• Een andere les? Gewoon cd ~/lessen/05. Alle lessen van de cursus staan al klaar.
• Alle lessen in dit image zie je met beetje lijst.
• Bestanden bewerken kan met nano (makkelijk; opslaan met Ctrl+O, stoppen met Ctrl+X) of vi.

Klaar? Typ exit of druk op Ctrl+D. De container stopt, en door --rm wordt hij opgeruimd.