ID.nl logo
Zo gebruik je een docker op je Raspberry Pi
© Reshift Digital
Huis

Zo gebruik je een docker op je Raspberry Pi

Een Raspberry Pi is ideaal om allerlei programma’s op te installeren die altijd moeten draaien. De betrouwbaarste manier om dat te doen, is met Docker: zo draait elk programma geïsoleerd in een container, waardoor ze elkaar niet kunnen hinderen. We laten zien hoe je Docker op een Raspberry Pi gebruikt en waarop je zoal dient te letten.

Als je al even een Raspberry Pi in huis hebt, is de kans groot dat je er meer en meer software op blijft installeren. Home Assistant,Zwave2Mqtt, Node-RED, Rhasspy … Dat gaat allemaal goed, tot je al je software eens naar een nieuwe versie bijwerkt, en plots een van je programma’s niet meer werkt en een vage foutmelding geeft.

Wat is er gebeurd? Een veel voorkomend scenario is het volgende. Software A en B gebruiken beide versie 1.0 van bibliotheek C. Ondertussen komt versie 2.0 van bibliotheek C uit, die incompatibel is met C 1.0. Software A wordt herschreven om van bibliotheek C 2.0 gebruik te maken, terwijl de ontwikkelaars van software B niet zo snel zijn en nog even bij bibliotheek C 1.0 blijven. Je updatet software A en daardoor wordt bibliotheek C 2.0 geïnstalleerd. Maar Raspbian kan maar één versie van een bibliotheek installeren. Daardoor werkt software B plots niet meer, want die is niet compatibel met bibliotheek C 2.0.

In de praktijk doen Linux-distributies er alles aan om dit soort situaties te vermijden, maar het gebeurt. Soms op veel subtielere manieren, zodat het niet altijd onmiddellijk duidelijk is wat de oorzaak van het probleem is.

01 Wat is Docker?

Docker maakt het eenvoudig voor ontwikkelaars om toepassingen te verspreiden zodat je die op elk Linux-systeem kunt draaien. Die toepassingen vind je in de vorm van een image op de Docker Hub. Zo’n image is in feite een sjabloon voor een minimaal Linux-systeem, dat je bovenop Raspbian kunt draaien in de vorm van een container.

Elke container is volledig geïsoleerd van andere containers. De toepassing in een container ziet dus niet de toepassingen in andere containers. En door één container te installeren en bij te werken, ben je zeker dat die nieuwe versie niet in conflict komt met toepassingen in andere containers. Als je meer dan een handvol toepassingen op je Raspberry Pi wilt draaien, helpt Docker je dus om dat op een betrouwbare manier te doen. Dankzij Docker kun je ook gerust experimenteren met nieuwe software: bevalt die je niet, dan verwijder je achteraf gewoon de container.

©PXimport

02 Installeer Docker

We gaan ervan uit dat je Raspbian hebt geïnstalleerd, de Lite-versie is voldoende. Daarna log je in via ssh om de opdrachten in deze basiscursus uit te voeren. Als eerste installeer je Docker met de opdracht:

curl -sSL https://get.docker.com | sh

Geef daarna de gebruiker pi (waarmee je ingelogd bent) toegang tot Docker, zodat je niet alle Docker-opdrachten met het commando sudo moet uitvoeren:

sudo usermod pi -aG docker

Log uit met exit en log daarna weer in. Nu behoort de gebruiker pi tot de groep docker.

©PXimport

03 Hallo wereld

Je zou nu een eerste Docker-container moeten kunnen opstarten:

docker run --rm hello-world

Met deze opdracht draai je de Docker-container hello-world. Deze container toont in zijn uitvoer wat er exact gebeurt: het image wordt niet op je Raspberry Pi gevonden en wordt dan door Docker van de Docker Hub gedownload. Daarna maakt Docker een container op basis van dit image en voert het programma erin uit. Door de optie --rm wordt de container na het afsluiten van het programma opgeruimd. Je weet nu dat Docker correct geïnstalleerd is en werkt.

