homelab-codex-ws/kb/runbooks/planner-agent-deploy.md

okf	type	visibility	status	updated	links
0.1	runbook	private	active	2026-05-27	../services/planner-agent.md

planner-agent — deploy, uruchamianie, testy

Deployment na SOLARIA

# 1. Przygotuj .env na solaria
ssh oskar@100.100.231.104
mkdir -p /opt/homelab/config/planner-agent
cat > /opt/homelab/config/planner-agent/.env << 'EOF'
OLLAMA_HOST=http://host-gateway:11434
OLLAMA_MODEL=qwen2.5-coder:14b
REDIS_URL=redis://100.108.208.3:6379
NODE_NAME=solaria
COOLDOWN_SECONDS=300
RUNTIME_PATH=/opt/homelab
EOF

# 2. Deploy przez standardowy skrypt (z SATURN)
scripts/deploy/deploy.sh --service planner-agent

# 3. Weryfikacja
docker ps --filter name=planner-agent
docker logs planner-agent --tail 30
ls -la /opt/homelab/state/planner-agent.heartbeat

Uwaga: stage verify w deploy.sh może failować bezpośrednio po starcie (race condition — heartbeat jest pisany co ~5 s). Kontener jest zdrowy gdy docker ps pokazuje (healthy).

---

Uruchamianie lokalne (bez Dockera)

cd services/planner-agent

# Zainstaluj zależności
pip install -r requirements.txt

# Wyeksportuj zmienne (lub stwórz .env i użyj `export $(cat .env | xargs)`)
export REDIS_URL=redis://localhost:6379
export OLLAMA_HOST=http://localhost:11434
export OLLAMA_MODEL=qwen2.5:7b
export NODE_NAME=dev-local
export RUNTIME_PATH=/tmp/homelab-dev
export COOLDOWN_SECONDS=10

# Uruchom
python src/planner.py

---

Testowanie

Testy jednostkowe

cd services/planner-agent
pip install -r requirements.txt pytest pytest-asyncio
pytest tests/ -v
# 49 testów planner + 34 testy llm_router

Ręczny end-to-end test przez Redis

# Opublikuj sztuczne zdarzenie unhealthy na kanale health_events
redis-cli -h 100.108.208.3 PUBLISH health_events '{
  "type": "service_unhealthy",
  "node": "piha",
  "service": "mosquitto",
  "severity": "error",
  "payload": {"exit_code": 1, "reason": "OOMKilled"},
  "timestamp": "2026-05-27T20:00:00Z"
}'

# Obserwuj logi planera
docker logs planner-agent -f

# Sprawdź czy propozycja trafiła do pending
ls /opt/homelab/actions/pending/
cat /opt/homelab/actions/pending/plan-piha-mosquitto-*.json

Śledzenie metryk LLM

# Subskrybuj metryki routera w czasie rzeczywistym
redis-cli -h 100.108.208.3 SUBSCRIBE llm_router_metrics

---