Utrullinger, forhåndsvisninger og tilbakerullinger.
Slik går push-er live, forhåndsvisninger av grener, tilbake til en tidligere versjon, release-kommandoen for migreringer, byggeinnstillinger, deploy-hooks, vedlikeholdsmodus og passord for forhåndsvisninger.
Når en applikasjon er live, trenger du sjelden panelet for å rulle ut endringer: push til grenen, så går den nye versjonen live av seg selv. Denne artikkelen tar for seg alt rundt dette — fanen Utrullinger, Forhåndsvisninger, fanen Prosesser og noen brytere under Innstillinger.
Automatisk utrulling ved hver push
Hver push til applikasjonens gren bygger den nyeste commiten og ruller den ut. Den nye versjonen starter ved siden av den som kjører, og får besøkende først når den svarer; hvis den ikke starter, fortsetter den forrige versjonen å kjøre, og vi gir deg beskjed på e-post (og Telegram, hvis du har koblet det til).
En push som kommer mens et annet bygg fortsatt venter i køen, slås sammen med det bygget, så mange push-er på rad gir ikke en lang kø.
Du kan slå dette av under Innstillinger → Rull ut hver push. Når det er av, ruller du ut fra panelet, API-et eller en deploy-hook.
Utrulling fra panelet
Fanen Utrullinger viser alle utrullinger: hva som startet den (en push, panelet, en tilbakerulling, en deploy-hook), commiten, hvor lang tid den tok og statusen. Klikk på en utrulling for å se hele byggeloggen.
Rull ut på nytt gir to valg:
- Bygg den nyeste commiten — henter den nyeste koden fra grenen og bygger den.
- Rull ut versjonen som kjører, på nytt — tar i bruk endrede variabler, uten et nytt bygg. Bruk dette etter at du har endret Variabler.
Menyen ved siden av Åpne har de samme to handlingene, pluss Start på nytt.
Rulle tilbake
Du kan gå tilbake til hvilken som helst av de 5 siste vellykkede versjonene. I fanen Utrullinger klikker du Rull tilbake på versjonen du vil ha, og bekrefter. Den tidligere versjonen startes ved siden av den nåværende og tar over når den svarer — det blir ikke noe nytt bygg.
En tilbakerulling angrer ikke endringer i databasen. Hvis en versjon endret databasestrukturen, må du gjenopprette databasen også — se Databaser.
Forhåndsvisninger for grener
En push til en hvilken som helst annen gren får sin egen forhåndsvisning — en egen adresse der du kan sjekke endringene før de går live. Åpne dem i fanen Forhåndsvisninger.
- Opptil 3 forhåndsvisninger om gangen, inkludert i prisen.
- En forhåndsvisning uten nye push-er på 7 dager fjernes. Den lages på nytt ved neste push til den grenen.
- Forhåndsvisninger får bare variablene som er ment for dem — se Miljøvariabler.
- Forhåndsvisninger lages for hovedtjenesten i et prosjekt, ikke for de andre tjenestene.
Passord for forhåndsvisninger
I fanen Forhåndsvisninger: Passord for forhåndsvisninger → Krev passord. Skriv inn et brukernavn og et passord (minst 8 tegn). Fra da av kan bare de som har passordet, åpne forhåndsvisningene; selve applikasjonen er fortsatt åpen for alle.
Release-kommandoen (migreringer)
Fanen Prosesser → Release-kommando. Den kjøres én gang ved hver utrulling, før den nye versjonen får besøkende — vanligvis databasemigreringer. Hvis den feiler, stopper utrullingen, og den nåværende versjonen fortsetter å kjøre, så en ødelagt migrering aldri når de besøkende.
Vi foreslår en kommando for rammeverkene som har en:
| Rammeverk | Anbefalt release-kommando |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Bruk den anbefalte kommandoen beholder den; du kan også skrive inn din egen eller velge Ingen. Endringer gjelder fra neste utrulling.
Byggeinnstillinger
Innstillinger → Byggeinnstillinger lar deg endre det vi oppdaget:
- Installeringskommando — f.eks.
npm ci - Byggekommando — f.eks.
npm run build - Startkommando — kommandoen som starter applikasjonen. Den må lytte på porten i
$PORT. - Utdatamappe — for statiske nettsider, mappen med de ferdigbygde filene.
- Prosjektmappe — for et repository med flere prosjekter.
La et felt stå tomt for å bruke det vi oppdaget. Neste utrulling bygges med de nye innstillingene; Bygg nå starter den med en gang.
Under Innstillinger finner du også Gren som rulles ut.
Deploy-hooks
Innstillinger → Deploy-hooks → Opprett en hook. En deploy-hook er en privat adresse: når en annen tjeneste sender en POST-forespørsel til den, bygges og rulles den nyeste commiten på grenen din ut. Et typisk eksempel er et CMS som bygger nettsiden på nytt etter at du har publisert.
curl -X POST "<hook-adressen fra panelet>"- Adressen vises én gang — kopier den når du oppretter hooken. Alle som har den, kan starte en utrulling, så hold den privat.
- Opptil 10 utrullinger i timen per hook. Et kall som kommer mens et bygg fortsatt venter, slås sammen med det.
- Tilbakekall stopper adressen med en gang; tjenester som kaller den, trenger da en ny.
Vedlikeholdsmodus
Innstillinger → Vedlikeholdsmodus → Vis vedlikeholdssiden. Besøkende ser en kort side med meldingen din i stedet for applikasjonen; la meldingen stå tom for å vise «Vi gjør noen forbedringer. Prøv igjen om en liten stund.»
Selve applikasjonen fortsetter å kjøre, så du kan sjekke alt før du åpner den igjen. En privat lenke for deg viser applikasjonen som vanlig på enheten som åpner den, i 12 timer. Ny lenke lager en ny; den gamle lenken slutter å virke.
Slå av bryteren for å åpne applikasjonen for besøkende igjen.
Varsler om utrullinger
Vi sender deg en e-post (og en Telegram-melding, hvis du har koblet det til) når en utrulling ikke fullføres. For å sende hendelser til teamet ditt også — en ny versjon gikk live, en utrulling ble ikke fullført, en tjeneste stoppet eller kom tilbake, høyt minne- eller prosessorbruk, en sikkerhetskopi eller disken til en database — legger du til Slack, Discord eller din egen webhook under Innstillinger → Varsler til teamet ditt. Webhook-meldinger er JSON signert med en hemmelighet som vises én gang, i headeren X-Rivervo-Signature.