docs: operations runbook + README update #15
@@ -18,3 +18,24 @@
|
||||
- [PH-7.barriers](./phases/PH-7.barriers/) — Шлагбаумы, тротуары, слой препятствий
|
||||
- [PH-8.elevation-profile](./phases/PH-8.elevation-profile/) — Профиль высот, режим «Горка»
|
||||
- [PH-9.pwa](./phases/PH-9.pwa/) — Офлайн режим
|
||||
|
||||
## Задачи (Work Items)
|
||||
|
||||
| ID | Название | Статус | Ветка |
|
||||
|----|----------|--------|-------|
|
||||
| ET-001 | Слой шлагбаумов | ✅ Done | main |
|
||||
| ET-002 | POI и маршруты | ✅ Done | main |
|
||||
| ET-005 | Переключатель единиц | ✅ Done | main |
|
||||
| ET-006 | Загрузка GPX-треков | ✅ Done | main |
|
||||
| ET-007 | Спутниковый слой | ✅ Done | main |
|
||||
| ET-008 | GPS-треки с публичных платформ | ✅ Done | main |
|
||||
|
||||
## Инфраструктура
|
||||
|
||||
- **URL:** https://openclaw.mva154.duckdns.org/enduro/
|
||||
- **Host:** mva154 (82.22.50.71)
|
||||
- **App container:** enduro-trails-app-1 (port 5558)
|
||||
- **GPS collector:** docker compose --profile batch run --rm gps-collector
|
||||
- **Deploy:** автоматически через orchestrator deployer (SSH hook)
|
||||
- **Логи deploy:** /var/log/enduro-trails/deploy-hook.log
|
||||
- **Pipeline:** Multi-Agent Orchestrator (port 8500)
|
||||
|
||||
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