Guía paso a paso para instalar el agente Portainer en un dispositivo de control PLCnext

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

Para dispositivos con recursos limitados, la instalación de Portainer Agent en el dispositivo permite administrarlo desde un servidor Portainer.

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

Al utilizar Podman Quadlets, los contenedores y volúmenes se pueden administrar como servicios systemd.

Notas y descargos de responsabilidad:

• Este procedimiento requiere un dispositivo de control PLCnext con versión de firmware 2025.0 o posterior.
• El dispositivo PLCnext Control debe estar conectado a Internet para poder descargar la imagen OCI del Agente Portainer.
• En el momento de escribir este artículo, Portainer solo admite la ejecución de Podman en el sistema operativo CentOS 9, que no incluye los dispositivos PLCnext Control.
• Phoenix Contact generalmente recomienda que Podman en los dispositivos PLCnext Control solo sea utilizado por las aplicaciones PLCnext Store. Phoenix Contact no admite actualmente el uso de Podman para otros fines.
• Los dispositivos que ejecutan Portainer Agent se pueden administrar desde una versión completa de Portainer, ya sea Business Edition o Community Edition, instalada en un dispositivo independiente. La administración de dispositivos Portainer Agent se trata en la documentación de Portainer y no se describe en este artículo.

Procedimiento

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

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

2. Crea 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 lleva un tiempo la primera vez, porque la imagen completa del Agente Portainer se carga desde docker.io.

4. Compruebe que el servicio se haya iniciado correctamente, utilizando el siguiente comando:

   systemctl status portainer_agent.service
   

Mientras el contenedor se está ejecutando, puede conectarse al Agente Portainer 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 se reinicie el dispositivo PLCnext Control.

Referencias

1. Documentación de Portainer:"Instalar el agente Portainer en Podman"

2. Daniel Schier:"Podman - Cuatlets"

3. Referencia técnica de Podman Quadlets.

Nota:

El Makers Blog muestra aplicaciones e historias de usuarios de miembros de la comunidad que Phoenix Contact no prueba ni revisa. Úselos bajo su propio riesgo.