在 PLCnext Control 设备上安装 Portainer Agent 分步指南

Portainer 是流行的 OCI 容器管理平台。

对资源受限设备，在设备安装 Portainer Agent 可使其由 Portainer 服务器管理。

Portainer 文档描述如何在 Podman 上安装 Portainer Agent。本文扩展该示例，描述如何用 Podman Quadlets 在 PLCnext Control 设备上安装 Portainer Agent。

使用 Podman Quadlets 可将容器和卷作为 systemd 服务管理。

注意和免责声明：

• 此过程需固件 2025.0 或更高版本的 PLCnext Control 设备。
• PLCnext Control 设备必须联网以下载 Portainer Agent OCI 镜像。
• 撰写时 Portainer 仅支持运行在 CentOS 9 上的 Podman，不含 PLCnext Control 设备。
• Phoenix Contact 通常建议 PLCnext Control 设备上 Podman 仅用于 PLCnext Store 应用。其他用途当前不受 Phoenix Contact 支持。
• 运行 Portainer Agent 的设备可从安装在独立设备上的完整版 Portainer（商业版或社区版）管理。Portainer Agent 设备管理见 Portainer 文档，本文不述。

步骤

1. 在 PLCnext Control 设备创建文件 /etc/containers/systemd/portainer.volume，内容如下：

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

2. 创建文件 /etc/containers/systemd/portainer_agent.container，内容如下：

   [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. 从 root 用户账户执行：

   systemctl daemon-reload systemctl start portainer_agent.service 

   首次启动服务需较长时间，因从 docker.io 加载完整 Portainer Agent 镜像。

4. 用以下命令检查服务是否成功启动：

   systemctl status portainer_agent.service 

容器运行时，可按 Portainer 文档从 Portainer 服务器连接到 PLCnext Control 设备上的 Portainer Agent。

此实现方式下，Portainer Agent 将在 PLCnext Control 设备每次重启时自动重启。

参考

1. Portainer 文档："Install Portainer Agent on Podman"

2. Daniel Schier："Podman - Quadlets"

3. Podman Quadlets 技术参考。

注意：

Makers Blog 展示社区成员应用和用户故事，未经 Phoenix Contact 测试或审核。使用风险自负。