Deploys, previews en terugdraaien.
Hoe pushes live gaan, previews per branch, teruggaan naar een eerdere versie, de releaseopdracht voor migraties, buildinstellingen, deploy-hooks, onderhoudsmodus en wachtwoorden voor previews.
Staat een applicatie eenmaal live, dan heb je het paneel zelden nodig om wijzigingen uit te rollen: push naar de branch en de nieuwe versie gaat vanzelf live. Dit artikel gaat over alles daaromheen — het tabblad Deploys, Previews, het tabblad Processen en een paar schakelaars in Instellingen.
Automatisch deployen bij elke push
Elke push naar de branch van de applicatie bouwt de nieuwste commit en zet die live. De nieuwe versie start naast de draaiende versie en krijgt pas bezoekers als ze antwoordt; start ze niet, dan blijft de vorige versie draaien en laten we het je weten per e-mail (en via Telegram, als je dat hebt gekoppeld).
Een push die binnenkomt terwijl er nog een andere build in de wachtrij staat, sluit bij die build aan, zodat een reeks pushes geen lange wachtrij oplevert.
Je kunt dit uitzetten via Instellingen → Bij elke push deployen. Staat het uit, dan deploy je via het paneel, de API of een deploy-hook.
Deployen vanuit het paneel
Het tabblad Deploys toont elke deploy: waardoor die is gestart (een push, het paneel, terugdraaien, een deploy-hook), de commit, hoe lang het duurde en de status. Klik op een deploy om het volledige buildlog te zien.
Opnieuw deployen biedt twee keuzes:
- Nieuwste commit bouwen — haalt de nieuwste code uit de branch en bouwt die.
- Draaiende versie opnieuw deployen — past gewijzigde variabelen toe, zonder nieuwe build. Gebruik dit nadat je Variabelen hebt aangepast.
Het menu naast Openen bevat dezelfde twee acties plus Herstarten.
Terugdraaien
Je kunt terug naar elk van de laatste 5 geslaagde versies. Klik op het tabblad Deploys op Terugdraaien bij de versie die je wilt en bevestig. De eerdere versie start naast de huidige en neemt het over zodra ze antwoordt — er is geen nieuwe build.
Terugdraaien maakt databasewijzigingen niet ongedaan. Heeft een release de structuur van de database veranderd, zet dan ook de database terug — zie Databases.
Previews voor branches
Een push naar elke andere branch krijgt een eigen preview — een apart adres waar je de wijzigingen kunt bekijken voordat ze live gaan. Je opent ze op het tabblad Previews.
- Maximaal 3 previews tegelijk, inbegrepen in je prijs.
- Een preview zonder nieuwe pushes gedurende 7 dagen wordt verwijderd. Bij de volgende push naar die branch wordt hij opnieuw gemaakt.
- Previews krijgen alleen de variabelen die voor hen bedoeld zijn — zie Omgevingsvariabelen.
- Previews worden gemaakt voor de hoofddienst van een project, niet voor de andere diensten.
Een wachtwoord voor previews
Op het tabblad Previews: Wachtwoord voor previews → Wachtwoord vragen. Vul een gebruikersnaam en een wachtwoord in (minimaal 8 tekens). Vanaf dan kunnen alleen mensen met het wachtwoord de previews openen; de applicatie zelf blijft voor iedereen open.
De releaseopdracht (migraties)
Tabblad Processen → Releaseopdracht. Die draait één keer bij elke deploy, voordat de nieuwe versie bezoekers krijgt — meestal voor databasemigraties. Mislukt die, dan stopt de deploy en blijft de huidige versie draaien, zodat een kapotte migratie nooit bij je bezoekers terechtkomt.
Voor frameworks die er een hebben, stellen we een opdracht voor:
| Framework | Aanbevolen releaseopdracht |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Aanbevolen opdracht gebruiken houdt die aan; je kunt ook je eigen opdracht invullen of Geen kiezen. Wijzigingen gelden vanaf de volgende deploy.
Build-instellingen
Via Instellingen → Build-instellingen pas je aan wat we hebben gedetecteerd:
- Installatieopdracht — bijv.
npm ci - Buildopdracht — bijv.
npm run build - Startopdracht — de opdracht die je applicatie start. Die moet luisteren op de poort in
$PORT. - Outputmap — voor statische sites de map met de gebouwde bestanden.
- Projectmap — voor een repository met meerdere projecten.
Laat een veld leeg om te gebruiken wat we hebben gedetecteerd. De volgende deploy wordt met de nieuwe instellingen gebouwd; Nu bouwen start die meteen.
In Instellingen staat ook de Branch die wordt gedeployd.
Deploy-hooks
Instellingen → Deploy-hooks → Hook aanmaken. Een deploy-hook is een privéadres: stuurt een andere dienst er een POST-verzoek naartoe, dan wordt de nieuwste commit van je branch gebouwd en live gezet. Een typisch voorbeeld is een CMS dat de site opnieuw bouwt nadat je iets publiceert.
curl -X POST "<the hook address from the panel>"- Het adres wordt één keer getoond — kopieer het als je de hook aanmaakt. Iedereen die het heeft, kan een deploy starten, dus houd het geheim.
- Maximaal 10 deploys per uur per hook. Een aanroep die binnenkomt terwijl er nog een build wacht, sluit daarbij aan.
- Intrekken zet het adres meteen buiten werking; diensten die het aanroepen, hebben dan een nieuw adres nodig.
Onderhoudsmodus
Instellingen → Onderhoudsmodus → Onderhoudspagina tonen. Bezoekers zien dan een korte pagina met je bericht in plaats van de applicatie; laat het bericht leeg om «We voeren een paar verbeteringen door. Kom over een poosje terug.» te tonen.
De applicatie zelf blijft draaien, zodat je alles kunt controleren voordat je haar weer openzet. Een privélink voor jou toont de applicatie gewoon op het apparaat dat de link opent, 12 uur lang. Nieuwe link maakt een verse link; de oude werkt dan niet meer.
Zet de schakelaar uit om de applicatie weer open te stellen voor bezoekers.
Meldingen over deploys
We mailen je (en sturen een Telegram-bericht, als je dat hebt gekoppeld) wanneer een deploy niet afrondt. Wil je ook je team op de hoogte houden — een nieuwe versie is live, een deploy is niet afgerond, een dienst is gestopt of weer actief, hoog geheugen- of processorgebruik, een back-up of een databaseschijf — voeg dan Slack, Discord of je eigen webhook toe via Instellingen → Meldingen naar je team. Webhookberichten zijn JSON, ondertekend met een geheime sleutel die één keer wordt getoond, in de header X-Rivervo-Signature.