110 lines
2.8 KiB
Markdown
110 lines
2.8 KiB
Markdown
# Release Runbook: Sofiia Console (One-Page)
|
||
|
||
Короткий сценарій релізу для `sofiia-console` з мінімальним ризиком та швидким rollback.
|
||
|
||
## 1) Preflight
|
||
|
||
```bash
|
||
cd /opt/microdao-daarion
|
||
bash ops/preflight_sofiia_console.sh
|
||
```
|
||
|
||
Для прод-вікна (warnings -> fail):
|
||
|
||
```bash
|
||
cd /opt/microdao-daarion
|
||
STRICT=1 bash ops/preflight_sofiia_console.sh
|
||
```
|
||
|
||
## 2) Deploy order
|
||
|
||
Рекомендований порядок:
|
||
|
||
1. **NODA2 precheck (control plane)** — health/metrics локально.
|
||
2. **NODA1 rollout (data plane)** — оновлення runtime сервісів.
|
||
3. **NODA2 finalize (control plane)** — фінальний restart/control-plane підтвердження.
|
||
|
||
Приклад команд:
|
||
|
||
```bash
|
||
# NODA1 rollout
|
||
ssh root@144.76.224.179 "cd /opt/microdao-daarion && docker compose -f docker-compose.node1.yml up -d router gateway memory-service"
|
||
```
|
||
|
||
```bash
|
||
# NODA2 finalize
|
||
cd /opt/microdao-daarion
|
||
docker compose -f docker-compose.node2-sofiia.yml up -d sofiia-console router
|
||
```
|
||
|
||
## 3) Smoke
|
||
|
||
### 3.1 Health + metrics
|
||
|
||
```bash
|
||
curl -fsS http://127.0.0.1:8002/api/health
|
||
curl -fsS http://127.0.0.1:8002/metrics | rg "sofiia_"
|
||
```
|
||
|
||
### 3.2 Redis idempotency (коли backend=redis)
|
||
|
||
```bash
|
||
cd /opt/microdao-daarion
|
||
bash ops/redis_idempotency_smoke.sh
|
||
```
|
||
|
||
### 3.3 Audit auth check
|
||
|
||
```bash
|
||
# без ключа має бути 401
|
||
curl -s -o /dev/null -w "%{http_code}\n" "http://127.0.0.1:8002/api/audit"
|
||
```
|
||
|
||
```bash
|
||
# з ключем має бути 200
|
||
KEY="<SOFIIA_CONSOLE_API_KEY>"
|
||
curl -s -o /dev/null -w "%{http_code}\n" \
|
||
-H "X-API-Key: ${KEY}" \
|
||
"http://127.0.0.1:8002/api/audit"
|
||
```
|
||
|
||
## 4) Rollback
|
||
|
||
1. Повернути попередню ревізію/образ.
|
||
2. Перезапустити сервіси у зворотному порядку релізу.
|
||
3. Виконати мінімальний smoke (health/metrics + audit auth).
|
||
|
||
Приклад:
|
||
|
||
```bash
|
||
# NODA2 rollback
|
||
cd /opt/microdao-daarion
|
||
git checkout <previous_release_tag_or_sha>
|
||
docker compose -f docker-compose.node2-sofiia.yml up -d sofiia-console router
|
||
```
|
||
|
||
```bash
|
||
# NODA1 rollback
|
||
ssh root@144.76.224.179 "cd /opt/microdao-daarion && git checkout <previous_release_tag_or_sha> && docker compose -f docker-compose.node1.yml up -d router gateway memory-service"
|
||
```
|
||
|
||
Після rollback:
|
||
|
||
```bash
|
||
curl -fsS http://127.0.0.1:8002/api/health
|
||
curl -fsS http://127.0.0.1:8002/metrics | rg "sofiia_"
|
||
```
|
||
|
||
## 5) Post-release checklist
|
||
|
||
- Перевірити `sofiia_rate_limited_total` та `sofiia_idempotency_replays_total`.
|
||
- Перевірити, що audit пишеться/читається:
|
||
- `POST /api/chats/.../send`
|
||
- `GET /api/audit` з ключем.
|
||
- Запустити retention dry-run:
|
||
|
||
```bash
|
||
cd /opt/microdao-daarion
|
||
python3 ops/prune_audit_db.py --dry-run
|
||
```
|