9

Rozdział 9 z 11

Pierwszy deploy i weryfikacja

Opublikowany

Pierwszy deploy (pusty commit), obserwacja w Actions oraz weryfikacja: HTTP 200, SSL, przekierowanie HTTP→HTTPS i serwowanie assetów.

Czego się nauczysz

  • Uruchomienie deployu
  • Obserwacja przebiegu w Actions
  • Weryfikacja strony (curl, SSL, assety)
  • Powtarzalny cykl wdrożeń

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 wpisz exit.

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 🐙

  1. Wejdź: https://github.com/<REPO>/actions
  2. Otwórz najnowszy przebieg „Deploy to Production" → kliknij job deploy.
  3. 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 + curl HTTP/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.

Narzędzia / paczki

Git GitHub Actions curl

Spis treści