merge: testing → main (reconcile 2-week divergence)

deploy/decnet-agent.service.j2

@@ -0,0 +1,44 @@
+[Unit]
+Description=DECNET Worker Agent (mTLS)
+Documentation=https://git.resacachile.cl/anti/DECNET/wiki/SWARM-Mode
+After=network-online.target docker.service
+Wants=network-online.target
+Requires=docker.service
+
+[Service]
+Type=simple
+User={{ user }}
+Group={{ group }}
+# docker.sock is group-readable by 'docker'; the agent needs it for compose.
+SupplementaryGroups=docker
+WorkingDirectory={{ install_dir }}
+EnvironmentFile=-{{ install_dir }}/.env.local
+Environment=DECNET_SYSTEM_LOGS=/var/log/decnet/decnet.agent.log
+ExecStart={{ venv_dir }}/bin/decnet agent --host 0.0.0.0 --port 8765 --agent-dir /etc/decnet/agent
+StandardOutput=append:/var/log/decnet/decnet.agent.log
+StandardError=append:/var/log/decnet/decnet.agent.log
+
+# MACVLAN/IPVLAN management + scapy raw sockets. Granted via ambient caps so
+# the process starts unprivileged and keeps only these two bits.
+CapabilityBoundingSet=CAP_NET_ADMIN CAP_NET_RAW
+AmbientCapabilities=CAP_NET_ADMIN CAP_NET_RAW
+
+# Security Hardening
+NoNewPrivileges=yes
+ProtectSystem=full
+ProtectHome=read-only
+PrivateTmp=yes
+ProtectKernelTunables=yes
+ProtectKernelModules=yes
+ProtectControlGroups=yes
+RestrictSUIDSGID=yes
+LockPersonality=yes
+# {{ install_dir }} holds release slots + state; the agent reads them and writes its PID.
+ReadWritePaths={{ install_dir }} /var/log/decnet
+
+Restart=on-failure
+RestartSec=5
+TimeoutStopSec=15
+
+[Install]
+WantedBy=multi-user.target