©PXimport

Hypriot

We installeren in deze basiscursus eenvoudigweg Docker op Raspbian, maar er zijn ook andere besturingssystemen mogelijk als je geïnteresseerd bent in Docker op een Raspberry Pi. Zo is er Hypriot: een besturingssysteem voor de Raspberry Pi dat is geoptimaliseerd voor gebruik van Docker. Je hoeft dan alleen maar dit image op het micro-sd-kaartje van je Raspberry Pi te installeren en je kunt onmiddellijk met Docker aan de slag. Hypriot is vooral interessant als je alleen maar Docker-containers op je Raspberry Pi draait en niets anders.

04 Maak containers aan

De basis om met Docker-containers te werken, gebeurt met de opdracht docker, zoals we in de vorige stap al toonden. Meestal wil je met Docker geen container uitvoeren en onmiddellijk afsluiten, maar die laten draaien. We gebruiken dan dus niet de optie --rm. Bovendien wil je die container op de achtergrond laten draaien, zonder de uitvoer de hele tijd op het scherm te zien. Daarvoor dient de optie -d.

Als je een container op deze manier zou opstarten, geeft Docker die een willekeurige naam, wat niet handig is als je meer dan een handvol containers hebt. Met de optie --name NAAM geef je de container daarom een vaste naam.

Dan moet je ook nog kijken naar de netwerkverbindingen. Aangezien elke Docker-container geïsoleerd is, krijg je niet zomaar toegang tot bijvoorbeeld een webserver die op poort 80 draait in een container. Daarom moet je Docker opdragen om elke aanvraag op bijvoorbeeld poort 8888 op de Raspberry Pi door te sturen naar poort 80 in een specifieke container. Dat doe je met de optie -p 8888:80. Als je al deze opties samenneemt voor de voorbeeldcontainer containous/whoami, voer je de volgende opdracht uit:

docker run -d --name whoami -p 8888:80 containous/whoami

Als alles goed gaat, krijg je na een tijdje een lange tekenreeks met hexadecimale cijfers te zien (zoals 5122c935ce5178751a59699d2c5605c607700bd04e5f57a6c18de434ae53956e). Dit is het ID van de container. Als je nu in je webbrowser surft naar http://IP:8888 met in plaats van IP het ip-adres van je Raspberry Pi, krijg je een webpagina te zien die door de webserver in de container gegenereerd wordt.

©PXimport

05 Bekijk je containers

Als je zo enkele containers hebt opgestart, begint het beheer belangrijk te worden. Allereerst is het nuttig om te zien welke containers er draaien:

docker ps

Je krijgt dan informatie over alle containers te zien die actief zijn (met de optie -a erbij ook van de containers die zijn gestopt). In de eerste kolom staat een uniek ID voor elke container, daarnaast het image op basis waarvan de container aangemaakt is. De kolom STATUS bekijk je het best bij problemen. Als je container bijvoorbeeld bij een probleem maar blijft herstarten, zie je dat hier.

In de kolom PORTS zie je de gebruikte poorten. Voor onze container whoami staat daar bijvoorbeeld 0.0.0.0:8888->80/tcp. Dat betekent dat tcp-poort 8888 op de Raspberry Pi wordt omgeleid naar tcp-poort 80 op de container. In de laatste kolom zie je de naam van de container, die kun je in verdere Docker-opdrachten gebruiken.

Wil je meer informatie, dan komt het commando docker stats van pas. Je krijgt dan van elke container statistieken te zien, zoals het verbruik van de processor, het geheugen en het netwerk. Wil je alle informatie die Docker over een specifieke container kent, voer dan dit commando uit met het ID of de naam van de container:

docker inspect CONTAINER

En wil je tot slot de logs bekijken van een container, voer dan een van deze twee opdrachten uit:

docker logs CONTAINERdocker logs -f CONTAINER

Met de optie -f volg je de logs realtime terwijl de container ze genereert.

©PXimport

06 Beheer je containers en images

