Wdrożenia, podglądy i wycofywanie zmian.
Jak pushe trafiają na produkcję, podglądy gałęzi, powrót do wcześniejszej wersji, polecenie wydania do migracji, ustawienia budowania, hooki wdrożeń, tryb serwisowy i hasła do podglądów.
Gdy aplikacja już działa, do wypuszczania zmian rzadko potrzebujesz panelu: robisz push do gałęzi, a nowa wersja sama trafia na produkcję. Ten artykuł opisuje wszystko wokół tego — kartę Wdrożenia, Podglądy, kartę Procesy i kilka przełączników w Ustawieniach.
Automatyczne wdrożenie przy każdym pushu
Każdy push do gałęzi aplikacji buduje najnowszy commit i go wdraża. Nowa wersja startuje obok działającej i dostaje ruch dopiero wtedy, gdy zacznie odpowiadać; jeśli się nie uruchomi, poprzednia wersja działa dalej, a my powiadamiamy cię e-mailem (i na Telegramie, jeśli go podłączysz).
Push wykonany wtedy, gdy inne budowanie wciąż czeka w kolejce, dołącza do tego budowania, więc seria pushy nie tworzy długiej kolejki.
Możesz to wyłączyć w Ustawienia → Wdrażaj każdy push. Gdy jest wyłączone, wdrażasz z panelu, przez API albo hookiem wdrożenia.
Wdrażanie z panelu
Karta Wdrożenia zawiera listę wszystkich wdrożeń: co je uruchomiło (push, panel, wycofanie, hook wdrożenia), commit, czas trwania i status. Kliknij wdrożenie, żeby zobaczyć pełny log budowania.
Wdróż ponownie daje dwie możliwości:
- Zbuduj najnowszy commit — pobiera najnowszy kod z gałęzi i go buduje.
- Wdróż ponownie działającą wersję — wprowadza zmienione zmienne, bez nowego budowania. Używaj tego po edycji Zmiennych.
Menu obok Otwórz ma te same dwie akcje oraz Uruchom ponownie.
Wycofywanie zmian
Możesz wrócić do każdej z 5 ostatnich udanych wersji. Na karcie Wdrożenia kliknij Wycofaj przy wybranej wersji i potwierdź. Wcześniejsza wersja startuje obok bieżącej i przejmuje ruch, gdy zacznie odpowiadać — bez nowego budowania.
Wycofanie nie cofa zmian w bazie danych. Jeśli wydanie zmieniło strukturę bazy, przywróć też bazę — zobacz Bazy danych.
Podglądy gałęzi
Push do każdej innej gałęzi dostaje własny podgląd — osobny adres, pod którym sprawdzisz zmiany, zanim trafią na produkcję. Otworzysz je na karcie Podglądy.
- Do 3 podglądów jednocześnie, w cenie.
- Podgląd bez nowych pushy przez 7 dni jest usuwany. Powstaje ponownie przy kolejnym pushu do tej gałęzi.
- Podglądy dostają tylko przeznaczone dla nich zmienne — zobacz Zmienne środowiskowe.
- Podglądy powstają dla głównej usługi projektu, nie dla jego pozostałych usług.
Hasło do podglądów
Na karcie Podglądy: Hasło do podglądów → Wymagaj hasła. Wpisz nazwę użytkownika i hasło (co najmniej 8 znaków). Od tej chwili podglądy otworzą tylko osoby znające hasło; sama aplikacja pozostaje otwarta dla wszystkich.
Polecenie wydania (migracje)
Karta Procesy → Polecenie wydania. Uruchamia się raz przy każdym wdrożeniu, zanim nowa wersja dostanie ruch — zwykle są to migracje bazy danych. Jeśli się nie powiedzie, wdrożenie zostaje przerwane, a bieżąca wersja działa dalej, więc wadliwa migracja nigdy nie dotrze do odwiedzających.
Dla frameworków, które mają takie polecenie, proponujemy je sami:
| Framework | Zalecane polecenie wydania |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Użyj zalecanego polecenia je zachowuje; możesz też wpisać własne albo wybrać Brak. Zmiany obowiązują od następnego wdrożenia.
Ustawienia budowania
Ustawienia → Ustawienia budowania pozwalają zmienić to, co wykryliśmy:
- Polecenie instalacji — np.
npm ci - Polecenie budowania — np.
npm run build - Polecenie uruchomienia — polecenie, które uruchamia aplikację. Musi nasłuchiwać na porcie z
$PORT. - Folder wynikowy — dla stron statycznych folder ze zbudowanymi plikami.
- Folder projektu — dla repozytorium z kilkoma projektami.
Zostaw pole puste, żeby użyć tego, co wykryliśmy. Następne wdrożenie zostanie zbudowane z nowymi ustawieniami; Zbuduj teraz uruchamia je od razu.
W Ustawieniach jest też Gałąź, która jest wdrażana.
Hooki wdrożeń
Ustawienia → Hooki wdrożeń → Utwórz hook. Hook wdrożenia to prywatny adres: gdy inna usługa wyśle na niego żądanie POST, najnowszy commit twojej gałęzi zostanie zbudowany i wdrożony. Typowe zastosowanie to CMS, który przebudowuje stronę po opublikowaniu treści.
curl -X POST "<the hook address from the panel>"- Adres jest pokazywany tylko raz — skopiuj go przy tworzeniu hooka. Każdy, kto go zna, może uruchomić wdrożenie, więc nikomu go nie udostępniaj.
- Do 10 wdrożeń na godzinę na jeden hook. Wywołanie, które przyjdzie, gdy budowanie wciąż czeka, dołącza do niego.
- Unieważnij od razu wyłącza adres; usługi, które go wywołują, potrzebują wtedy nowego.
Tryb serwisowy
Ustawienia → Tryb serwisowy → Pokaż stronę przerwy technicznej. Zamiast aplikacji odwiedzający widzą krótką stronę z twoim komunikatem; jeśli zostawisz go pustym, pokażemy: „Wprowadzamy kilka ulepszeń. Zajrzyj do nas za chwilę”.
Sama aplikacja działa dalej, więc możesz wszystko sprawdzić przed ponownym otwarciem. Prywatny link dla ciebie przez 12 godzin pokazuje aplikację normalnie na urządzeniu, na którym go otworzysz. Nowy link tworzy świeży link; stary przestaje działać.
Wyłącz przełącznik, żeby znowu otworzyć aplikację dla odwiedzających.
Powiadomienia o wdrożeniach
Gdy wdrożenie się nie zakończy, wysyłamy ci e-mail (i wiadomość na Telegramie, jeśli go podłączysz). Żeby zdarzenia trafiały też do zespołu — nowa wersja weszła na produkcję, wdrożenie się nie zakończyło, usługa się zatrzymała lub wróciła, wysokie zużycie pamięci lub procesora, kopia zapasowa albo dysk bazy danych — dodaj Slack, Discord lub własny webhook w Ustawienia → Powiadomienia dla zespołu. Wiadomości webhooka to JSON podpisany sekretem pokazywanym tylko raz, w nagłówku X-Rivervo-Signature.