oskar a1590f85ed feat(kb): SPLIT stability-agent-rollout -> runbook + subsystem

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) <noreply@anthropic.com>

2026-08-04 16:58:46 +02:00

1.9 KiB

Raw Blame History

okf

type

visibility

status

updated

links

0.1

runbook

private

active

2026-05-17

../subsystems/stability-agent-architektura.md

Stability Agent Multi-Node Rollout

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.

# Print commands
./scripts/deploy/deploy-stability-agent.sh <node-name>

# Deploy via SSH (executes ssh oskar@<ip>)
./scripts/deploy/deploy-stability-agent.sh <node-name> --ssh

Manual Steps per Node

The manual steps are encapsulated in services/stability-agent/deploy-local.sh. On the target node:

cd /home/oskar/homelab-codex-ws
git fetch origin
git checkout master
git pull origin master
cd services/stability-agent
./deploy-local.sh <node-name>

Verification

Fleet Overview

Run the verification script from any node with redis-cli access:

./scripts/deploy/verify-agent-fleet.sh

Redis Inspection (on PIHA)

docker exec agent-system-redis redis-cli KEYS 'homelab:nodes:*'
docker exec agent-system-redis redis-cli HGETALL homelab:nodes:<node-name>

Verify Web UI backend:

curl -s http://127.0.0.1:18180/nodes
curl -k https://agents.okit.pl/nodes

Troubleshooting

Redis empty after compose down: The agent-system-redis on PIHA uses transient storage if not configured with a volume. If it restarts, agents must republish their state (they do this automatically every CHECK_INTERVAL).
Secrets: .env files and local secrets are not committed to the repo. Ensure MQTT_HOST and other specific secrets are set via overrides if needed.
Telegram: Telegram bot notifications can remain disabled if TELEGRAM_BOT_TOKEN is absent.
Docker Socket: If the agent reports unavailable for Docker, ensure /var/run/docker.sock is mounted and the user has permissions.

1.9 KiB Raw Blame History