feat: monky-deployd v0.1.0 — pull agent over the mesh (ADR-0028)

Stdlib-only Python 3.12 agent for docker VMs and laptops: flock → checkin
(bearer = the agent's OpenBao token, bootstrapped from the install kit's
jwt-tenancy deploy grant) → action apply|none|down → bundle (sha256
verified) → refusal checks (unresolved ${VAR} names only, manifest paths
pinned to monky/data/<env>/see/, privileged/host-network, rollback, disk
need×1.5+headroom) → lease → POST /v1/auth/jwt-tenancy/login → KV reads →
.env 0600 → promote → compose pull/up → wait healthy → report; finally
renew-self / re-lease before max TTL, scrub. Exit 0/75/78/1. Redactor log
filter. Transports sdk (openziti) / proxy (ziti tunnel proxy 18443/18200) /
system. Laptop mode.

Packaging: hardened oneshot + 60 s timer + proxy unit, nfpm .deb with
/opt/monky-deployd/venv, install.sh for Ubuntu 26.04 (Gitea release
download, enrol, ACLs, bootstrap from stdin), ansible role skeleton for
osg1-07. CI: lint/test on every change; wheel (openziti on ubuntu:26.04) and
package (nfpm) allow_failure until runner egress is proven; GitLab release +
release:gitea on v* tags. Docs: README, PROTOCOL, OPERATIONS, CHANGELOG,
CLAUDE/AGENTS.

Divergence noted: monky-tenancy main (MR !15) still ships the AppRole lease
and kit; this agent implements the plan's Gate 1 RESULT (login_jwt, no
unwrap) and refuses an AppRole lease loudly (LEASE_SHAPE).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KLB7jieMNRkTsJ2epr4Ds1
This commit is contained in:
2026-09-05 08:01:36 +00:00
parent c72d6c0227
commit 1c42e913a8
48 changed files with 4932 additions and 64 deletions
+55
View File
@@ -0,0 +1,55 @@
# monky-deployd — one reconcile tick (MONKY-ADR-0028 §D). Fired by monky-deployd.timer.
[Unit]
Description=Monky backend pull agent (one tick: checkin -> bundle -> lease -> OpenBao -> compose -> report)
Documentation=https://scm.tikali.ai/tikali/applications/monky/monky-deployd
After=network-online.target docker.service ziti-edge-tunnel.service
Wants=network-online.target
# The proxy transport needs the local ziti proxy; harmless when the unit is disabled.
After=monky-deployd-proxy.service
ConditionPathExists=/etc/monky-deployd/config.yaml
[Service]
Type=oneshot
User=monky-deployd
Group=monky-deployd
SupplementaryGroups=docker
ExecStart=/usr/bin/monky-deployd run --once
# 75 = temporary network failure (next tick retries), 78 = AGENT_ENV_MISMATCH (operator action)
SuccessExitStatus=75
TimeoutStartSec=20min
Nice=5
Environment=PYTHONUNBUFFERED=1
Environment=MONKY_DEPLOYD_CONFIG=/etc/monky-deployd/config.yaml
UMask=0077
# hardening
NoNewPrivileges=yes
ProtectSystem=strict
ProtectHome=yes
PrivateTmp=yes
ProtectKernelTunables=yes
ProtectKernelModules=yes
ProtectControlGroups=yes
ProtectClock=yes
ProtectHostname=yes
RestrictSUIDSGID=yes
RestrictRealtime=yes
LockPersonality=yes
# (no MemoryDenyWriteExecute: the openziti SDK's ctypes callbacks need libffi trampolines)
RestrictNamespaces=yes
SystemCallArchitectures=native
SystemCallFilter=@system-service
SystemCallFilter=~@privileged @resources
RestrictAddressFamilies=AF_UNIX AF_INET AF_INET6
CapabilityBoundingSet=
AmbientCapabilities=
StateDirectory=monky-deployd
StateDirectoryMode=0700
ReadWritePaths=/var/lib/monky-deployd
# the bootstrap grant is deleted after the first login (the only write under /etc)
ReadWritePaths=/etc/monky-deployd
ReadOnlyPaths=-/opt/openziti/etc/identities
# docker socket + compose need the socket path writable
ReadWritePaths=-/var/run/docker.sock -/run/docker.sock
[Install]
WantedBy=multi-user.target