Als je een container wilt stoppen, starten of een draaiende container herstarten, kan dat eenvoudig met respectievelijk deze commando’s:

docker stop CONTAINERdocker start CONTAINERdocker restart CONTAINER

Wil je tijdelijk een container pauzeren (alle programma’s erin worden dan tijdelijk ‘bevroren’), voer dan deze opdracht uit:

docker pause CONTAINER

Na deze opdracht draaien alle programma’s in de container opnieuw:

docker unpause CONTAINER

Met het commando docker images krijg je de lijst te zien van de images die Docker gedownload heeft. Voor onze whoami-container zie je in de kolom REPOSITORY de tekst containous/whoami staan en in de kolom TAG staat latest. De volledige naam van het image zou containous/whoami:latest zijn, maar die latest is de standaardwaarde voor de tag, dus kan weggelaten worden. Daarom dat we in onze opdracht in paragraaf 4 met docker run gewoon containous/whoami als image hebben opgegeven.

In de kolom CREATED zie je hoelang geleden dit image is gedownload. Wil je dit image updaten, dan voer je de volgende opdracht uit:

docker pull containous/whoami:latest

Docker downloadt dan de nieuwste versie van het image of vertelt je dat het image up-to-date is. Als je daarna nog eens docker images uitvoert, zie je dat er een image is bijgekomen.

Maar de huidige whoami-container gebruikt nog altijd het oude image. Om dit te upgraden, stop (docker stop whoami) en verwijder (docker rm wohami) je de container, en creëer je de container opnieuw met de opdracht docker run uit paragraaf 4.

©PXimport

Opruimen

Update je regelmatig je Docker-images om de nieuwste versie in een container te draaien, dan blijven de oude images gewoon staan. De micro-sd-kaart van je Raspberry Pi met een capaciteit van hoogstens enkele tientallen gigabytes kan daardoor snel vol raken, zeker als je grote containers draait. Zo zijn containers zoals die van Home Assistant en Rhasspy meer dan een gigabyte groot. Nu werkt Docker wel met een systeem zodat bij een update niet die volledige gigabyte opnieuw gedownload en opgeslagen wordt, maar na vele updates blijft de benodigde opslag wel toenemen. Met de opdracht docker rmi IMAGE_ID verwijder je een image op basis van het ID dat je in de uitvoer van de opdracht docker images vindt. Docker kent ook de opdracht docker image prune waarmee je alle images verwijdert die niet door een container worden gebruikt. Met docker system prune verwijder je ook gestopte containers, netwerken die niet tenminste door één container worden gebruikt en cachebestanden.

©PXimport

07 Volumes

Onze voorbeeldcontainer whoami maakte geen gebruik van configuratiegegevens of data. Maar je kunt een directory op je Raspberry Pi delen met een Docker-container, zodat die toegang krijgt tot gegevens daarvan. Zo’n gedeelde directory noemt Docker een volume.

Als je met meerdere containers op je Raspberry Pi gaat werken, is het aan te raden om hun directory’s allemaal bij elkaar te zetten. Maak een directory daarvoor aan, bijvoorbeeld met:

mkdir -p /home/pi/containers/nginx/data

Plaats dan in de map containers/nginx/data een bestand index.html met een html-pagina.

Dan kun je nu een container met nginx (een webserver) opstarten waarmee je deze directory deelt:

docker run -d --name nginx -p 8080:80 -v /home/pi/containers/nginx/data:/usr/share/nginx/html:ro nginx

Daarna start de container met de webserver op en koppelt die de directory /home/pi/containers/nging/data op je Raspberry Pi in de container aan op de locatie /usr/share/nginx/html, met alleen leesrechten (ro staat voor read-only). Als je nu surft naar IP:8080 krijg je het html-bestand index.html te zien.

©PXimport

08 Docker Compose

Tot nu toe hebben we handmatig Docker-containers opgestart met opdracht docker run. Maar als je wat meer Docker-containers draait en regelmatig hun configuratie wilt aanpassen, is een andere aanpak beter: alles in één configuratiebestand zetten. Dat gaat met Docker Compose.

