Guía Paso a Paso: Instalación del Agente Portainer en Dispositivo PLCnext Control

Portainer es una popular plataforma de gestión de contenedores OCI.

Para dispositivos con recursos limitados, instalar Portainer Agent en el dispositivo permite gestionarlo desde un servidor Portainer.

La documentación de Portainer describe cómo instalar Portainer Agent en Podman. Este artículo extiende ese ejemplo describiendo cómo instalar Portainer Agent en un dispositivo PLCnext Control usando Podman Quadlets.

Al usar Podman Quadlets, los contenedores y volúmenes pueden gestionarse como servicios systemd.

Notas y advertencias:

• Este procedimiento requiere un dispositivo PLCnext Control con versión de firmware 2025.0 o posterior.
• El dispositivo PLCnext Control debe estar conectado a internet para descargar la imagen OCI de Portainer Agent.
• Al momento de escribir esto, Portainer solo soporta Podman corriendo en el sistema operativo CentOS 9, que no incluye dispositivos PLCnext Control.
• Phoenix Contact generalmente recomienda que Podman en dispositivos PLCnext Control solo se use por apps de PLCnext Store. El uso de Podman para cualquier otro propósito actualmente no es soportado por Phoenix Contact.
• Dispositivos corriendo Portainer Agent pueden ser gestionados desde una versión completa de Portainer - ya sea Business Edition o Community Edition - instalada en un dispositivo separado. La gestión de dispositivos Portainer Agent está cubierta en la documentación de Portainer, y no se describe en este artículo.

Procedimiento

1. En el dispositivo PLCnext Control, cree el archivo /etc/containers/systemd/portainer.volume con el siguiente contenido:

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

2. Cree el archivo /etc/containers/systemd/portainer_agent.container con el siguiente contenido:

   [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. Ejecute los siguientes comandos desde la cuenta de usuario root:

   systemctl daemon-reload
   systemctl start portainer_agent.service
   

   Iniciar el servicio toma un tiempo la primera vez, porque la imagen completa de Portainer Agent se carga desde docker.io.

4. Verifique que el servicio haya iniciado correctamente, usando el siguiente comando:

   systemctl status portainer_agent.service
   

Mientras el contenedor está corriendo, puede conectarse al Portainer Agent en el dispositivo PLCnext Control desde un Servidor Portainer, como se describe en la documentación de Portainer.

Al implementar el contenedor de esta manera, Portainer Agent se reiniciará automáticamente cada vez que el dispositivo PLCnext Control se reinicie.

Referencias

1. Documentación de Portainer: "Install Portainer Agent on Podman"

2. Daniel Schier: "Podman - Quadlets"

3. Referencia técnica de Podman Quadlets.

Nota:

El Makers Blog muestra aplicaciones e historias de usuarios de miembros de la comunidad que no son probadas ni revisadas por Phoenix Contact. Úselas bajo su propio riesgo.