Files
enduro-trails/docs/operations/runbook.md
claude-bot 37af99eb6b
Some checks failed
CI / lint (pull_request) Failing after 4s
CI / test (pull_request) Failing after 5s
CI / build (pull_request) Has been skipped
docs: add operations runbook, update README with work items and infra
2026-06-01 20:10:02 +03:00

51 lines
1.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
```