Installeer daarvoor eerst Pythons pakketbeheerder pip en dan Docker Compose (dat een Python-programma is) met deze opdrachten:

sudo apt install python3-pip

sudo pip3 install docker-compose

Nu kun je de configuratie van meerdere Docker-containers in een bestand docker-compose.yml zetten. Maak daarvoor een Docker Compose-bestand aan met:

nano docker-compose.yml

Plaats daarin de volgende configuratie voor onze voorbeeldcontainers whoami en nginx:

version: '3.7'services:whoami:image: containous/whoamicontainer_name: whoamirestart: alwaysports:- 8888:80nginx:image: nginxcontainer_name: nginxrestart: alwaysports:- 8080:80volumes:- /home/pi/containers/nginx/data:/usr/share/nginx/html:ro

09 YAML

Sla het bestand op met Ctrl+O en sluit nano af met Ctrl+X. Het gaat hier om een YAML-bestand (met de extensie .yml). YAML (staat voor de recursieve afkorting ‘YAML Ain’t Markup Language’) is een bestandsformaat om configuratiegegevens op een leesbare manier te definiëren. Meer info vind je op de officiële website.

Je ziet in dit bestand dat we twee containers als services definiëren. Bij elke container definiëren we het gebruikte image, de naam die de container moet krijgen en of de container vanzelf moet herstarten bij problemen. Daarnaast definiëren we ook de omgeleide poorten en de volumes.

Al deze informatie vind je ook op de opdrachtregels met docker run, maar in dit Docker Compose-bestand is het wat overzichtelijker.

©PXimport

10 Werken met Docker Compose

Zodra je een bestand docker-compose.yml hebt, kun je eenvoudig de erin gedefinieerde containers aanmaken en opstarten:

docker-compose up -d

Daarna kun je deze containers beheren met de docker-opdracht, maar docker-compose heeft zelf ook heel wat opties specifiek om containers te beheren die je met Docker Compose hebt aangemaakt. Zo ruim je alles op met de volgende opdracht, alle gedefinieerde containers worden gestopt en verwijderd:

docker-compose down

Verder kun je de logs van alle containers opvolgen met:

docker-compose logs -f

Elke container geeft zijn logmeldingen daarbij in een andere kleur. Ook Docker Compose heeft een bekend riedeltje voor het stoppen, starten en herstarten van alle containers:

docker-compose stop

docker-compose start

docker-compose restart

Alle containers in je Docker Compose-bestand updaten doe je met de volgende twee opdrachten:

docker-compose pull

docker-compose restart

De eerste opdracht downloadt nieuwe images voor alle containers die je hebt gedefinieerd en de tweede opdracht herstart al die containers zodat ze het nieuwe image gebruiken. Daarna kun je indien gewenst de oude images verwijderen met:

docker image prune

11 En verder

Van veel toepassingen vind je Docker-images op Docker Hub. Op LinuxServer.io vind je ook tientallen Docker-images die door vrijwilligers worden bijgehouden. Deze images zijn goed onderhouden en gedocumenteerd, en ze gebruiken allemaal een vergelijkbare aanpak en basisinfrastructuur.

Probeer je te beperken tot ‘officiële’ Docker-images, die door een project zelf worden aangeboden, of images van betrouwbare partijen zoals LinuxServer.io. Want iedereen kan in principe Docker-images publiceren op Docker Hub, maar ze worden niet altijd up-to-date gehouden.

©PXimport

De juiste processorarchitectuur

