Driftsättningar, förhandsversioner och återställningar.
Så går pushar live, förhandsversioner av grenar, återgång till en tidigare version, release-kommandot för migreringar, bygginställningar, deploy-hooks, underhållsläge och lösenord för förhandsversioner.
När en applikation väl är live behöver du sällan panelen för att skicka ut ändringar: pusha till grenen så går den nya versionen live av sig själv. Den här artikeln handlar om allt runt omkring – fliken Driftsättningar, Förhandsversioner, fliken Processer och några reglage under Inställningar.
Automatisk driftsättning vid varje push
Varje push till applikationens gren bygger den senaste committen och driftsätter den. Den nya versionen startar bredvid den som körs och tar emot besökare först när den svarar. Om den inte startar fortsätter den tidigare versionen att köra, och vi meddelar dig via e-post (och Telegram, om du har kopplat det).
En push som görs medan ett annat bygge fortfarande väntar i kön slås ihop med det bygget, så att många pushar i rad inte skapar en lång kö.
Du kan stänga av detta under Inställningar → Driftsätt varje push. När det är avstängt driftsätter du från panelen, API:et eller en deploy-hook.
Driftsätta från panelen
Fliken Driftsättningar listar varje driftsättning: vad som startade den (en push, panelen, en återställning, en deploy-hook), committen, hur lång tid den tog och dess status. Klicka på en driftsättning för att se hela byggloggen.
Driftsätt igen ger två val:
- Bygg den senaste committen – hämtar den nyaste koden från grenen och bygger den.
- Driftsätt den körande versionen igen – tillämpar ändrade variabler utan ett nytt bygge. Använd det efter att du har ändrat Variabler.
Menyn bredvid Öppna har samma två åtgärder samt Starta om.
Gå tillbaka till en tidigare version
Du kan gå tillbaka till någon av de 5 senaste lyckade versionerna. Under fliken Driftsättningar klickar du på Återställ vid den version du vill ha och bekräftar. Den tidigare versionen startas bredvid den nuvarande och tar över när den svarar – inget nytt bygge görs.
En återställning ångrar inte ändringar i databasen. Om en release ändrade databasens struktur behöver du återställa databasen också – se Databaser.
Förhandsversioner för grenar
En push till vilken annan gren som helst får en egen förhandsversion – en separat adress där du kan kontrollera ändringarna innan de går live. Öppna dem under fliken Förhandsversioner.
- Upp till 3 förhandsversioner samtidigt, ingår i priset.
- En förhandsversion utan nya pushar på 7 dagar tas bort. Den skapas igen vid nästa push till grenen.
- Förhandsversioner får bara de variabler som är avsedda för dem – se Miljövariabler.
- Förhandsversioner skapas för projektets huvudtjänst, inte för dess övriga tjänster.
Lösenord för förhandsversioner
Under fliken Förhandsversioner, Lösenord för förhandsversioner → Kräv lösenord. Ange ett användarnamn och ett lösenord (minst 8 tecken). Därefter kan bara de som har lösenordet öppna förhandsversionerna. Själva applikationen är fortfarande öppen för alla.
Release-kommandot (migreringar)
Fliken Processer → Release-kommando. Det körs en gång vid varje driftsättning, innan den nya versionen tar emot besökare – oftast databasmigreringar. Om det misslyckas stoppas driftsättningen och den nuvarande versionen fortsätter att köra, så en trasig migrering når aldrig dina besökare.
Vi föreslår ett kommando för de ramverk som har ett:
| Ramverk | Rekommenderat release-kommando |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Använd det rekommenderade kommandot behåller det. Du kan också ange ett eget eller välja Inget. Ändringar gäller från nästa driftsättning.
Bygginställningar
Inställningar → Bygginställningar låter dig ändra det vi har identifierat:
- Installationskommando – t.ex.
npm ci - Byggkommando – t.ex.
npm run build - Startkommando – kommandot som startar din applikation. Det måste lyssna på porten i
$PORT. - Utdatamapp – för statiska webbplatser, mappen med de byggda filerna.
- Projektmapp – för ett repository med flera projekt.
Lämna ett fält tomt för att använda det vi har identifierat. Nästa driftsättning byggs med de nya inställningarna. Bygg nu startar den direkt.
Under Inställningar finns också Gren, den gren som driftsätts.
Deploy-hooks
Inställningar → Deploy-hooks → Skapa en hook. En deploy-hook är en privat adress: när en annan tjänst skickar en POST-förfrågan till den byggs och driftsätts den senaste committen i din gren. Ett vanligt användningsfall är ett CMS som bygger om webbplatsen efter att du har publicerat.
curl -X POST "<hook-adressen från panelen>"- Adressen visas en gång – kopiera den när du skapar hooken. Den som har adressen kan starta en driftsättning, så håll den hemlig.
- Upp till 10 driftsättningar per timme och hook. Ett anrop som kommer medan ett bygge fortfarande väntar slås ihop med det.
- Återkalla stoppar adressen direkt. Tjänster som anropar den behöver då en ny.
Underhållsläge
Inställningar → Underhållsläge → Visa underhållssidan. Besökarna ser en kort sida med ditt meddelande i stället för applikationen. Lämnar du meddelandet tomt visas «Vi gör några förbättringar. Titta in igen om en liten stund.»
Själva applikationen fortsätter att köra, så att du kan kontrollera allt innan du öppnar den igen. En privat länk för dig visar applikationen som vanligt på den enhet som öppnar den, i 12 timmar. Ny länk skapar en ny, och den gamla länken slutar fungera.
Stäng av reglaget för att öppna applikationen för besökare igen.
Aviseringar om driftsättningar
Vi mejlar dig (och skickar ett Telegram-meddelande, om du har kopplat det) när en driftsättning inte blir klar. För att även skicka händelser till ditt team – en ny version gick live, en driftsättning blev inte klar, en tjänst stoppades eller kom tillbaka, hög minnes- eller processoranvändning, en backup eller en databasdisk – lägger du till Slack, Discord eller din egen webhook under Inställningar → Aviseringar till ditt team. Webhook-meddelanden är JSON som signeras med en hemlighet som visas en gång, i headern X-Rivervo-Signature.