Deploys, forhåndsvisninger og tilbagerulninger.
Sådan går pushes live, forhåndsvisninger af branches, tilbagevenden til en tidligere version, release-kommandoen til migreringer, build-indstillinger, deploy-hooks, vedligeholdelsestilstand og adgangskoder til forhåndsvisninger.
Når en applikation først er live, har du sjældent brug for panelet for at udgive ændringer: push til branchen, så går den nye version live af sig selv. Denne artikel dækker alt omkring det — fanen Deploys, Forhåndsvisninger, fanen Processer og nogle få kontakter under Indstillinger.
Automatiske deploys ved hvert push
Hvert push til applikationens branch bygger det seneste commit og deployer det. Den nye version starter ved siden af den kørende og modtager først besøgende, når den svarer; hvis den ikke starter, kører den tidligere version videre, og vi giver dig besked på e-mail (og Telegram, hvis du har tilknyttet det).
Et push, der laves, mens et andet build stadig venter i køen, slås sammen med det build, så en række pushes ikke skaber en lang kø.
Du kan slå det fra under Indstillinger → Deploy ved hvert push. Når det er slået fra, deployer du fra panelet, API'et eller en deploy-hook.
Deploy fra panelet
Fanen Deploys viser alle deploys: hvad der startede dem (et push, panelet, en tilbagerulning, en deploy-hook), commit, varighed og status. Klik på et deploy for at se hele build-loggen.
Deploy igen giver to valg:
- Byg det seneste commit — henter den nyeste kode fra branchen og bygger den.
- Deploy den kørende version igen — anvender ændrede variabler uden et nyt build. Brug det, efter du har redigeret Variabler.
Menuen ved siden af Åbn har de samme to handlinger plus Genstart.
Tilbagerulning
Du kan gå tilbage til en hvilken som helst af de sidste 5 vellykkede versioner. På fanen Deploys klikker du på Rul tilbage ved den ønskede version og bekræfter. Den tidligere version startes ved siden af den nuværende og overtager, når den svarer — der laves ikke noget nyt build.
En tilbagerulning fortryder ikke ændringer i databasen. Hvis en udgivelse ændrede databasens struktur, skal du også gendanne databasen — se Databaser.
Forhåndsvisninger af branches
Et push til enhver anden branch får sin egen forhåndsvisning — en separat adresse, hvor du kan tjekke ændringerne, før de går live. Du åbner dem under fanen Forhåndsvisninger.
- Op til 3 forhåndsvisninger ad gangen, inkluderet i prisen.
- En forhåndsvisning uden nye pushes i 7 dage fjernes. Den laves igen ved næste push til den branch.
- Forhåndsvisninger får kun de variabler, der er beregnet til dem — se Miljøvariabler.
- Forhåndsvisninger laves for projektets hovedtjeneste, ikke for dets øvrige tjenester.
Adgangskode til forhåndsvisninger
På fanen Forhåndsvisninger: Adgangskode til forhåndsvisninger → Kræv adgangskode. Angiv et brugernavn og en adgangskode (mindst 8 tegn). Derefter kan kun personer med adgangskoden åbne forhåndsvisningerne; selve applikationen er fortsat åben for alle.
Release-kommandoen (migreringer)
Fanen Processer → Release-kommando. Den køres én gang ved hvert deploy, før den nye version modtager besøgende — typisk databasemigreringer. Hvis den fejler, stopper deployet, og den nuværende version kører videre, så en fejlslagen migrering aldrig når dine besøgende.
Vi foreslår en kommando for de frameworks, der har en:
| Framework | Anbefalet release-kommando |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Brug den anbefalede kommando beholder den; du kan også angive din egen eller vælge Ingen. Ændringer gælder fra næste deploy.
Build-indstillinger
Under Indstillinger → Build-indstillinger kan du ændre det, vi har registreret:
- Installationskommando — f.eks.
npm ci - Build-kommando — f.eks.
npm run build - Startkommando — kommandoen, der starter din applikation. Den skal lytte på porten i
$PORT. - Output-mappe — for statiske sider: mappen med de byggede filer.
- Projektmappe — for et repository med flere projekter.
Lad et felt stå tomt for at bruge det, vi har registreret. Næste deploy bygges med de nye indstillinger; Byg nu starter det med det samme.
Under Indstillinger finder du også den Branch, der deployes.
Deploy-hooks
Indstillinger → Deploy-hooks → Opret en hook. En deploy-hook er en privat adresse: når en anden tjeneste sender en POST-forespørgsel til den, bliver det seneste commit på din branch bygget og deployet. Et typisk eksempel er et CMS, der genopbygger siden, når du udgiver.
curl -X POST "<hook-adressen fra panelet>"- Adressen vises én gang — kopiér den, når du opretter hooken. Alle, der har den, kan starte et deploy, så hold den privat.
- Op til 10 deploys i timen pr. hook. Et kald, der kommer, mens et build stadig venter, slås sammen med det.
- Tilbagekald stopper adressen med det samme; tjenester, der kalder den, skal så have en ny.
Vedligeholdelsestilstand
Indstillinger → Vedligeholdelsestilstand → Vis vedligeholdelsessiden. Besøgende ser en kort side med din besked i stedet for applikationen; lad beskeden stå tom for at vise «Vi laver et par forbedringer. Kig forbi igen om lidt.»
Selve applikationen kører videre, så du kan tjekke alt, før du åbner den igen. Et privat link til dig viser applikationen som normalt på den enhed, der åbner linket, i 12 timer. Nyt link laver et nyt; det gamle link holder op med at virke.
Slå kontakten fra for at åbne applikationen for besøgende igen.
Notifikationer om deploys
Vi sender dig en e-mail (og en Telegram-besked, hvis du har tilknyttet det), når et deploy ikke bliver færdigt. Vil du også sende hændelser til dit team — en ny version gik live, et deploy blev ikke færdigt, en tjeneste stoppede eller kom tilbage, højt forbrug af hukommelse eller processor, en backup eller en databasedisk — så tilføj Slack, Discord eller din egen webhook under Indstillinger → Notifikationer til dit team. Webhook-beskeder er JSON signeret med en hemmelighed, der vises én gang, i headeren X-Rivervo-Signature.