Claude-Docs-Manager
d34189c625
DD-0523 — !7 (31586c30, 0.1.5) moved install.sh and config.example.yaml to the
443 intercept after env-qa-02 hit "service not available". The ansible role
default (monky_deployd_tenancy_port) and TenancyCfg.port still said 8081, so
an ansible-installed box or a config that omits `port` still dialled the wrong
port; both now default to 443, the proxy-mapping and config tests follow, and
PROTOCOL.md §Where and how states the intercept port separately from the
in-pod 8081 and names openziti state/overlay/configs.json as the authority.
DD-0525 — PROTOCOL.md and README said "the broker adds the attr when the
identity is created at kit reveal". monky-ziti at b44c50a4 has no such code
(app/fabric.py host_identity_attrs carries the env template only) and openziti
docs/services.md says "Nothing carries the attr yet". Both now state the
dependency: an operator adds #monky-deploy-agent/#openbao-client on the
controller until the ADR-0028 addendum lands in monky-ziti.
DD-0527 — "the old kit's grant fails at login (unknown/used jti)". The
jwt-tenancy mount keeps no replay state (openbao terraform/jwt-tenancy.tf
see_env role: signature, aud, bound_claims, exp); a superseded grant logs in
until exp and the refusal is tenancy's 401 on the first bearer call. The
second-reveal paragraph, the grant-flow diagram and README §Security model say
so; FakeBao no longer pops a grant at login (the suite's superseded-token test
already goes through FakeTenancy.superseded_jtis, which is the real model).
DD-0528 — "Both locations keep being published": release:gitea has been a
never-run manual job on every tag pipeline (6999, 7044, 7066); README and
OPERATIONS.md now say when the Gitea mirror is published and that it has not
been yet.
Gates (local, py3.12): ruff format, ruff check, pytest 50 passed,
bash -n packaging/install.sh. `git grep 8081` afterwards hits only the in-pod
listener statements.
Doc-Drift: DD-0523 fixed
Doc-Drift: DD-0525 fixed
Doc-Drift: DD-0527 fixed
Doc-Drift: DD-0528 fixed
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AW3QqEpwLV69KHn24Re45Q
role monky_deployd
Installs and configures monky-deployd
(the Monky backend pull agent, MONKY-ADR-0028) on a docker host that already carries an enrolled
host identity (roles/ziti_tunneler, run-host mode). Skeleton for osg1-07; copy it there.
What it does: pin + download the .deb from the scm.tikali.ai package registry (sha256 verified; the
project is private, so the fetches send the read-only deploy token monky_deployd_download_token
as DEPLOY-TOKEN, no_log; monky_deployd_base_url/_deb_url switch to the Gitea release off-estate) → ACL
u:monky-deployd:r on the identity (rx on the dir) → /etc/monky-deployd/config.yaml from the
template → optional openbao-ca PEM → optional monky-deployd-proxy.service (transport: proxy)
→ the one-time bootstrap deploy grant from a vault var (0600, no_log) → monky-deployd.timer
→ first tick via handler (inside the grant's hour) → monky-deployd status.
Variables (see defaults/main.yml)
| var | note |
|---|---|
monky_deployd_version |
pinned release, e.g. 0.1.5 |
monky_deployd_download_token |
vaulted: GitLab deploy token, scope read_package_registry only (revocable) — the registry is private; seeded in OpenBao at monky/monky-tenancy/deployd-download key token (path/key are the operator's choice). Empty = no header (only works with the Gitea base_url) |
monky_deployd_env_id / _site / _transport |
per host (env-dev-06, cbs, sdk) |
monky_deployd_bootstrap_grant |
tenancy-minted deploy grant (1 h) — ansible-vault or a lookup at play time; empty keeps the existing token |
monky_deployd_bao_ca_pem |
the openbao-ca certificate (PEM) |
monky_deployd_volumes_on_absent |
keep (default) or purge (never applied on prod by the agent) |
Example play
- hosts: env-dev-06:env-dev-07:env-dev-08:env-dev-09
become: true
roles:
- role: ziti_tunneler # enrol/verify monky-host.<env>; gains the ACL var + name assertion
- role: monky_deployd
vars:
monky_deployd_bootstrap_grant: "{{ lookup('pipe', 'tenancy-mint-grant ' ~ inventory_hostname) }}"
monky_deployd_download_token: "{{ vault_monky_deployd_download_token }}" # ansible-vault / OpenBao lookup
Rollout order (plan §E): pilot env-qa-02 → env-dev-06..09 → env-dev-01 last (after its live key moves into Bao). Verified on Ubuntu 26.04.