Het is belangrijk dat je Docker-images voor de juiste processorarchitectuur downloadt. De Raspberry Pi heeft een ARM-processor, die niet compatibel is met de Intel- of AMD-processoren die je in pc’s vindt. Veel Docker-images worden zo gepubliceerd dat automatisch de juiste versie voor je processorarchitectuur wordt gedownload. Op Docker Hub vind je bij de pagina over het gewenste Docker-image welke architecturen zijn ondersteund. Voor Raspbian is dat arm32v7, arm/v7 of armhf. Als je bij het starten van een Docker-container de foutmelding exec format error krijgt, heb je waarschijnlijk een image van de verkeerde processorarchitectuur gedownload. Als dat gebeurt, dien je een image met een andere tag te downloaden. Zo verspreidt het project motionEye zijn officiële Docker-image met twee mogelijke tags: je draait ccrisan/motioneye:master-amd64 op Intel-compatibele processoren en ccrisan/motioneye:master-armhf op een Raspberry Pi.

▼ Volgende artikel
De Forza Horizon 6-releasedatum is mogelijk gelekt
Huis

De Forza Horizon 6-releasedatum is mogelijk gelekt

Het lijkt er op dat Microsoft zelf de releasedatum van het langverwachte Forza Horizon 6 heeft gelekt. De game zou op 19 mei uitkomen op Xbox Series-consoles en pc.

Nieuw op ID: het complete plaatje

Misschien valt het je op dat er vanaf vandaag ook berichten over games, films en series op onze site verschijnen. Dat is een bewuste stap. Wij geloven dat technologie niet stopt bij hardware; het gaat uiteindelijk om wat je ermee beleeft. Daarom combineren we onze expertise in tech nu met het laatste nieuws over entertainment. Dat doen we met de gezichten die mensen kennen van Power Unlimited, dé experts op het gebied van gaming en streaming. Zo helpen we je niet alleen aan de beste tv, smartphone of laptop, maar vertellen we je ook direct wat je erop moet kijken of spelen. Je vindt hier dus voortaan de ideale mix van hardware én content.

Volgens Xbox Infinite verscheen er namelijk een advertentie in Forza Horizon 5 waarin staat dat de Premium Edition van de game toegang geeft vanaf 15 mei, om precies te zijn vier dagen voor de officiële release. Dat zou dus betekenen dat het spel op 19 mei voor iedereen beschikbaar komt. De advertentie is mogelijk te vroeg online gekomen, want officieel is er nog helemaal geen releasedatum bekend.

Waarschijnlijk horen we de officiële releasedatum op 22 januari. Dan zendt Microsoft namelijk een nieuwe Xbox Developer Direct uit, met een focus op Forza Horizon 6 en de nieuwe Fable – die beide worden ontwikkeld door Playground Games. Ook komt Beast of Reincarnation voorbij, de nieuwe game van Pokémon-studio Game Freak. Dat is immers een onafhankelijke studio, dus ze kunnen ook spellen buiten Nintendo ontwikkelen. Tot slot gaan er geruchten dat er een mysterieuze vierde titel wordt getoond, mogelijk een indiegame.

Op veler verzoek: racen in Japan

In de Forza Horizon-games kunnen spelers naar hartenlust rondscheuren in mooie bolides. De games spelen zich af in open werelden, waarbij men de mogelijkheid heeft om aan diverse racefestivals mee te doen. Forza Horizon 6 heeft als setting Japan – een locatie waar veel fans al geruime tijd om vragen. Ook zullen net als in de vorige games de seizoenen veranderen. Het betreft een subreeks van Forza Motorsport – dat zijn serieuzere racegames ten opzichte van de wat speelsere Horizon-titels.

Forza Horizon 6 heeft op moment van schrijven in ieder geval nog geen officiële releasedatum, al is wel bekend dat het racespel eerst naar Xbox Series-consoles en pc komt alvorens hij op PlayStation 5 zal verschijnen. Microsoft brengt zijn games tegenwoordig ook steeds vaker naar Sony’s console – soms tegelijk met de Xbox-versie, maar in dit geval dus pas ergens daarna.

View post on X
▼ Volgende artikel
Starten met smarthome in één middag: een stappenplan voor beginners
Zekerheid & gemak

Starten met smarthome in één middag: een stappenplan voor beginners

