THECR3W-DEV — INSTRUKCJA WGRANIA I WDROŻENIA NA SERWERZE

Środowisko: Netcup VPS (IP: 89.58.46.176)

Paczka thecr3w-dev-deploy.zip zawiera kompletny kod źródłowy platformy, skrypty instalacji i konfiguracji, kontenery Docker oraz szablony integracji z Caddy i Keycloak.

Krok 1: Przesłanie paczki ZIP na serwer

W terminalu lokalnym (PowerShell lub Linux/macOS) wykonaj:

scp thecr3w-dev-deploy.zip root@89.58.46.176:/opt/

(lub użyj programu WinSCP / FileZilla z protokołem SFTP).

Krok 2: Rozpakowanie na serwerze

Zaloguj się na serwer przez SSH:

ssh root@89.58.46.176

Przejdź do katalogu /opt i rozpakuj paczkę:

cd /opt
unzip thecr3w-dev-deploy.zip -d thecr3w
cd /opt/thecr3w

Nadaj uprawnienia wykonywania skryptom:

chmod +x deploy.sh scripts/*.sh

Krok 3: Konfiguracja zmiennych (Opcjonalnie)

Przejrzyj plik .env (jeśli nie istnieje, skrypt deploy.sh utworzy go automatycznie z .env.example i wygeneruje silne hasło bazy PostgreSQL):

cp -n .env.example .env
nano .env

W .env możesz uzupełnić:

R2_ACCESS_KEY_ID= (klucz Cloudflare R2)
R2_SECRET_ACCESS_KEY= (sekret Cloudflare R2)

Krok 4: Uruchomienie budowania i instalacji

Uruchom główny skrypt wdrożeniowy:

./deploy.sh

Skrypt automatycznie:

Zweryfikuje obecność Dockera i sieci proxy.
Zbuduje lokalnie na serwerze obrazy kontenerów (thecr3w-backend, thecr3w-download-center, thecr3w-admin-panel).
Uruchomi dedykowany kontener PostgreSQL 16 (thecr3w-postgres) i zainicjalizuje strukturę tabel oraz indeksów.
Uruchomi backend i frontendy w sieci proxy.
Sprawdzi stan usług testem healthcheck (http://localhost:5000/health).

Krok 5: Aktywacja domen w Caddy (Zero-Downtime)

Aby podpiąć domeny app.thecr3wnet.com oraz download.thecr3wnet.com bez przerywania działania innych usług (w tym istniejącego Keycloak czy aplikacji na thecr3wnet.com), uruchom:

./scripts/update_caddy.sh

Skrypt:

Utworzy kopię zapasową /opt/proxy/Caddyfile.bak_<data>.
Dopisze bezpiecznie bloki reverse proxy dla TheCr3w.
Przeprowadzi walidację składni w kontenerze caddy.
Przeładuje Caddy w trybie zero-downtime (caddy reload).

Krok 6: Weryfikacja działania

Po zakończeniu sprawdź działanie w przeglądarce:

The Cr3w Download Center: https://download.thecr3wnet.com
Native Update API (Health): https://app.thecr3wnet.com/health
Native Update API (OpenAPI spec): https://app.thecr3wnet.com/api/v1/apps

Przydatne polecenia utrzymaniowe

# Podgląd stanu kontenerów TheCr3w:
docker ps --filter "name=thecr3w"

# Podgląd logów backendu w czasie rzeczywistym:
docker logs -f thecr3w-backend

# Restart całego stacku TheCr3w:
docker compose restart

# Zatrzymanie stacku:
docker compose down

2.9 KiB Raw Blame History