From a1590f85edcc680849c5fce47f2365dff2dce744 Mon Sep 17 00:00:00 2001 From: oskar Date: Tue, 4 Aug 2026 15:07:22 +0200 Subject: [PATCH] feat(kb): SPLIT stability-agent-rollout -> runbook + subsystem MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit kb/runbooks/stability-agent-rollout.md — Deployment, Verification, Troubleshooting kb/subsystems/stability-agent-architektura.md — Architecture Summary + "Why UI only showed CHELSTY" Tresc sekcji nietknieta. Co-Authored-By: Claude Opus 5 (1M context) --- .../runbooks}/stability-agent-rollout.md | 21 ++++++++--------- kb/subsystems/stability-agent-architektura.md | 23 +++++++++++++++++++ 2 files changed, 33 insertions(+), 11 deletions(-) rename {docs => kb/runbooks}/stability-agent-rollout.md (70%) create mode 100644 kb/subsystems/stability-agent-architektura.md diff --git a/docs/stability-agent-rollout.md b/kb/runbooks/stability-agent-rollout.md similarity index 70% rename from docs/stability-agent-rollout.md rename to kb/runbooks/stability-agent-rollout.md index 6a0093e..a72dd77 100644 --- a/docs/stability-agent-rollout.md +++ b/kb/runbooks/stability-agent-rollout.md @@ -1,16 +1,15 @@ +--- +okf: "0.1" +type: runbook +visibility: private +status: active +updated: 2026-05-17 +links: + - ../subsystems/stability-agent-architektura.md +--- + # Stability Agent Multi-Node Rollout -## Architecture Summary -The `stability-agent` is a lightweight Python service that monitors node health (disk, Docker containers, Tailscale, MQTT) and publishes state to a central Redis instance running on **PIHA**. - -- **Source**: `services/stability-agent` -- **State Path**: `/opt/homelab/state` -- **Events Path**: `/opt/homelab/events` -- **Redis Target**: `100.108.208.3:6379` (PIHA) - -## Why UI only showed CHELSTY -Previously, the `stability-agent` had `NODE_NAME` defaulted to `chelsty` and was only deployed there. The Agent System UI materializer on PIHA filters nodes based on the Redis keys `homelab:nodes:`. Without other agents publishing their specific `NODE_NAME`, the UI remained limited to the single active node. - ## Deployment Use the helper script to deploy or generate commands. The script uses explicit Tailscale IPs for remote targets (piha, chelsty, vps) and runs locally for solaria. diff --git a/kb/subsystems/stability-agent-architektura.md b/kb/subsystems/stability-agent-architektura.md new file mode 100644 index 0000000..02f8160 --- /dev/null +++ b/kb/subsystems/stability-agent-architektura.md @@ -0,0 +1,23 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: active +updated: 2026-05-17 +links: + - ../runbooks/stability-agent-rollout.md +--- + +# stability-agent — architektura rolloutu na flote + +## Architecture Summary +The `stability-agent` is a lightweight Python service that monitors node health (disk, Docker containers, Tailscale, MQTT) and publishes state to a central Redis instance running on **PIHA**. + +- **Source**: `services/stability-agent` +- **State Path**: `/opt/homelab/state` +- **Events Path**: `/opt/homelab/events` +- **Redis Target**: `100.108.208.3:6379` (PIHA) + +## Why UI only showed CHELSTY +Previously, the `stability-agent` had `NODE_NAME` defaulted to `chelsty` and was only deployed there. The Agent System UI materializer on PIHA filters nodes based on the Redis keys `homelab:nodes:`. Without other agents publishing their specific `NODE_NAME`, the UI remained limited to the single active node. +