Anleitungen

Bei jedem Push ausrollen

Jeder Push auf den überwachten Branch rollt die App automatisch neu aus, von GitHub oder jedem anderen verbundenen Git-Repo, ohne Pipeline, die Sie pflegen müssen.

Schalten Sie Auto-Deploy ein, dann baut jeder Push auf den überwachten Branch die App aus dem neuen Commit und rollt sie aus. Jeder Deploy steht in der Betriebsakte. Sie schreiben keine Pipeline, halten keinen Runner am Laufen und müssen keinen Deploy-Key rotieren.

Auto-Deploy einschalten

Auto-Deploy stellen Sie pro App in der Console ein. Ein CLI-Flag oder MCP-Tool dafür gibt es nicht.

Repo einmal verbinden. Bei GitHub ist das die nyxory GitHub App. Bei anderen Git-Hosts ist es eine HTTPS-Git-Verbindung, bei einem verbundenen Gerrit das Lesekonto des Projekts.
App einmal aus diesem Repo ausrollen. Die Console übernimmt aus diesem Deploy den Bauplan der App. Danach erscheint an der App der Bereich Auto-deploy.
Redeploy on push einschalten.
Zu überwachenden Branch wählen, also main, einen staging-Branch oder den Branch, der zu dieser Umgebung gehört. Bleibt das Feld leer, überwacht nyxory main und nicht den Standard-Branch Ihres Repositorys. Heißt Ihrer master oder anders, tragen Sie ihn deshalb ausdrücklich ein.

Mehr ist nicht einzurichten.

Was bei einem Push passiert

Ein fehlerhafter Push legt die laufende App nie lahm. Beheben Sie den Fehler und pushen Sie erneut. Der nächste Commit nimmt denselben Weg.

Bei GitHub benachrichtigt der Push nyxory sofort. Repos auf anderen Hosts werden etwa einmal pro Minute abgefragt. Jeden Deploy verfolgen Sie in der Console, wo der Bereich „building“, „deploying“, „deployed“ oder „action required“ zeigt, oder über Ihren Agenten mit nyx_build_status.

Auf einer dedizierten Instanz wird beim selben Push auch ein Ordner deploy/ im Repo angewendet. Die Manifeste darin werden zur Konfiguration der App, eine Postgres-Datenbank eingeschlossen und, wo die Instanz Objektspeicher hat, ein Bucket. Die Console zeigt den Commit, aus dem die Konfiguration stammt. Verstößt der Ordner gegen eine Regel, wird er abgelehnt, bevor irgendetwas geschrieben wird, und die laufende Version bleibt in Betrieb. Siehe App aus dem Repo konfigurieren.

Gut zu wissen

Cronjobs sind eingeschlossen. Ein Push rollt das neue Image auch in die Cronjobs der App aus, und der nächste geplante Lauf verwendet es. Siehe Jobs und Cronjobs.
Wiederherstellungen schalten Auto-Deploy ab. Eine Wiederherstellung vom Typ app oder full schaltet Auto-Deploy aus, damit kein Push dem Rollback in die Quere kommt. Es bleibt aus, bis Sie Redeploy on push wieder einschalten.
Ein Branch, eine Umgebung. Richten Sie eine Produktions-App auf main und eine Staging-App auf staging. Jede App überwacht ihren eigenen Branch, so landet immer der richtige Commit am richtigen Ort.

Siehe auch: App aus dem Repo konfigurieren · Aus einem privaten Repo ausrollen · Laufender Betrieb