Deploy, anteprime e rollback.
Come i push vanno online, le anteprime dei branch, il ritorno a una versione precedente, il comando di rilascio per le migrazioni, le impostazioni di build, i deploy hook, la modalità manutenzione e le password delle anteprime.
Una volta che l'applicazione è online, il pannello ti serve raramente per pubblicare modifiche: fai push sul branch e la nuova versione va online da sola. Questo articolo spiega tutto ciò che c'è intorno — la scheda Deploy, le Anteprime, la scheda Processi e alcuni interruttori in Impostazioni.
Deploy automatici a ogni push
Ogni push sul branch dell'applicazione compila l'ultimo commit e lo pubblica. La nuova versione si avvia accanto a quella in esecuzione e riceve visitatori solo quando risponde; se non si avvia, la versione precedente resta in esecuzione e ti avvisiamo via email (e su Telegram, se l'hai collegato).
Un push fatto mentre un'altra build è ancora in coda si unisce a quella build, così una raffica di push non crea una lunga coda.
Puoi disattivare questa funzione in Impostazioni → Deploy a ogni push. Se è disattivata, pubblichi dal pannello, dall'API o con un deploy hook.
Deploy dal pannello
La scheda Deploy elenca tutti i deploy: cosa li ha avviati (un push, il pannello, un rollback, un deploy hook), il commit, quanto sono durati e il loro stato. Fai clic su un deploy per vederne il log di build completo.
Ripubblica offre due scelte:
- Compila l'ultimo commit — prende il codice più recente dal branch e lo compila.
- Ripubblica la versione in esecuzione — applica le variabili modificate, senza una nuova build. Usala dopo aver modificato le Variabili.
Il menu accanto ad Apri ha le stesse due azioni più Riavvia.
Tornare a una versione precedente
Puoi tornare a una qualsiasi delle ultime 5 versioni riuscite. Nella scheda Deploy, fai clic su Ripristina sulla versione che vuoi e conferma. La versione precedente viene avviata accanto a quella attuale e subentra quando risponde — non c'è una nuova build.
Un rollback non annulla le modifiche al database. Se un rilascio ha cambiato la struttura del database, ripristina anche il database — vedi Database.
Anteprime per i branch
Un push su qualsiasi altro branch riceve una propria anteprima — un indirizzo separato dove puoi controllare le modifiche prima che vadano online. Le trovi nella scheda Anteprime.
- Fino a 3 anteprime alla volta, incluse nel prezzo.
- Un'anteprima senza nuovi push per 7 giorni viene rimossa. Viene ricreata al push successivo su quel branch.
- Le anteprime ricevono solo le variabili destinate a loro — vedi Variabili d'ambiente.
- Le anteprime vengono create per il servizio principale di un progetto, non per gli altri servizi.
Una password per le anteprime
Nella scheda Anteprime, Password per le anteprime → Chiedi una password. Inserisci un nome utente e una password (almeno 8 caratteri). Da quel momento solo chi ha la password può aprire le anteprime; l'applicazione vera e propria resta aperta a tutti.
Il comando di rilascio (migrazioni)
Scheda Processi → Comando di rilascio. Viene eseguito una volta a ogni deploy, prima che la nuova versione riceva visitatori — di solito per le migrazioni del database. Se fallisce, il deploy si ferma e la versione attuale resta in esecuzione, così una migrazione difettosa non arriva mai ai tuoi visitatori.
Suggeriamo un comando per i framework che ne hanno uno:
| Framework | Comando di rilascio consigliato |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Usa il comando consigliato lo mantiene; puoi anche inserire un comando tuo o scegliere Nessuno. Le modifiche valgono dal deploy successivo.
Impostazioni di build
Impostazioni → Impostazioni di build ti permette di cambiare ciò che abbiamo rilevato:
- Comando di installazione — ad esempio
npm ci - Comando di build — ad esempio
npm run build - Comando di avvio — il comando che avvia la tua applicazione. Deve restare in ascolto sulla porta indicata in
$PORT. - Cartella di output — per i siti statici, la cartella con i file compilati.
- Cartella del progetto — per un repository con più progetti.
Lascia un campo vuoto per usare ciò che abbiamo rilevato. Il deploy successivo viene compilato con le nuove impostazioni; Compila ora lo avvia subito.
In Impostazioni trovi anche il Branch che viene pubblicato.
Deploy hook
Impostazioni → Deploy hook → Crea un hook. Un deploy hook è un indirizzo privato: quando un altro servizio gli invia una richiesta POST, l'ultimo commit del tuo branch viene compilato e pubblicato. Un uso tipico è un CMS che ricompila il sito dopo una pubblicazione.
curl -X POST "<the hook address from the panel>"- L'indirizzo viene mostrato una sola volta — copialo quando crei l'hook. Chiunque lo abbia può avviare un deploy, quindi tienilo riservato.
- Fino a 10 deploy all'ora per hook. Una chiamata che arriva mentre una build è ancora in attesa si unisce a quella.
- Revoca disattiva subito l'indirizzo; i servizi che lo chiamano avranno bisogno di uno nuovo.
Modalità manutenzione
Impostazioni → Modalità manutenzione → Mostra la pagina di manutenzione. Al posto dell'applicazione i visitatori vedono una breve pagina con il tuo messaggio; lascia il messaggio vuoto per mostrare «Stiamo apportando alcuni miglioramenti. Torna a trovarci tra poco.»
L'applicazione intanto resta in esecuzione, così puoi controllare tutto prima di riaprirla. Un link privato per te mostra l'applicazione come al solito sul dispositivo che lo apre, per 12 ore. Nuovo link ne crea uno nuovo; il vecchio link smette di funzionare.
Disattiva l'interruttore per riaprire l'applicazione ai visitatori.
Notifiche sui deploy
Ti scriviamo via email (e ti mandiamo un messaggio su Telegram, se l'hai collegato) quando un deploy non va a buon fine. Per inviare gli eventi anche al tuo team — una nuova versione è online, un deploy non è andato a buon fine, un servizio si è fermato o è ripartito, uso elevato di memoria o processore, un backup o il disco di un database — aggiungi Slack, Discord o un tuo webhook in Impostazioni → Notifiche al tuo team. I messaggi webhook sono in JSON e firmati con un segreto mostrato una sola volta, nell'header X-Rivervo-Signature.