Rezepte und Apps
Dauerhaft betreiben
Behältst du einen Test, kümmert sich Setup um die App: Health-Checks, E-Mails bei Ausfällen, Updates zum Zurückrollen, Sicherungen und eine Statusseite.
Auf dieser Seite
Ein Test entfernt sich nach einer Stunde von selbst. Eine App, die du behältst, läuft dagegen, bis du sie entfernst, und Setup kümmert sich um sie: Es prüft, ob die App antwortet, schreibt dir, wenn sie ausfällt, und kann sie nach Plan aktualisieren und ihre Daten sichern.
Die Prüfungen, E-Mails und täglichen Sicherungen laufen ohne dein Zutun. Automatische Updates sind aus, bis du sie im Tab Einstellungen der App einschaltest.
Einen Test behalten
Klick vor dem Ende des Tests auf der Seite der App auf Behalten. In der einfachen Ansicht findest du Behalten unter Diese App behalten. Du kannst auch dem Assistenten „behalte sie“ sagen oder den Button in der E-Mail nutzen, die Setup zehn Minuten vor dem Ende eines Tests schickt.
Willst du den Test überspringen, wähl vor dem Start Dauerhaft betreiben (Detailansicht) oder Behalten (einfache Ansicht).
Hinweis. Ist ein Test vorbei, sind die App und ihre Daten weg. Starte sie dann neu aus dem Katalog oder füg den Link noch einmal ein.
Updates
Ein Update bringt eine App auf eine neuere Revision ihres Rezepts. Setup startet sie mit dem neuen Rezept neu und behält ihre Daten, ihre Einstellungen und ihre Adresse.
Woher neue Revisionen kommen
Eine neue Revision entsteht, wenn sich das Rezept im Katalog ändert, wenn jemand das Projekt neu analysiert oder sein Rezept bearbeitet, oder wenn ein behaltenes GitHub- oder GitLab-Projekt außerhalb des Katalogs ein neues Release hat (ohne Releases: einen neuen Commit). Setup sucht höchstens einmal am Tag nach solchen Releases. Ein Rezept, das jemand von Hand bearbeitet hat, ersetzt es nie.
Updates von Hand
Liegt eine neue Revision bereit, steht das auf der Seite der App. Update ansehen zeigt, was sich ändert, Dienst für Dienst und mit verborgenen geheimen Werten. Auf Revision 3 aktualisieren (mit der Nummer der neuen Revision) spielt sie ein. In der einfachen Ansicht macht Aktualisieren dasselbe, ohne die Details.
Automatische Updates
Schalte im Tab Einstellungen der App Automatische Updates ein. Dann spielt Setup neue Revisionen selbst ein, solange die App läuft und gerade kein anderer Job an ihr arbeitet. Braucht eine Revision neue Einstellungen, wartet sie auf dich. Das steht dann in der Aktivität der App.
Rückweg bei Fehlern
Besteht eine aktualisierte App ihre Prüfungen nicht, kehrt Setup von selbst zur vorherigen Revision zurück. Automatische Updates überspringen die fehlerhafte Revision dann, bis eine neuere erscheint. Du kannst sie trotzdem selbst noch einmal versuchen, mit Revision 3 noch mal versuchen.
Sicherungen und Wiederherstellen
Eine Sicherung ist eine Kopie von allem, was die App speichert. Damit die Kopie stimmig ist, stoppt der Runner die Dienste der App, archiviert die Daten und startet sie wieder. Die App ist also für diesen Moment offline.
- Jetzt sichern. Im Tab Sicherungen, in der einfachen Ansicht unter Jetzt sichern oder über den Assistenten.
- Regelmäßig sichern. Eine App, die du behältst, wird von Anfang an Täglich gesichert: Behältst du einen Test oder startest du eine App gleich dauerhaft, schaltet sich der Zeitplan ein. Im Tab Einstellungen kannst du die Automatische Sicherung auf Wöchentlich oder Aus stellen.
- Aufbewahrte Sicherungen. Nach jeder neuen Sicherung löscht Setup die ältesten, die über diese Zahl hinausgehen. Standard sind 7, bei wöchentlicher Sicherung 4. Der Tab Einstellungen bietet 3, 7, 14 oder 30 an, über die API sind bis zu 90 möglich.
- Wiederherstellen. Wiederherstellen neben einer Sicherung im Tab Sicherungen, oder du bittest den Assistenten. Setup stoppt die App, ersetzt ihre Daten durch diese Sicherung, startet sie wieder und prüft sie. Alles, was sich seit der Sicherung geändert hat, geht verloren.
Sicherungen liegen auf dem Runner, auf dem die App läuft: auf deinem eigenen Rechner, wenn du einen angeschlossen hast, sonst auf Setup Cloud. Schlägt eine Sicherung fehl, läuft die App weiter, frühere Sicherungen bleiben unberührt, und Setup schreibt dir.
Hinweis. Entfernst du eine App, bleiben ihre Sicherungsarchive derzeit auf der Festplatte des Runners liegen. Setup kann sie danach aber nicht mehr wiederherstellen. Auf einem eigenen Runner liegen sie im Ordner
backupsim Datenverzeichnis des Runners.
Health-Checks und Neustarts
Solange eine behaltene App läuft, prüft ihr Runner sie etwa alle 30 Sekunden: Laufen alle Dienste, und antwortet die Webseite auf die Prüfung aus dem Rezept? Der Tab Zustand zeigt Verfügbarkeit, Antwortzeiten, Arbeitsspeicher und CPU.
Behaltene Apps laufen mit der Docker-Neustartregel unless-stopped. Stürzt ein Dienst ab, startet er also von selbst wieder. Ist die App nach 5 Minuten immer noch nicht erreichbar, legt Setup einen Ausfall an und schreibt dir. Es prüft weiter und schreibt noch einmal, sobald die App eine Minute lang wieder läuft. Geplante Pausen wie ein Stopp, ein Update oder eine Sicherung zählen nie als Ausfall.
Von sich aus baut Setup eine App nicht neu auf. Dafür klickst du auf Neu starten (einfache Ansicht) oder ganz unten im Tab Einstellungen auf Neu deployen (Detailansicht), oder du bittest den Assistenten, sie neu zu starten. Ihre Daten bleiben erhalten.
E-Mail-Benachrichtigungen
Setup schreibt allen, die sich um eine behaltene App kümmern. Für eine App namens Immich lauten die Betreffzeilen so:
| Wann | |
|---|---|
| „Fehler bei Immich“ | Ein Job der App ist mit einem Fehler abgebrochen |
| „Immich ist ausgefallen“ | Die App ist seit mehr als 5 Minuten nicht erreichbar |
| „Immich läuft wieder“ | Sie läuft seit einer Minute wieder |
| „Sicherung von Immich fehlgeschlagen“ | Eine Sicherung hat nicht geklappt |
| „Immich wurde aktualisiert“ | Ein automatisches Update wurde eingespielt |
| „Update von Immich zurückgenommen“ | Ein Update hat seine Prüfungen nicht bestanden, Setup ist zurückgekehrt |
| „Dein Test von Immich endet in 10 Minuten“ | Für Tests, bevor sie entfernt werden |
Jedes Problem meldet Setup einmal, nicht jede Minute, die es andauert. Für Apps in deinem persönlichen Workspace gehen die E-Mails an dich. Für Apps in einem Team-Workspace gehen sie an die Inhaber und Admins des Teams und an das Mitglied, das die App gestartet hat. Die E-Mails kommen in der Sprache, die du für die Oberfläche gewählt hast.
Welche E-Mails du bekommst, legst du in Mein Konto (/dashboard/account) im Bereich E-Mail-Benachrichtigungen fest: Fehler und Ausfälle, Fehlgeschlagene Sicherungen, Updates und Ablaufende Tests. Diese Schalter gelten für alle deine Apps.
Öffentliche Statusseiten
Eine Statusseite ist eine öffentliche Seite, die jeder mit dem Link öffnen kann. Sie zeigt den Namen der App, ihren aktuellen Zustand („In Betrieb“, „Ausgefallen“, „Wird aktualisiert“ und so weiter), die Verfügbarkeit pro Tag in den letzten 90 Tagen und den letzten Ausfall.
Schalte sie im Tab Einstellungen der App mit Öffentliche Statusseite ein und kopier den Link. Statusseiten gibt es nur für behaltene Apps. Sie zeigen nie deinen Workspace, den Runner, Logs oder Fehlermeldungen. Die Adresse der App selbst erscheint nur, wenn du zusätzlich Adresse zeigen einschaltest. Lass das bei privaten Apps aus.
Der Link sieht so aus: /status/immich-x7k2qa, also der Kurzname der App und sechs zufällige Zeichen.
Wie die Verfügbarkeit berechnet wird
Verfügbarkeit ist der Anteil der Prüfungen, bei denen die App lief. Der Tab Zustand zeigt die letzten 24 Stunden, die letzten 7 Tage und einen Balken pro Tag für die letzten 30 Tage. Statusseiten zeigen 90 Tage. Zeit ohne Prüfungen, weil der Runner offline war oder du die App gestoppt hast, zählt als „Keine Daten“, nicht als Ausfall.