6b85c7ef68
Wzorzec mechaniczny: sekcje deploy/verify/install/testy wycinane do kb/runbooks/<serwis>-*.md, reszta zostaje dokumentem type: service. Wzajemne `links` w obie strony. Tresc sekcji nietknieta — przenoszone doslownie, dodany wylacznie naglowek H1 nowego runbooka. kb-query, paperless-worker, planner-agent, ha-diag-agent, ollama-piha, narty27, home-assistant, ha-mcp, job-gmail-header-backfill, job-mail-body-ingest. Weryfikacja: dla kazdego pliku multizbior niepustych linii (main + runbook) == oryginal z HEAD. Zero zgubionych, zero dodanych. Recon szacowal 13 splitow service+runbook; faktycznie 2-typowych jest 10, pozostale 5 (paperless, nextcloud, gokapi, fleet-prometheus, deploy-runner) sa 3-typowe i ida osobno jako splity wielotypowe. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
106 lines
2.3 KiB
Markdown
106 lines
2.3 KiB
Markdown
---
|
|
okf: "0.1"
|
|
type: runbook
|
|
visibility: private
|
|
status: active
|
|
updated: 2026-05-27
|
|
links:
|
|
- ../services/planner-agent.md
|
|
---
|
|
|
|
# planner-agent — deploy, uruchamianie, testy
|
|
|
|
## Deployment na SOLARIA
|
|
|
|
```bash
|
|
# 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)
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# Subskrybuj metryki routera w czasie rzeczywistym
|
|
redis-cli -h 100.108.208.3 SUBSCRIBE llm_router_metrics
|
|
```
|
|
|
|
---
|
|
|