ligbox-ops-platform/specs/029-agentic-ops-runbooks/quickstart.md

Quickstart — Spec 029 Agentic Ops

Staging (homologação — portas 8180/8192)

ssh root@10.10.10.122
cd /opt/ligbox-ops-platform-staging
git fetch && git checkout 029-agentic-ops-runbooks && git pull
cp .env.staging.example .env   # ajustar tokens
docker compose -f docker-compose.agentic-staging.yml up -d --build

Validar T0

curl -s http://10.10.10.122:8180/api/health | jq .
curl -s http://10.10.10.122:8180/api/v1/agents/health | jq .
# Esperado: tier t1 se AGENTIC_LLM_ENABLED=true e Ollama OK

curl -s -X POST http://10.10.10.122:8180/api/v1/agents/internal/tick \
  -H "X-Ops-Internal-Token: SEU_TOKEN" | jq .

Validar T1 (Ollama VM123)

ssh root@10.10.10.123 'curl -s http://127.0.0.1:11434/api/tags'
# Esperado: qwen2.5:7b-instruct, nomic-embed-text

Validar chat (com JWT Desk)

TOKEN=$(curl -s -X POST http://10.10.10.122:8180/api/v1/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"username":"root","password":"..."}' | jq -r .access_token)

curl -s -X POST http://10.10.10.122:8180/api/v1/agents/chat \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"question":"Como validar FOSSBilling na VM123?"}' | jq .

Checklist homologação (2026-06-19)

• /api/v1/agents/health → 200, ollama true
• Tick interno → 9 cenários, 103 ficheiros KB indexados
• Findings gravados em SQLite staging (VM123 finance, OpenPanel bridge)
• E-mail teste em finding critical (opcional)
• UI Agentic Ops no Desk staging :8192
• Chat copiloto endpoint /chat operacional (T1 quando Ollama responde <120s)
• Produção :8080 → 0.9.7-spec029-agentic com agents API activa

Promover produção

Somente após checklist:

cd /opt/ligbox-ops-platform
git checkout 029-agentic-ops-runbooks && git pull
docker compose -f docker-compose.mvp.yml up -d --build api worker frontend