Een slim huis klinkt ingewikkeld, maar je kunt de basis prima in een paar uur neerzetten. Met de juiste voorbereiding en focus op specifieke producten maak je jouw woning direct een stuk comfortabeler. In dit artikel leggen we je uit hoe je binnen één middag de eerste stappen zet zonder dat het je boven het hoofd groeit.

Veel mensen denken dat het opzetten van een slim huis een langdurig en ingrijpend project is waarbij je muren moet openbreken voor bekabeling. De werkelijkheid is dat moderne draadloze standaarden en gebruiksvriendelijke apps het proces enorm hebben versneld. Als je meteen vanaf het begin slimme keuzes maakt, bespaar je jezelf een hoop ellende en frustratie later. Het gaat erom dat je klein begint en kiest voor apparatuur die soepel met elkaar samenwerkt via een centraal punt, zodat je niet voor elk los onderdeel een andere bedieningswijze nodig hebt.

De basis: een stabiel netwerk en een hub

Voordat je begint met het uitpakken van nieuwe gadgets, moet je zorgen dat de fundering van je slimme woning stevig staat. Je wifi-netwerk is de ruggengraat van al je apparaten, dus controleer of de dekking in de ruimtes waar je aan de slag gaat voldoende is. Het is vaak slim om te kiezen voor een centrale hub of een slimme speaker die als brug dient voor verschillende protocollen zoals Zigbee of Matter. Door te kiezen voor een apparaat dat meerdere standaarden ondersteunt, voorkom je dat je voor elk nieuw lampje een aparte brug in het stopcontact moet steken. Dat scheelt niet alleen ruimte, maar zorgt ook voor een snellere reactietijd van je apparatuur omdat signalen minder hoeven te reizen.

©Philips Hue

Direct resultaat met slimme verlichting en stekkers

De snelste manier om je huis slim te laten aanvoelen, is door te beginnen met de verlichting. Je vervangt je oude lampen simpelweg door slimme varianten en koppelt deze aan de bijbehorende app op je telefoon. In diezelfde middag kun je direct eenvoudige automatiseringen instellen, zoals lampen die automatisch op een warme kleur overgaan wanneer de avond valt. Slimme stekkers zijn hierop een goede aanvulling voor apparaten die van zichzelf niet verbonden zijn, zoals een oude staande lamp of een koffiezetapparaat. Hiermee breid je de functionaliteit van je bestaande spullen uit zonder dat je grote investeringen hoeft te doen, waardoor je direct de voordelen merkt van een slim huis.

Beveiliging en sensoren voor extra gemak

Nu de basis staat, kun je kijken naar eenvoudige sensoren die het dagelijks leven makkelijker maken zonder dat ze opvallen. Een bewegingsmelder in de gang of een deursensor bij de voordeur zorgt ervoor dat je nooit meer in het donker hoeft te zoeken naar een lichtknopje als je met je handen vol thuiskomt. Deze kleine apparaten werken vaak op batterijen en zijn binnen enkele minuten geïnstalleerd met een eenvoudige plakstrip. Je kunt ze direct koppelen aan de verlichting die je eerder die middag hebt opgehangen. Zo creëer je in korte tijd een samenhangend systeem dat reageert op jouw aanwezigheid en de veiligheid in huis direct verhoogt door ongewenste bewegingen te signaleren.

Populaire merken voor smarthome

Voor wie op zoek is naar een vliegende start, zijn er verschillende fabrikanten die uitblinken in gebruiksgemak en betrouwbaarheid. Philips Hue is al jaren de standaard voor verlichting vanwege de stabiliteit en de enorme keuze aan lichtscènes. Als je liever een breder assortiment zoekt tegen een toegankelijke prijs, dan biedt IKEA met de Home Smart-lijn uitstekende oplossingen die goed samenwerken met andere grote ecosystemen. Google Nest is een sterke keuze voor wie een centraal punt zoekt in de vorm van slimme schermen en speakers met een krachtige spraakassistent. Voor de gebruikers die graag alles van verschillende merken aan elkaar willen knopen, is het Nederlandse Homey een interessant merk dat bijna alle protocollen ondersteunt in één handige interface.