Provozní dokumentace
Nasazení, monitoring a konfigurace prostředí
Provozní dokumentace pokrývá vše potřebné pro nasazení, provoz a monitoring platformy Turtor.
Přehled infrastruktury
Turtor běží jako sada Docker kontejnerů na Hetzner VPS serveru. Produkční prostředí se skládá z následujících služeb:
| Služba | Technologie | Účel |
|---|---|---|
| API | Node.js 20 (NestJS) | Backend REST API |
| Web | nginx (SPA) | Veřejný web pro firmy |
| Admin | nginx (SPA) | Administrační dashboard |
| PostgreSQL | PostgreSQL 16 Alpine | Relační databáze |
| Redis | Redis 7 Alpine | Cache, fronty úloh, sessions |
| Nginx proxy | nginx Alpine | Reverse proxy, SSL terminace |
Domény
| Doména | Služba |
|---|---|
ckk.byadf.ai | Veřejný web |
api.ckk.byadf.ai | API backend |
admin.ckk.byadf.ai | Admin dashboard |
Deployment pipeline
Nasazení probíhá v těchto krocích:
- Build -- Docker obrazy se staví vzdáleně na VPS přes
docker buildx(vyhýbá se ARM emulaci na macOS) - Push -- Obrazy se pushují do GitHub Container Registry (
ghcr.io/<OWNER>/turtor-*) - Deploy -- VPS stáhne nové obrazy z GHCR a restartuje kontejnery
Nikdy nespouštějte docker compose down -v na produkci -- příznak -v trvale smaže datové volumes včetně databáze.
Sekce dokumentace
- Docker -- Kontejnerizace a Docker Compose konfigurace
- VPS nasazení -- Konfigurace serveru a reverse proxy
- Deploy skripty -- Automatizace nasazení
- Health checks -- Kontroly stavu služeb
- Logy -- Správa a sledování logů
- Proměnné prostředí -- Konfigurace environment proměnných
- Redis -- Redis konfigurace a správa