Guide étape par étape pour l'installation de l'agent Portainer sur un dispositif de contrôle PLCnext

Portainer est une plateforme de gestion de conteneurs OCI populaire.

Pour les appareils à ressources limitées, l'installation de l'agent Portainer sur l'appareil permet de le gérer à partir d'un serveur Portainer.

La documentation Portainer décrit comment installer l'agent Portainer sur Podman. Cet article étend cet exemple en décrivant comment installer Portainer Agent sur un périphérique PLCnext Control à l'aide de Podman Quadlets.

En utilisant Podman Quadlets, les conteneurs et les volumes peuvent être gérés en tant que services systemd.

Remarques et avertissements :

• Cette procédure nécessite un appareil PLCnext Control doté de la version 2025.0 ou ultérieure du micrologiciel.
• L'appareil PLCnext Control doit être connecté à Internet pour pouvoir télécharger l'image OCI de l'agent Portainer.
• Au moment de la rédaction, Portainer prend uniquement en charge Podman exécuté sur le système d'exploitation CentOS 9, qui n'inclut pas les appareils PLCnext Control.
• Phoenix Contact recommande généralement que Podman sur les appareils PLCnext Control soit utilisé uniquement par les applications PLCnext Store. L'utilisation de Podman à d'autres fins n'est actuellement pas prise en charge par Phoenix Contact.
• Les appareils exécutant Portainer Agent peuvent être gérés à partir d'une version complète de Portainer (Business Edition ou Community Edition) installée sur un appareil distinct. La gestion des appareils Portainer Agent est couverte dans la documentation de Portainer et n'est pas décrite dans cet article.

Procédure

1. Sur l'appareil PLCnext Control, créez le fichier /etc/containers/systemd/portainer.volume avec le contenu suivant :

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

2. Créez le fichier /etc/containers/systemd/portainer_agent.container avec le contenu suivant :

   [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. Exécutez les commandes suivantes à partir du compte utilisateur root :

   systemctl daemon-reload
   systemctl start portainer_agent.service
   

   Le démarrage du service prend un certain temps la première fois, car l'image complète de l'agent Portainer est chargée depuis docker.io.

4. Vérifiez que le service a démarré avec succès à l'aide de la commande suivante :

   systemctl status portainer_agent.service
   

Pendant que le conteneur est en cours d'exécution, vous pouvez vous connecter à l'agent Portainer sur le périphérique PLCnext Control à partir d'un serveur Portainer, comme décrit dans la documentation Portainer.

En implémentant le conteneur de cette manière, Portainer Agent redémarrera automatiquement à chaque redémarrage du dispositif PLCnext Control.

Références

1. Documentation Portainer :"Installer l'agent Portainer sur Podman"

2. Daniel Schier :"Podman - Quadlets"

3. Référence technique des Quadlets Podman.

Remarque :

Le Makers Blog présente des applications et des témoignages d'utilisateurs de membres de la communauté qui ne sont ni testés ni examinés par Phoenix Contact. Utilisez-les à vos propres risques.