Schritt-für-Schritt-Anleitung zur Installation von Portainer Agent auf einem PLCnext-Steuergerät

Portainer ist eine beliebte OCI-Container-Management-Plattform.

Bei Geräten mit begrenzten Ressourcen ermöglicht die Installation des Portainer-Agenten auf dem Gerät die Verwaltung über einen Portainer-Server.

In der Portainer-Dokumentation wird beschrieben, wie Sie Portainer Agent auf Podman installieren. In diesem Artikel wird dieses Beispiel erweitert, indem beschrieben wird, wie Portainer Agent mithilfe von Podman Quadlets auf einem PLCnext Control-Gerät installiert wird.

Durch die Verwendung von Podman-Quadlets können Container und Volumes als systemd-Dienste verwaltet werden.

Hinweise und Haftungsausschluss:

• Für dieses Verfahren ist ein PLCnext-Steuerungsgerät mit der Firmware-Version 2025.0 oder höher erforderlich.
• Das PLCnext-Steuerungsgerät muss mit dem Internet verbunden sein, um das Portainer Agent OCI-Image herunterzuladen.
• Zum Zeitpunkt des Verfassens dieses Artikels unterstützt Portainer nur Podman unter dem Betriebssystem CentOS 9, das keine PLCnext-Steuerungsgeräte enthält.
• Phoenix Contact empfiehlt generell, dass Podman auf PLCnext Control-Geräten nur von PLCnext Store-Apps verwendet wird. Die Nutzung von Podman für andere Zwecke wird von Phoenix Contact derzeit nicht unterstützt.
• Geräte, auf denen Portainer Agent ausgeführt wird, können über eine Vollversion von Portainer – entweder die Business Edition oder die Community Edition – verwaltet werden, die auf einem separaten Gerät installiert ist. Die Verwaltung von Portainer Agent-Geräten wird in der Portainer-Dokumentation behandelt und in diesem Artikel nicht beschrieben.

Vorgehensweise

1. Erstellen Sie auf dem PLCnext Control-Gerät die Datei /etc/containers/systemd/portainer.volume mit folgendem Inhalt:

   [Unit]
   Description=Portainer Agent Container Volume
   [Volume]
   VolumeName=portainer
   

2. Erstellen Sie die Datei /etc/containers/systemd/portainer_agent.container mit folgendem Inhalt:

   [Unit]
   Description=Portainer Agent Container
   Requires=portainer-volume.service
   [Container]
   ContainerName=portainer_agent
   Image=docker.io/portainer/agent:2.23.0
   Volume=/run/podman/podman.sock:/var/run/docker.sock
   Volume=/var/lib/containers/storage/volumes:/var/lib/docker/volumes
   Volume=/:/host
   PublishPort=9001:9001
   [Install]
   WantedBy=multi-user.target default.target
   

3. Führen Sie die folgenden Befehle vom Root-Benutzerkonto aus:

   systemctl daemon-reload
   systemctl start portainer_agent.service
   

   Der Start des Dienstes dauert beim ersten Mal eine Weile, da das vollständige Portainer Agent-Image von docker.io geladen wird.

4. Überprüfen Sie mit dem folgenden Befehl, ob der Dienst erfolgreich gestartet wurde:

   systemctl status portainer_agent.service
   

Während der Container ausgeführt wird, können Sie von einem Portainer-Server aus eine Verbindung zum Portainer-Agenten auf dem PLCnext-Steuerungsgerät herstellen, wie in der Portainer-Dokumentation beschrieben.

Durch die Implementierung des Containers auf diese Weise wird Portainer Agent bei jedem Neustart des PLCnext-Steuerungsgeräts automatisch neu gestartet.

Referenzen

1. Portainer-Dokumentation:„Installieren Sie Portainer Agent auf Podman“

2. Daniel Schier:„Podman – Quadlets“

3. Technische Referenz zu Podman Quadlets.

Hinweis:

Der Makers Blog zeigt Anwendungen und User Stories von Community-Mitgliedern, die nicht von Phoenix Contact getestet oder überprüft wurden. Die Nutzung erfolgt auf eigene Gefahr.