Portainer is een lichtgewicht management -UI voor Docker die het proces van het beheren van docker -containers vereenvoudigt. Het biedt een intuïtieve webinterface om containers te implementeren, te configureren en te controleren. Deze gids leidt u door het installeren en opzetten van portainer op een Raspberry Pi, zodat u gemakkelijk Docker -containers kunt beheren.
Wat u nodig hebt
- Raspberry Pi (Elk model met Docker -ondersteuning, bijvoorbeeld PI 3, PI 4)
- Raspberry Pi Os geïnstalleerd op uw Raspberry Pi
- Internetverbinding voor het downloaden van portainer
- Docker geïnstalleerd op uw Raspberry Pi (Portainer vereist dat Docker wordt uitgevoerd)
Stap 1: Installeer Docker op de Raspberry Pi
Als Docker nog niet op uw Raspberry Pi is geïnstalleerd, volg deze stappen om deze te installeren:
-
Werk de pakketlijst bij:
sudo apt update sudo apt upgrade -y
-
Installeer Docker met behulp van het officiële script:
curl -sSL https://get.docker.com | sh
-
Voeg na installatie de huidige gebruiker toe aan de Docker -groep om Docker -opdrachten zonder toe te laten
sudo
:sudo usermod -aG docker ${USER}
-
Start de Raspberry Pi opnieuw op om de wijzigingen toe te passen:
sudo reboot
-
Controleer of Docker correct is geïnstalleerd:
docker --version
Stap 2: Portainer installeren
Nu Docker is geïnstalleerd, kunt u Portainer installeren als een Docker -container.
-
Haal de Portainer -afbeelding van Docker Hub:
docker pull portainer/portainer-ce
-
Maak en voer een portainer -container uit en voer het uit en voer
docker volume create portainer_data docker run -d -p 9000:9000 -p 9443:9443 --name portainer --restart always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
Dit is wat de opdracht doet:
-
-d
: Voer de container uit in een vrijstaande modus. -
-p 9000:9000
: Blootleggen van de web -gebruikersinterface op poort 9000. -
-p 9443:9443
: Blootleggen van de web -gebruikersinterface met HTTPS op poort 9443. -
--name portainer
: Stel de containernaam in als "portainer". -
--restart always
: Start de portainer automatisch opnieuw op op opstarten of als de container crasht. -
-v /var/run/docker.sock:/var/run/docker.sock
: Bind Mount Docker Socket voor het beheren van Docker -containers. -
-v portainer_data:/data
: Monteer een volume om portainergegevens bij te houden.
-
-
Wacht tot Portainer start, open vervolgens uw webbrowser en ga naar:
http://<raspberry_pi_ip>:9000
Vervangen
<raspberry_pi_ip>
met het IP -adres van uw Raspberry Pi.
Stap 3: Portainer instellen
Wanneer u voor het eerst toegang krijgt tot de Web -interface van Portainer, wordt u gevraagd om een beheerdersaccount te maken.
-
Maak een admin -account aan:
- Stel een gebruikersnaam en wachtwoord in voor het beheerdersaccount.
- Klik op "Gebruiker maken" om door te gaan.
-
Maak verbinding met Docker:
- Kiezen Lokaal om de lokale Docker -omgeving op uw Raspberry Pi te beheren.
- Klikken Verbinden.
Stap 4: Portainer gebruiken
Eenmaal verbonden, wordt u naar het Portainer -dashboard gebracht, waar u kunt beginnen met het beheren van uw Docker -containers. U kunt:
- Bekijk lopende containers: Controleer de status van alle actieve containers.
- Nieuwe containers inzetten: Maak nieuwe Docker -containers vanuit de portainer -interface.
- Beheer volumes en netwerken: Bekijk en configureer Docker -volumes en -netwerken.
- Bekijk logboeken en statistieken: Controleer de logboeken en statistieken van het uitvoeren van containers.
Stap 5: Portainer beheren
-
Portainer op afstand bezoeken:
- Om op afstand veilig toegang te krijgen tot portainer, kunt u SSL configureren met behulp van een omgekeerde proxy (bijv. Nginx of traefik) of poort 9443 gebruiken voor https (ingeschakeld door de
docker run
opdracht hierboven).
- Om op afstand veilig toegang te krijgen tot portainer, kunt u SSL configureren met behulp van een omgekeerde proxy (bijv. Nginx of traefik) of poort 9443 gebruiken voor https (ingeschakeld door de
-
Stop en herstart Portainer: Om Portainer te stoppen, voer uit:
docker stop portainer
Om de portainer opnieuw te starten, voer uit:
docker restart portainer
-
Portainer verwijderen: Als u Portainer wilt verwijderen, stop en verwijder de container:
docker stop portainer docker rm portainer
Optioneel kunt u ook het Docker -volume verwijderen:
docker volume rm portainer_data
Problemen oplossen
- Portainer niet toegankelijk: Zorg ervoor dat de firewall van uw Raspberry Pi toegang toestaat tot poorten 9000 en 9443. Als u HTTPS gebruikt, controleert u dat SSL -certificaten correct zijn ingesteld.
-
Docker -container crasht: Controleer de containerlogboeken op fouten:
docker logs portainer
-
Geen Docker Access: Zorg ervoor dat uw gebruiker deel uitmaakt van de Docker -groep:
sudo usermod -aG docker ${USER} sudo reboot
Conclusie
Portainer vereenvoudigt Docker Container Management op de Raspberry PI door een eenvoudig te gebruiken webinterface te bieden. Met slechts een paar opdrachten kunt u aan de slag met Docker en Portainer, waardoor het gemakkelijker wordt om uw containers te beheren en te controleren. Of u nu thuisautomatiseringssystemen, webservers of andere Dockerized -services uitvoert, Portainer is een onschatbare hulpmiddelen voor het beheren van de Docker -omgeving van uw Raspberry Pi.