docs: add operations runbook, update README with work items and infra
This commit is contained in:
50
docs/operations/runbook.md
Normal file
50
docs/operations/runbook.md
Normal file
@@ -0,0 +1,50 @@
|
||||
# Runbook: Enduro Trails
|
||||
|
||||
## Сервисы
|
||||
|
||||
| Сервис | Команда | Порт |
|
||||
|--------|---------|------|
|
||||
| App (API + static) | `docker compose up -d app` | 5558 |
|
||||
| GPS Collector (разовый запуск) | `docker compose --profile batch run --rm gps-collector` | — |
|
||||
| GPS Collector (с регионом) | `docker compose --profile batch run --rm gps-collector python scripts/gps_collect.py --region tsfo_plus_chuvashia --source osm` | — |
|
||||
|
||||
## Deploy
|
||||
|
||||
Deploy выполняется автоматически через Multi-Agent Orchestrator.
|
||||
При ручном деплое:
|
||||
```bash
|
||||
cd /home/slin/repos/enduro-trails
|
||||
git pull origin main
|
||||
docker compose up -d app
|
||||
```
|
||||
|
||||
## GPS Collector
|
||||
|
||||
Первичный сбор треков (ЦФО + Чувашия, OSM):
|
||||
```bash
|
||||
cd /home/slin/repos/enduro-trails
|
||||
nohup docker compose --profile batch run --rm gps-collector python scripts/gps_collect.py --region tsfo_plus_chuvashia --source osm > /tmp/gps-collector.log 2>&1 &
|
||||
```
|
||||
|
||||
Статус:
|
||||
```bash
|
||||
tail -f /tmp/gps-collector.log
|
||||
```
|
||||
|
||||
Активация EnduroRussia/ttrails источников — после юридического review ADR-010/ADR-011:
|
||||
1. Обновить статус ADR до `accepted`
|
||||
2. Установить `enabled: true` в `config/gps_sources.yaml`
|
||||
|
||||
## Healthcheck
|
||||
|
||||
```bash
|
||||
curl -s https://openclaw.mva154.duckdns.org/enduro/api/health
|
||||
curl -s https://openclaw.mva154.duckdns.org/enduro/api/gps-tracks/health
|
||||
```
|
||||
|
||||
## Логи
|
||||
|
||||
```bash
|
||||
docker logs enduro-trails-app-1 --tail 50
|
||||
tail -f /var/log/enduro-trails/deploy-hook.log
|
||||
```
|
||||
Reference in New Issue
Block a user