Deployji, pregledi i vraćanje na prethodne verzije.
Kako pushevi postaju dostupni, pregledi grana, povratak na raniju verziju, naredba za izdanje za migracije, postavke builda, deploy hookovi, način održavanja i lozinke za preglede.
Kad aplikacija jednom proradi, za objavu promjena rijetko vam treba panel: napravite push na granu i nova verzija sama postaje dostupna. Ovaj članak opisuje sve oko toga — karticu Deployji, Preglede, karticu Procesi i nekoliko prekidača u Postavkama.
Automatski deploy pri svakom pushu
Svaki push na granu aplikacije pokreće build zadnjeg commita i njegov deploy. Nova verzija pokreće se uz onu koja radi i prima posjetitelje tek kad počne odgovarati; ako se ne pokrene, prethodna verzija nastavlja raditi, a mi vas obavještavamo e-poštom (i Telegramom, ako ste ga povezali).
Push napravljen dok drugi build još čeka u redu pridružuje se tom buildu, pa niz pusheva ne stvara dugačak red.
To možete isključiti pod Postavke → Deploy pri svakom pushu. Kad je isključeno, deploy pokrećete iz panela, putem API-ja ili deploy hooka.
Deploy iz panela
Kartica Deployji navodi svaki deploy: što ga je pokrenulo (push, panel, vraćanje verzije, deploy hook), commit, koliko je trajao i njegov status. Kliknite deploy da biste vidjeli cijeli zapis builda.
Ponovni deploy nudi dva izbora:
- Izgradi zadnji commit — uzima najnoviji kod s grane i gradi ga.
- Ponovno pokreni trenutnu verziju — primjenjuje promijenjene varijable, bez novog builda. Koristite ga nakon uređivanja Varijabli.
Izbornik pokraj Otvori ima iste dvije radnje i još Ponovno pokreni.
Vraćanje na prethodnu verziju
Možete se vratiti na bilo koju od zadnjih 5 uspješnih verzija. Na kartici Deployji kliknite Vrati na željenoj verziji i potvrdite. Ranija verzija pokreće se uz trenutnu i preuzima promet čim počne odgovarati — novog builda nema.
Vraćanje verzije ne poništava promjene u bazi podataka. Ako je izdanje promijenilo strukturu baze, vratite i bazu — pogledajte Baze podataka.
Pregledi za grane
Push na bilo koju drugu granu dobiva vlastiti pregled — zasebnu adresu na kojoj možete provjeriti promjene prije nego što postanu dostupne. Otvorite ih na kartici Pregledi.
- Najviše 3 pregleda istodobno, uključeno u cijenu.
- Pregled bez novih pusheva tijekom 7 dana uklanja se. Ponovno se izrađuje pri sljedećem pushu na tu granu.
- Pregledi dobivaju samo varijable namijenjene njima — pogledajte Varijable okruženja.
- Pregledi se izrađuju za glavni servis projekta, ne i za njegove ostale servise.
Lozinka za preglede
Na kartici Pregledi, Lozinka za preglede → Traži lozinku. Unesite korisničko ime i lozinku (najmanje 8 znakova). Od tada preglede mogu otvoriti samo osobe koje imaju lozinku; sama aplikacija ostaje otvorena svima.
Naredba za izdanje (migracije)
Kartica Procesi → Naredba za izdanje. Izvršava se jednom pri svakom deployu, prije nego što nova verzija primi posjetitelje — obično su to migracije baze podataka. Ako ne uspije, deploy se zaustavlja i trenutna verzija nastavlja raditi, pa neispravna migracija nikad ne stiže do vaših posjetitelja.
Za frameworke koji je imaju predlažemo naredbu:
| Framework | Preporučena naredba za izdanje |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Koristi preporučenu naredbu zadržava je; možete unijeti i vlastitu ili odabrati Bez naredbe. Promjene vrijede od sljedećeg deploya.
Postavke builda
Postavke → Postavke builda omogućuju vam da promijenite ono što smo prepoznali:
- Naredba za instalaciju — npr.
npm ci - Naredba za build — npr.
npm run build - Naredba za pokretanje — naredba koja pokreće vašu aplikaciju. Mora slušati na portu iz
$PORT. - Izlazna mapa — za statične stranice, mapa s izgrađenim datotekama.
- Mapa projekta — za repozitorij s više projekata.
Ostavite polje prazno da biste koristili ono što smo prepoznali. Sljedeći deploy gradi se s novim postavkama; Pokreni build sada pokreće ga odmah.
U Postavkama se nalazi i Grana koja se objavljuje.
Deploy hookovi
Postavke → Deploy hookovi → Izradi hook. Deploy hook je privatna adresa: kad joj drugi servis pošalje POST zahtjev, zadnji commit vaše grane gradi se i objavljuje. Tipičan primjer je CMS koji ponovno gradi stranicu nakon što objavite sadržaj.
curl -X POST "<adresa hooka iz panela>"- Adresa se prikazuje samo jednom — kopirajte je kad izradite hook. Svatko tko je ima može pokrenuti deploy, pa je čuvajte privatnom.
- Najviše 10 deployja na sat po hooku. Poziv koji stigne dok build još čeka pridružuje mu se.
- Opozovi odmah gasi adresu; servisi koji je pozivaju tada trebaju novu.
Način održavanja
Postavke → Način održavanja → Prikaži stranicu održavanja. Posjetitelji umjesto aplikacije vide kratku stranicu s vašom porukom; ostavite poruku praznom da bi se prikazalo «Uvodimo nekoliko poboljšanja. Molimo vratite se malo kasnije.»
Sama aplikacija i dalje radi, pa sve možete provjeriti prije ponovnog otvaranja. Privatna poveznica za vas prikazuje aplikaciju kao inače na uređaju koji je otvori, 12 sati. Nova poveznica izrađuje novu; stara prestaje raditi.
Isključite prekidač da biste aplikaciju ponovno otvorili posjetiteljima.
Obavijesti o deployjima
Šaljemo vam e-poruku (i Telegram poruku, ako ste ga povezali) kad se deploy ne završi. Da biste događaje slali i svom timu — nova verzija je dostupna, deploy se nije završio, servis je stao ili se vratio, visoka potrošnja memorije ili procesora, sigurnosna kopija ili disk baze podataka — dodajte Slack, Discord ili vlastiti webhook pod Postavke → Obavijesti vašem timu. Webhook poruke su JSON potpisan tajnim ključem koji se prikazuje samo jednom, u zaglavlju X-Rivervo-Signature.