mirror of
https://scm.tikali.ai/tikali/applications/monky/monky-deployd.git
synced 2026-09-18 05:36:15 +00:00
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:
@@ -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
|
||||
Reference in New Issue
Block a user