Rozdział 9: Pierwszy deploy i weryfikacja
Cała konfiguracja za nami. Czas wcisnąć „guzik" i wdrożyć aplikację. Ten rozdział pokazuje pierwszy deploy oraz — co ważne — jak sprawdzić, że naprawdę działa. Od teraz wdrażanie jest ♻️ powtarzalne: tak będzie wyglądać każda przyszła aktualizacja.
Po tym rozdziale aplikacja działa pod
https://<DOMENA>i wiesz, jak zweryfikować poprawność każdego wdrożenia.
Krok 1: Uruchom deploy 💻♻️
Co robisz: wywołujesz workflow Deploy, wysyłając commit na main.
Dlaczego: deploy uruchamia się na push na main. Pierwszy raz możemy użyć „pustego" commita, by nic nie zmieniając, odpalić wdrożenie.
# 💻 lokalnie, w katalogu projektu (prompt: nazwa-projektu git:(main))
git commit --allow-empty -m "chore: trigger first deploy"
git push origin main
Upewnij się, że jesteś na swoim komputerze, nie na serwerze. Jeśli w terminalu widzisz
root@...(serwer), otwórz nowe okno terminala albo wpiszexit.
Oczekiwany rezultat: push się powiódł; na GitHubie rusza workflow „Deploy to Production".
Na co dzień nie używasz pustego commita — po prostu commitujesz swoje zmiany i
git push origin main. Pusty commit to tylko sposób na „ręczne" odpalenie deployu bez zmian w kodzie.
Krok 2: Obserwuj przebieg 🐙
- Wejdź:
https://github.com/<REPO>/actions - Otwórz najnowszy przebieg „Deploy to Production" → kliknij job deploy.
- Zobaczysz logi na żywo (SSH,
git pull, budowanie, migracje…).
Pierwszy deploy trwa dłużej (budowanie obrazu + ewentualny npm install/vite build na serwerze — kilka minut). Sukces kończy się w logu:
Deploy complete!
i zielonym ✔ przy jobie.
🎯 W FactoryCode w logu zobaczysz m.in. „migrations executed", „Cache for the prod environment … cleared", „Deploy complete!".
Krok 3: Zweryfikuj działanie aplikacji 💻
To najważniejsza część — nie ufaj samemu „zielonemu" w Actions, sprawdź realny efekt.
a) Strona w przeglądarce
Otwórz https://<DOMENA> i zrób twarde odświeżenie (Cmd+Shift+R / Ctrl+Shift+R), żeby pominąć stary cache przeglądarki.
Oczekiwany rezultat: strona ładuje się ze stylami (nie goły HTML), z kłódką HTTPS.
b) Szybkie testy z terminala
# 💻 lokalnie — podmień <DOMENA>
curl -sS -o /dev/null -w "HTTP %{http_code} | SSL verify:%{ssl_verify_result}\n" https://<DOMENA>
curl -sS -o /dev/null -w "HTTP %{http_code} -> %{redirect_url}\n" http://<DOMENA>
Oczekiwany rezultat:
- pierwsza komenda:
HTTP 200 | SSL verify:0(0 = certyfikat poprawny), - druga:
HTTP 301 -> https://<DOMENA>/(HTTP przekierowuje na HTTPS).
c) Czy assety (style) się serwują
Sprawdź, czy strona linkuje pliki z /build/ i czy zwracają 200:
# 💻 lokalnie
curl -sS https://<DOMENA> | grep -oiE '/build/[^"]+' | head
Weź jedną z wypisanych ścieżek i sprawdź status:
curl -sS -o /dev/null -w "HTTP %{http_code}\n" "https://<DOMENA>/build/assets/NAZWA-PLIKU"
Oczekiwany rezultat: HTTP 200 dla plików CSS/JS.
🎯 Dla FactoryCode zweryfikowaliśmy:
https://factorycode.pl→ HTTP 200 + ważny SSL,/blog→ 200, HTTP → 301, pliki/build/assets/app-*.css|js→ 200. Tytuł strony: „Start — FactoryCode".
Co dokładnie dzieje się przy każdym kolejnym wdrożeniu ♻️
Od teraz Twój cykl pracy to:
1. 💻 piszesz kod, commit
2. 💻 git push origin main
3. 🐙 CI sprawdza jakość (osobny workflow)
4. 🐙 Deploy loguje się na serwer i aktualizuje aplikację
5. 💻 (opcjonalnie) weryfikujesz stronę
Nie musisz już logować się na serwer ani kopiować plików. To jest sens CD.
Częste problemy
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| deploy czerwony na „Deploy via SSH" | brak/zły sekret SSH | sprawdź VPS_SSH_KEY (cały prywatny klucz), VPS_HOST, VPS_USER |
| strona: błąd 502 | aplikacja nie wstała (kontenery) | sprawdź logi na serwerze: cd <APP_DIR> && docker compose --env-file .env.local <COMPOSE> logs app |
| strona: błąd 500 | błąd aplikacji (np. migracje, env) | logi kontenera app; sprawdź, czy migracje przeszły i .env.local jest poprawny |
| strona bez stylów | front nie zbudowany/niezsynchronizowany | patrz Rozdział 8 (build + sync public/build); zrób twarde odświeżenie |
git pull na serwerze pyta o login |
repo prywatne bez Deploy Key w remote SSH | sprawdź Rozdział 7 (klon przez git@github.com:...) |
Jak podejrzeć logi na serwerze 🖥️
# 🖥️ na serwerze
cd <APP_DIR>
docker compose --env-file .env.local -f compose.yaml -f compose.prod.yaml ps # stan kontenerów
docker compose --env-file .env.local -f compose.yaml -f compose.prod.yaml logs app --tail=50
Podsumowanie
- ✅ Wykonałeś pierwszy automatyczny deploy (
git push→ wdrożenie). - ✅ Aplikacja działa pod
https://<DOMENA>ze stylami i ważnym SSL. - ✅ Umiesz zweryfikować wdrożenie (przeglądarka +
curlHTTP/SSL/assety). - ✅ Znasz powtarzalny cykl: push → CI → Deploy → (weryfikacja).
Aplikacja działa. Zadbajmy jeszcze o bezpieczeństwo danych — automatyczny backup bazy.
Dalej: Rozdział 10: Backup bazy i utrzymanie.