Deploy-uri, previzualizări și reveniri.
Cum ajung push-urile live, previzualizările pentru branch-uri, revenirea la o versiune anterioară, comanda de lansare pentru migrări, setările de build, hookurile de deploy, modul mentenanță și parolele pentru previzualizări.
Odată ce aplicația este live, rareori ai nevoie de panou ca să publici modificări: dai push pe branch și versiunea nouă ajunge live singură. Articolul acoperă tot ce ține de asta — fila Deploy-uri, Previzualizări, fila Procese și câteva comutatoare din Setări.
Deploy automat la fiecare push
Fiecare push pe branch-ul aplicației construiește ultimul commit și îl publică. Versiunea nouă pornește lângă cea care rulează și primește vizitatori doar după ce răspunde; dacă nu pornește, versiunea anterioară rulează în continuare și te anunțăm pe e-mail (și pe Telegram, dacă l-ai conectat).
Un push făcut în timp ce alt build încă așteaptă în coadă se alătură acelui build, așa că o serie de push-uri nu creează o coadă lungă.
Poți dezactiva asta din Setări → Deploy la fiecare push. Când este oprit, faci deploy din panou, prin API sau cu un hook de deploy.
Deploy din panou
Fila Deploy-uri listează fiecare deploy: ce l-a declanșat (un push, panoul, o revenire, un hook de deploy), commitul, cât a durat și starea lui. Apasă pe un deploy ca să-i vezi logul complet de build.
Deploy din nou oferă două variante:
- Construiește ultimul commit — ia cel mai nou cod de pe branch și îl construiește.
- Publică din nou versiunea curentă — aplică variabilele modificate, fără un build nou. Folosește-o după ce editezi Variabile.
Meniul de lângă Deschide are aceleași două acțiuni, plus Repornește.
Revenirea la o versiune anterioară
Poți reveni la oricare dintre ultimele 5 versiuni reușite. În fila Deploy-uri, apasă Revino la versiunea dorită și confirmă. Versiunea anterioară pornește lângă cea curentă și preia traficul după ce răspunde — fără un build nou.
O revenire nu anulează modificările din baza de date. Dacă o lansare a schimbat structura bazei de date, restaurează și baza de date — vezi Baze de date.
Previzualizări pentru branch-uri
Un push pe orice alt branch primește propria previzualizare — o adresă separată unde poți verifica modificările înainte să ajungă live. Le deschizi din fila Previzualizări.
- Până la 3 previzualizări simultan, incluse în preț.
- O previzualizare fără push-uri noi timp de 7 zile se șterge. Se creează din nou la următorul push pe acel branch.
- Previzualizările primesc doar variabilele destinate lor — vezi Variabile de mediu.
- Previzualizările se fac pentru serviciul principal al proiectului, nu și pentru celelalte servicii.
O parolă pentru previzualizări
În fila Previzualizări, Parolă pentru previzualizări → Cere parolă. Introdu un nume de utilizator și o parolă (minimum 8 caractere). De atunci, doar cine are parola poate deschide previzualizările; aplicația în sine rămâne deschisă pentru toată lumea.
Comanda de lansare (migrări)
Fila Procese → Comandă de lansare. Rulează o dată la fiecare deploy, înainte ca versiunea nouă să primească vizitatori — de obicei pentru migrările bazei de date. Dacă eșuează, deployul se oprește și versiunea curentă rulează în continuare, așa că o migrare stricată nu ajunge niciodată la vizitatori.
Pentru framework-urile care au o astfel de comandă, ți-o sugerăm noi:
| Framework | Comandă de lansare recomandată |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Folosește comanda recomandată o păstrează; poți introduce și propria comandă sau poți alege Niciuna. Modificările se aplică de la următorul deploy.
Setări de build
Setări → Setări de build îți permite să schimbi ce am detectat:
- Comandă de instalare — de exemplu
npm ci - Comandă de build — de exemplu
npm run build - Comandă de pornire — comanda care pornește aplicația. Aceasta trebuie să asculte pe portul din
$PORT. - Folder de ieșire — pentru site-urile statice, folderul cu fișierele construite.
- Folder proiect — pentru un repository cu mai multe proiecte.
Lasă un câmp gol ca să folosești ce am detectat. Următorul deploy se construiește cu setările noi; Build acum îl pornește imediat.
Tot în Setări se află și Branch-ul care se publică.
Hookuri de deploy
Setări → Hookuri de deploy → Creează un hook. Un hook de deploy este o adresă privată: când alt serviciu îi trimite o cerere POST, ultimul commit de pe branch-ul tău se construiește și se publică. Un exemplu tipic este un CMS care reconstruiește site-ul după ce publici ceva.
curl -X POST "<the hook address from the panel>"- Adresa se afișează o singură dată — copiaz-o când creezi hookul. Oricine o are poate porni un deploy, așa că păstreaz-o privată.
- Maximum 10 deploy-uri pe oră per hook. Un apel care sosește cât timp un build încă așteaptă se alătură acestuia.
- Revocă oprește imediat adresa; serviciile care o apelează au nevoie apoi de una nouă.
Modul mentenanță
Setări → Mod mentenanță → Afișează pagina de mentenanță. Vizitatorii văd, în locul aplicației, o pagină scurtă cu mesajul tău; lasă mesajul gol ca să afișezi „Facem câteva îmbunătățiri. Revino puțin mai târziu.”
Aplicația în sine rulează în continuare, așa că poți verifica totul înainte s-o deschizi din nou. Un link privat pentru tine afișează aplicația normal, timp de 12 ore, pe dispozitivul care îl deschide. Link nou creează unul nou; linkul vechi nu mai funcționează.
Oprește comutatorul ca să deschizi din nou aplicația pentru vizitatori.
Notificări despre deploy-uri
Îți scriem pe e-mail (și pe Telegram, dacă l-ai conectat) când un deploy nu se finalizează. Ca să trimiți evenimentele și echipei tale — o versiune nouă a ajuns live, un deploy nu s-a finalizat, un serviciu s-a oprit sau a revenit, consum mare de memorie sau procesor, un backup sau discul unei baze de date —, adaugă Slack, Discord sau propriul webhook în Setări → Notificări pentru echipă. Mesajele webhook sunt JSON semnat cu un secret afișat o singură dată, în headerul X-Rivervo-Signature.