Installation Portainer Agent – Dynamisch (IoT-Anwendung)

Portainer verwendet den Portainer Agent Container, um mit der Portainer Server-Instanz zu kommunizieren, um Zugriff auf die Ressourcen des Knotens zu ermöglichen. Dieser Teil der Anleitung erläutert, wie Sie den Portainer Agent auf Ihrem u-OS Gerät installieren und wie Sie eine Verbindung zu Ihrer Portainer Server-Instanz aus herstellen können.

Um den Portainer Agent auf Ihrem Gerät zu installieren, müssen Sie zunächst den SSH-Zugriff auf u-OS aktivieren. Hier sind die Schritte, die Sie befolgen müssen:

Öffnen Sie den Webserver von u-OS. Um auf den Webserver zuzugreifen, geben Sie die IP-Adresse Ihres u-OS-Geräts in Ihren Browser ein und melden Sie sich an.

Sobald Sie angemeldet sind, öffnen Sie das u-OS Control Center.

  1. Klicken Sie auf «Identity & Access».
  2. Wählen Sie «SSH Access».
  3. Klicken Sie auf «Enable SSH Access», wie im Schritt 3 visualisiert.

Durch die Aktivierung des SSH-Zugriffs können Sie nun den Portainer Agent installieren.

Um die Installation durchzuführen, müssen Sie sich über SSH mit u-OS verbinden. Öffnen Sie dazu ein Terminal und verwenden Sie den folgenden Befehl:

ssh <user von u-OS>@<IP-Adresse von u-OS>
ssh iotueli@192.168.15.250

Verwenden Sie dabei den Benutzernamen, den Sie bei der Erstellung von u-OS festgelegt haben, und die IP-Adresse von u-OS. Sie werden dann aufgefordert, sich mit Ihren Anmeldedaten bei u-OS anzumelden.

Nach der erfolgreichen Anmeldung werden Sie aufgefordert, das Anmeldepasswort von u-OS einzugeben, das Sie während der Erstellung festgelegt haben.

Portainer Agent dynamisch (IoT Anwendung)

Um diese Anleitung ausführen zu können, müssen Sie zuerst Schritt 3 gemäß der Anleitung durchführen, diese finden Sie weiter unten.

Nachdem Sie Schritt 3 erfolgreich abgeschlossen haben, kehren Sie zu diesem Teil der Anleitung zurück.

Sie haben bereits einen korrigierten Text erhalten. Hier ist er erneut:

Sie sehen, dass auf meinem Portainer-Webinterface der Bereich «Edge Compute» hinzugefügt wurde. Nun werden wir diesen Bereich auch bei Ihnen aktivieren und die weiteren Schritte durchführen, damit sich Ihr Portainer-Agent automatisch in Portainer-Server integriert. Diese Anleitung ist besonders geeignet für IoT-Anwendungen.

Die Aktivierung von Edge Compute ist sehr einfach und kann schnell durchgeführt werden.

  1. Navigieren Sie zum Menüpunkt «Settings«.
  2. Öffnen Sie den Menüpunkt «Edge Compute«
  3. Sie können nun die markierten Schalter-Buttons aktivieren und auf «Save settings» klicken.

Nachdem Sie die Einstellungen in Schritt 1 gespeichert haben, wird die Seitennavigation um «Edge Compute» erweitert.

Bleiben Sie bitte auf diesem Menüpunkt, wir werden hier als Nächstes einen weiteren Schritt durchführen.

Wir sind immer noch im Menüpunkt «Edge Compute». Bitte scrollen Sie nach unten, bis Sie zum Punkt «Automatic Edge Environment Creation» gelangen, und führen Sie dann die folgenden Schritte aus.

  1. Wir sind beim Punkt «Automatic Edge Environment Creation»
  2. Der Edge-ID-Generator gibt Ihnen die Möglichkeit, einen Befehl auf dem Client-Gerät auszuführen, um beispielsweise den Hostnamen als ID zu verwenden. In diesem Fall werden wir den Hostnamen als ID verwenden.
  3. An dieser Stelle müssen Sie das Client-Hostsystem auswählen. In diesem Fall handelt es sich um Linux-Systeme.
  4. Für die Installation auf Ihrem IoT-Gateway oder Ihrer IoT-Steuerung wählen Sie bitte «Docker Standalone».
  5. An dieser Stelle wird Ihnen ein Installationsbefehl für die Installation des Portainer-Agenten generiert.
  6. Klicken Sie bitte auf «Copy», um den Installationsbefehl zu kopieren. Wir benötigen diesen für die Installation auf Ihrem Gerät.

Wir melden uns jetzt über SSH auf unserem IoT-Gateway oder der IoT-Steuerung an

  1. Fügen Sie bitte vor dem Installationsbefehl, den Sie im vorherigen Schritt kopiert haben, das Kommando «sudo» ein. Anschließend fügen Sie den kopierten Installationsbefehl ein.
  2. Jetzt wird der Portainer-Agent auf Ihrem System installiert. Dieser Vorgang kann einige Minuten dauern.

Wenn bei Ihnen nach der Installation alles wie auf dem Bildschirmausschnitt aussieht, war die Installation erfolgreich. Sie können nun wieder zum Webinterface von Portainer zurückkehren und das Terminal, über das Sie sich per SSH angemeldet haben, schließen.

Nachdem Sie wieder im Webinterface von Portainer sind, können Sie die folgenden Schritte durchführen.

  1. Öffnen Sie bitte in der Seitennavigation den Punkt «Waiting Room«
  2. Jetzt wird Ihnen das IoT-Gateway oder die IoT-Steuerung aufgelistet

Wenn Sie nun beispielsweise den Portainer-Agenten auf 10 Geräten installiert haben, werden diese Geräte hier alle aufgelistet.

Jetzt werden wir das Gerät zu Portainer hinzufügen:

  1. Selektieren Sie das Gerät an
  2. Klicken Sie auf «Associate Device»

Wenn Sie jetzt ein Gerät hinzufügen, ändert sich das Bild, wie in der kommenden Abbildung dargestellt.

Das Gerät wird jetzt hinzugefügt.

Um eine Übersicht über alle hinzugefügten Geräte zu erhalten, können Sie die folgenden Schritte durchführen:

  1. Öffnen Sie die Seitennavigation «Home»
  2. Klicken Sie auf das hinzugefügte Gerät

Jetzt haben Sie die Möglichkeit, sämtliche Docker-Container auf dem hinzugefügten Gerät zu verwalten.