Portainer is een container beheerinterface. Het begon als een GUI voor Docker, maar is uitgebreid om ook andere containeromgevingen te ondersteunen. In deze tutorial richten we ons op Docker. Om Portainer op Raspberry Pi OS te kunnen installeren, moeten we eerst Docker installeren waarmee de installatie van Portainer ondersteund wordt. Dit komt omdat Portainer als een Docker-container draait. Zodra Docker is geïnstalleerd, kunnen we Portainer installeren door de image te ‘pullen’ en de container te starten. Je kunt Portainer vervolgens gebruiken om de Docker-omgeving te beheren.
Let op! Dit is een aanvullende tutorial op de Docker tutorial. Om deze tutorial te kunnen doen, zal je eerst de Docker tutorial als (technische) voorbereiding gedaan moeten hebben anders ontbreekt de samenhang van de uitleg en de praktijk.
Daar gaan we…
Als je de Docker tutorial succesvol geïnstalleerd hebt, geef je het volgende commando in de terminal.
sudo docker pull portainer/portainer-ce:linux-arm
Met dit commando ga je naar de dockerservice en naar de server waar je om vraagt, in dit geval portainer-ce. Portainer-ce is de (gratis) community editie. Linux-arm is de versie waarop de container moet draaien, de Raspberry Pi.
Docker starten
We gaan nu Docker opstarten met:
sudo docker run -d -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:linux-arm
Wat deze enorme lange opdracht behelst leg ik hieronder uit.
| sudo docker run – d | = start nieuwe docker container |
| -p 9000:9000 | = welke poort (intern/extern) gebruikt wordt |
| –name =portainer | = geeft de container een naam |
| –restart=always | = altijd herstarten na acties zoals een update |
| -v /var/run/docker.sock:/var/run/docker.sock | = zijn omgevingsvariabelen |
| -v portainer_data:/data | = de locatie van de portainer dataopslag |
| portainer/portainer-ce:linux-arm | = welke portainer je wilt opstarten. Portainer-ce is de (gratis) community editie |
Portainer installeren via de webbrowser
Ga vervolgens naar de webbrowser op je pc of Pi en ga naar het adres:
Of gebruik het IP-adres van de Raspberry Pi waar Docker op draait, vergeet niet het poortnummer.
Time out
Omdat je te lang gewacht hebt kan het zijn dat je dit scherm te zien krijgt.
Restart Portainer in de terminal met:
sudo docker restart portainer
Ververs met [F5] het scherm met de browser.
Als je onderstaand scherm ziet weet je zeker dat je toegang tot de Portainer database gekregen hebt.
Voor het gemak houden we ‘admin’ als gebruikersnaam. Maak een wachtwoord en klik op [Create user].
Het volgende scherm verschijnt.
Klik op Get Started.
Je ziet in het volgende scherm de beschikbare containers en andere informatie over de Pi.
Klik in het veld van Docker…. (het veld wordt lichtblauw als de pointer erin staat).
Je ziet nu het Dashboard.
Klik op het Images veld. Je ziet nu de images lijst.
Je ziet dat er drie images beschikbaar zijn:
- hello-world:lastest
- portainer/portainer-ce:linux-arm
- ubuntu:latest
Selecteer ‘hello-world’ en verwijder het. Dit image is alleen nodig om te zien of Docker goed geïnstalleerd is. Mocht het verwijderen niet lukken omdat het in gebruik is, verwijder dan eerst onnodige containers, zie hieronder.
Ga terug naar het Dashboard.
Klik op Containers. Je krijgt de Container List te zien, zoals ongeveer hieronder. Excuses voor de bijna onleesbare afbeelding.
Het is hierboven wat lastig te lezen. Je ziet mijn lab omgeving 6 containers waarvan er één actief is, de ‘portainer‘. De andere drie zijn de ‘hello-world‘ en ‘Ubuntu‘ die ik eerder geïnstalleerd heb. De ‘portainerpi‘ was een probeersel, die mag verwijderd worden.
Zoals gezegd, selecteer de onnodige containers als je die hebt en verwijder ze met [Remove].
Je zult zien dat als de ‘hello-world‘-container verwijderd is, het nu wel mogelijk is het (ongebruikte) ‘hello-world’-image te verwijderen.
Download nieuwe container
Ga naar de Images List
Vul het zgn. Pull image veld in, bij Image geef je bijvoorbeeld ‘hello-world’ of een ander image in. Als je niets invult en op [Search] klikt, kom je bij https://hub.docker.com/ uit waar tientallen images beschikbaar zijn.
Klik na de gemaakte keus in de docker hub op [Pull the image].
Het image ‘hello-world’ is maar klein en het download snel. In het scherm bij het veld Images zie je nu het ‘hello-world’-image erbij staan met het label Unused.
Container aanmaken
- Ga vanuit de Portainer.io Home pagina naar Containers en klik op [Add container]
- Er verschijnt het Create container scherm
- Geef bij de naam bijv. ‘Test’
- Geef bij Image de naam ‘hello-world’
- Klik vervolgens op [Deploy the container]
In de Container List zie je hello-world:latest er nu bij staan.
- Selecteer de hello-world container en klik op Start
Om te zien of het werkt en gelukt is, kun je de log bekijken. Deze vind je onder Quick Actions als het (kleine) formulier symbool.
De log is een makkelijke manier om te zien dat het werkt of dat er iets mis is.
Er valt weliswaar nog meer in te stellen, maar dit is voor nu voldoende om met portainer te starten.
Ik hoop dat met bovenstaande het een en ander duidelijk geworden is hoe je met portainer de Docker-omgeving kunt beheren. Ik weet in ieder geval zeker dat ik Portainer gebruik voor het beheer van Docker.
Have A Nice Day!
Laat een reactie achter