Portainer Agent mit dem Portainer-Server verbinden
Schritt-fuer-Schritt-Anleitung, wie du einen Docker-Host ueber den Portainer Agent (Port 9001) als Environment im Portainer-Server einbindest und seine Container zentral verwaltest.
Wenn du Docker-Container auf mehreren Geraeten betreibst, willst du sie meist nicht einzeln, sondern zentral verwalten. Genau dafuer gibt es den Portainer Agent: Er laeuft als Container auf einem entfernten Docker-Host und macht diesen ueber einen einzigen Port fuer den Portainer-Server erreichbar. In dieser Anleitung verbindest du einen solchen Host als Environment mit deinem Portainer-Server und kannst danach alle seine Container von einer Oberflaeche aus steuern.
Voraussetzung: Auf dem entfernten Docker-Host laeuft bereits der Portainer-Agent-Container und lauscht auf Port 9001. Der Portainer-Server muss diesen Host ueber das Netzwerk erreichen koennen.
Agent als neues Environment hinzufuegen
Schritt 1. Oeffne den Portainer-Server im Browser und melde dich mit deinen Zugangsdaten an. Klicke anschliessend in der linken Seitenleiste auf «Environments» und oben rechts auf «Add Environment».
Schritt 2. Waehle die Variante «Docker Standalone» aus und klicke auf «Start Wizard», um den Einrichtungsassistenten zu starten.
Schritt 3. Waehle als Verbindungsart «Agent» und vergib einen Namen fuer das Geraet. Trage danach die IP-Adresse des Docker-Hosts sowie den Port 9001 ein und klicke auf «Connect». Der Agent sollte sich nun erfolgreich mit dem Portainer-Server verbinden.
Nach erfolgreicher Verbindung erscheint das Geraet unter der Rubrik «New Environments». Wird es dort aufgelistet, ist die Einrichtung abgeschlossen und du kannst die Container des Hosts ab sofort ueber den Portainer-Server verwalten.
Verbundene Environments aufrufen und Container verwalten
Schritt 4. Klicke auf den Home-Button, um zur Portainer-Startseite zurueckzukehren. Dort werden alle Environments aufgelistet, die mit dem Portainer-Server verbunden sind.
Schritt 5. Waehle ein Environment aus, indem du auf den entsprechenden Namen klickst. Du gelangst zur Uebersichtsseite, auf der alle Docker-Container und Services des jeweiligen Geraets aufgelistet sind.
Von hier aus verwaltest du die Container des Hosts direkt: neue Container erstellen, vorhandene starten, stoppen oder entfernen sowie die Container-Logs einsehen.
Fazit
Mit dem Portainer Agent bindest du beliebige Docker-Hosts ueber einen einzigen Port (9001) als Environment in deinen Portainer-Server ein. So verwaltest du Container verteilter Geraete bequem an einer zentralen Stelle, statt dich auf jedem Host einzeln anzumelden.