Portainer Agent installieren und mit dem Portainer Server verbinden
Schritt-fuer-Schritt-Anleitung, um den Portainer Agent als Docker-Container auf einem Linux-Host zu installieren und die Verbindung zur Portainer-Server-Instanz vorzubereiten.
Portainer verwaltet entfernte Docker-Hosts ueber den Portainer Agent. Der Agent laeuft als Container auf dem Zielknoten und stellt der zentralen Portainer-Server-Instanz Zugriff auf die Ressourcen dieses Knotens bereit. Diese Anleitung zeigt, wie Sie den Agent auf einem beliebigen Linux-Host mit installiertem Docker als Container betreiben und die Installation pruefen.
Voraussetzungen
Auf dem Zielknoten muss eine funktionierende Docker-Installation vorhanden sein. Ausserdem benoetigen Sie Terminal-Zugriff auf den Host (lokal oder per SSH) sowie die Berechtigung, Docker-Befehle auszufuehren. Eine laufende Portainer-Server-Instanz, in der Sie die Umgebung spaeter einbinden, sollte bereits existieren.
Schritt 1. Mit dem Zielknoten verbinden. Oeffnen Sie ein Terminal auf dem Host. Greifen Sie aus der Ferne zu, stellen Sie eine SSH-Verbindung mit dem Benutzernamen und der IP-Adresse des Knotens her.
1ssh <benutzer>@<ip-adresse>
Bestaetigen Sie die Verbindung und melden Sie sich mit Ihren Zugangsdaten an. Ein konkretes Beispiel mit Benutzername und IP-Adresse sieht so aus:
1ssh iotueli@192.168.15.250
Schritt 2. Portainer Agent als Container starten. Kopieren Sie den folgenden Befehl in das Terminal und bestaetigen Sie mit der Eingabetaste. Der Agent wird im Hintergrund gestartet und nach einem Neustart automatisch wieder hochgefahren.
1sudo docker run -d -p 9001:9001 --name portainer_agent --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/docker/volumes:/var/lib/docker/volumes portainer/agent:latest
Der Befehl veroeffentlicht Port 9001, ueber den der Portainer Server spaeter mit dem Agent kommuniziert. Die beiden Volume-Bindings geben dem Agent Zugriff auf den Docker-Socket und die Docker-Volumes des Hosts. Sobald der Befehl ausgefuehrt ist, laeuft der Portainer Agent auf dem System.
Stellen Sie sicher, dass Port 9001 in einer eventuell vorhandenen Firewall fuer die Portainer-Server-Instanz erreichbar ist, damit die Verbindung zustande kommt.
Installation pruefen
Listen Sie alle Container auf dem Host auf, um zu kontrollieren, ob der Agent gestartet wurde:
1sudo docker ps -a
In der Ausgabe sollte der Container portainer_agent auf Basis des Images portainer/agent erscheinen und den Status running aufweisen. Ist der Eintrag vorhanden, wurde der Portainer Agent erfolgreich installiert und laeuft auf dem System.
Fazit
Der Portainer Agent ist mit einem einzigen Docker-Befehl installiert. Anschliessend binden Sie den Knoten in Ihrer Portainer-Server-Instanz als neue Umgebung ein, indem Sie dort die IP-Adresse des Hosts zusammen mit Port 9001 angeben.