Operátorská príručka¶

Táto sekcia je určená pre administrátorov a DevOps inžinierov zodpovedných za nasadenie a prevádzku GitPulse.

Prehľad¶

graph TB
    subgraph "Infraštruktúra"
        LB["Load Balancer / Caddy"]
        API["GitPulse API<br/>FastAPI"]
        WORKER["Background Workers<br/>RQ"]
        DB[("PostgreSQL")]
        REDIS[("Redis")]
        PROM["Prometheus"]
        GRAF["Grafana"]
    end

    LB --> API
    API --> DB
    API --> REDIS
    WORKER --> DB
    WORKER --> REDIS
    PROM --> API
    GRAF --> PROM

Čo nájdete v tejto sekcii¶

Nasadenie

Inštalácia a konfigurácia na produkčnom serveri

Nasadenie
Aktualizácie

Proces aktualizácie na novú verziu

Aktualizácie
Zálohovanie

Stratégia zálohovania a obnovy

Zálohovanie
Monitoring

Prometheus, Grafana, alerting

Monitoring
Troubleshooting

Riešenie bežných problémov

Troubleshooting

Minimálne požiadavky¶

Hardware¶

Komponent	Minimum	Odporúčané
CPU	2 cores	4 cores
RAM	4 GB	8 GB
Disk	20 GB SSD	50 GB SSD
Sieť	100 Mbps	1 Gbps

Software¶

Komponent	Verzia
Docker	24.0+
Docker Compose	2.20+
PostgreSQL	16+
Redis	7+

Sieťové požiadavky¶

Port	Služba	Prístup
443	HTTPS (Caddy)	Verejný
80	HTTP redirect	Verejný
5432	PostgreSQL	Interný
6379	Redis	Interný
8000	API (interný)	Interný
9090	Prometheus	Interný
3000	Grafana	Interný/VPN

Architektúra nasadenia¶

Jednoduchý deployment (1 server)¶

graph TB
    subgraph "Server"
        CADDY["Caddy :443"]
        subgraph "Docker"
            API["GitPulse API :8000"]
            WORKER["Worker"]
            PG[("PostgreSQL")]
            RED[("Redis")]
        end
    end

    INET["Internet"] --> CADDY
    CADDY --> API
    API --> PG
    API --> RED
    WORKER --> PG
    WORKER --> RED

Škálovateľný deployment¶

graph TB
    subgraph "Load Balancer"
        LB["HAProxy / Nginx"]
    end

    subgraph "App Tier"
        API1["API Instance 1"]
        API2["API Instance 2"]
        WORKER1["Worker 1"]
        WORKER2["Worker 2"]
    end

    subgraph "Data Tier"
        PG[("PostgreSQL Primary")]
        PG_REP[("PostgreSQL Replica")]
        RED[("Redis Cluster")]
    end

    LB --> API1
    LB --> API2
    API1 --> PG
    API2 --> PG
    API1 --> RED
    API2 --> RED
    WORKER1 --> PG
    WORKER2 --> PG
    PG --> PG_REP

Rýchly štart¶

1. Príprava servera¶

Bash
# Aktualizácia systému
sudo apt update && sudo apt upgrade -y

# Inštalácia Docker
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

# Inštalácia Docker Compose
sudo apt install docker-compose-plugin

Bash
1 2 3 4 5 6 7 8 9	`# Aktualizácia systému sudo apt update && sudo apt upgrade -y # Inštalácia Docker curl -fsSL https://get.docker.com \| sh sudo usermod -aG docker $USER # Inštalácia Docker Compose sudo apt install docker-compose-plugin`

2. Klonovanie repozitára¶

Bash
git clone https://git.kpi.fei.tuke.sk/kpi-zp/2027/dp.mykyta.olym/workspace/workspace.git gitpulse
cd gitpulse

Bash
1 2	`git clone https://git.kpi.fei.tuke.sk/kpi-zp/2027/dp.mykyta.olym/workspace/workspace.git gitpulse cd gitpulse`

3. Konfigurácia¶

Bash
# Kopírovanie šablóny
cp .env.example .env

# Úprava konfigurácie
nano .env

Bash
1 2 3 4 5	`# Kopírovanie šablóny cp .env.example .env # Úprava konfigurácie nano .env`

4. Spustenie¶

Bash
docker compose up -d

Bash
1	`docker compose up -d`

5. Overenie¶

Bash
# Health check
curl http://localhost:8000/health

# Logy
docker compose logs -f

Bash
1 2 3 4 5	`# Health check curl http://localhost:8000/health # Logy docker compose logs -f`

Ďalšie kroky¶

Detailné nasadenie - Kompletný sprievodca
Konfigurácia TLS - HTTPS setup
GitLab integrácia - Napojenie na GitLab
Monitoring - Nastavenie alertov