Deployments, Vorschauen und Rollbacks.
Wie Pushes live gehen, Branch-Vorschauen, Rückkehr zu einer früheren Version, der Release-Befehl für Migrationen, Build-Einstellungen, Deploy-Hooks, Wartungsmodus und Passwörter für Vorschauen.
Ist eine Anwendung erst einmal live, brauchen Sie das Panel für Änderungen nur selten: Pushen Sie auf den Branch, und die neue Version geht von selbst live. Dieser Artikel behandelt alles drumherum – den Tab Deployments, Vorschauen, den Tab Prozesse und einige Schalter in den Einstellungen.
Automatisches Deployment bei jedem Push
Jeder Push auf den Branch der Anwendung baut den neuesten Commit und deployt ihn. Die neue Version startet neben der laufenden und erhält erst dann Besucher, wenn sie antwortet; startet sie nicht, läuft die bisherige Version weiter, und wir benachrichtigen Sie per E-Mail (und per Telegram, wenn Sie es verbunden haben).
Ein Push, der eintrifft, während noch ein anderer Build in der Warteschlange steht, wird diesem Build zugeschlagen – so entsteht bei vielen Pushes hintereinander keine lange Warteschlange.
Sie können das unter Einstellungen → Jeden Push deployen ausschalten. Dann deployen Sie über das Panel, die API oder einen Deploy-Hook.
Deployment über das Panel
Der Tab Deployments listet jedes Deployment auf: was es ausgelöst hat (ein Push, das Panel, ein Rollback, ein Deploy-Hook), den Commit, die Dauer und den Status. Klicken Sie auf ein Deployment, um das vollständige Build-Log zu sehen.
Erneut deployen bietet zwei Möglichkeiten:
- Neuesten Commit bauen – holt den neuesten Code aus dem Branch und baut ihn.
- Laufende Version erneut deployen – übernimmt geänderte Variablen ohne neuen Build. Nutzen Sie das nach Änderungen unter Variablen.
Das Menü neben Öffnen enthält dieselben zwei Aktionen und zusätzlich Neu starten.
Rollback
Sie können zu jeder der letzten 5 erfolgreichen Versionen zurückkehren. Klicken Sie im Tab Deployments bei der gewünschten Version auf Zurückrollen und bestätigen Sie. Die frühere Version wird neben der aktuellen gestartet und übernimmt, sobald sie antwortet – ein neuer Build ist nicht nötig.
Ein Rollback macht Änderungen an der Datenbank nicht rückgängig. Hat ein Release die Datenbankstruktur geändert, stellen Sie auch die Datenbank wieder her – siehe Datenbanken.
Vorschauen für Branches
Ein Push auf jeden anderen Branch erhält eine eigene Vorschau – eine separate Adresse, unter der Sie die Änderungen prüfen können, bevor sie live gehen. Sie finden sie im Tab Vorschauen.
- Bis zu 3 Vorschauen gleichzeitig, im Preis enthalten.
- Eine Vorschau ohne neue Pushes seit 7 Tagen wird entfernt. Mit dem nächsten Push auf diesen Branch wird sie neu erstellt.
- Vorschauen erhalten nur die für sie vorgesehenen Variablen – siehe Umgebungsvariablen.
- Vorschauen werden für den Hauptdienst eines Projekts erstellt, nicht für seine weiteren Dienste.
Ein Passwort für Vorschauen
Im Tab Vorschauen: Passwort für Vorschauen → Passwort abfragen. Geben Sie einen Benutzernamen und ein Passwort (mindestens 8 Zeichen) ein. Ab dann können nur Personen mit dem Passwort die Vorschauen öffnen; die Anwendung selbst bleibt für alle zugänglich.
Der Release-Befehl (Migrationen)
Tab Prozesse → Release-Befehl. Er läuft bei jedem Deployment einmal, bevor die neue Version Besucher erhält – in der Regel für Datenbankmigrationen. Schlägt er fehl, wird das Deployment abgebrochen und die aktuelle Version läuft weiter, sodass eine fehlerhafte Migration Ihre Besucher nie erreicht.
Für Frameworks, die einen solchen Befehl haben, schlagen wir ihn vor:
| Framework | Empfohlener Release-Befehl |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Empfohlenen Befehl verwenden übernimmt ihn; Sie können auch einen eigenen eingeben oder Keiner wählen. Änderungen gelten ab dem nächsten Deployment.
Build-Einstellungen
Unter Einstellungen → Build-Einstellungen ändern Sie, was wir erkannt haben:
- Installationsbefehl – z. B.
npm ci - Build-Befehl – z. B.
npm run build - Startbefehl – der Befehl, der Ihre Anwendung startet. Sie muss auf dem Port in
$PORTlauschen. - Ausgabeordner – bei statischen Websites der Ordner mit den gebauten Dateien.
- Projektordner – für ein Repository mit mehreren Projekten.
Lassen Sie ein Feld leer, um den erkannten Wert zu verwenden. Das nächste Deployment wird mit den neuen Einstellungen gebaut; Jetzt bauen startet es sofort.
In den Einstellungen finden Sie außerdem den Branch, der deployt wird.
Deploy-Hooks
Einstellungen → Deploy-Hooks → Hook erstellen. Ein Deploy-Hook ist eine private Adresse: Sendet ein anderer Dienst eine POST-Anfrage daran, wird der neueste Commit Ihres Branches gebaut und deployt. Typischer Einsatz ist ein CMS, das die Website nach dem Veröffentlichen neu baut.
curl -X POST "<the hook address from the panel>"- Die Adresse wird nur einmal angezeigt – kopieren Sie sie beim Erstellen des Hooks. Wer sie kennt, kann ein Deployment starten, behandeln Sie sie also vertraulich.
- Bis zu 10 Deployments pro Stunde und Hook. Ein Aufruf, der eintrifft, während noch ein Build wartet, wird diesem zugeschlagen.
- Widerrufen deaktiviert die Adresse sofort; Dienste, die sie aufrufen, brauchen dann eine neue.
Wartungsmodus
Einstellungen → Wartungsmodus → Wartungsseite anzeigen. Besucher sehen statt der Anwendung eine kurze Seite mit Ihrer Nachricht; lassen Sie die Nachricht leer, wird „Wir nehmen gerade einige Verbesserungen vor. Bitte schauen Sie in Kürze wieder vorbei.“ angezeigt.
Die Anwendung selbst läuft weiter, sodass Sie alles prüfen können, bevor Sie sie wieder freigeben. Ein privater Link für Sie zeigt die Anwendung 12 Stunden lang wie gewohnt auf dem Gerät, das ihn öffnet. Neuer Link erstellt einen frischen; der alte Link funktioniert dann nicht mehr.
Schalten Sie den Schalter aus, um die Anwendung wieder für Besucher zu öffnen.
Benachrichtigungen zu Deployments
Wir schreiben Ihnen eine E-Mail (und eine Telegram-Nachricht, wenn Sie es verbunden haben), wenn ein Deployment nicht abgeschlossen wird. Um Ereignisse auch an Ihr Team zu senden – eine neue Version ist live, ein Deployment wurde nicht abgeschlossen, ein Dienst ist ausgefallen oder wieder da, hohe Speicher- oder CPU-Auslastung, ein Backup oder die Festplatte einer Datenbank –, fügen Sie unter Einstellungen → Benachrichtigungen an Ihr Team Slack, Discord oder Ihren eigenen Webhook hinzu. Webhook-Nachrichten sind JSON, signiert mit einem nur einmal angezeigten Secret, im Header X-Rivervo-Signature.