Zero-Downtime-Deployment: Blue-Green, Rolling und atomarer Wechsel

Situationen, die beim Release zu 502-Fehlern führen können, Blue-Green- und schrittweise Rollout-Optionen, Datenbankkompatibilität und Rollback-Plan.
Technische Zusammenfassung
Technologie
Nginx, PHP-FPM, OPcache, MySQL/MariaDB, Kubernetes, HAProxy
Thema
Strategien für unterbrechungsfreie Releases und Rollback
Niveau
Mittel bis fortgeschritten
Voraussetzungen
  • Erfahrung in der Verwaltung von Linux- und Webservern
  • Grundbegriffe von CI/CD
  • Kenntnisse zu Änderungen am Datenbankschema
In diesem Beitrag7 Abschnitte

Die Beschwerde „Bei jedem Release bekommen wir ein paar Sekunden 502“ ist in vielen Teams akzeptierte Routine. Dabei bestehen diese wenigen Sekunden aus klar benennbaren, behebbaren Lücken: Neustart von Prozessen, halb ins Live-Verzeichnis kopierte Dateien und ein Schema, das nicht zum Code passt. In einer Webanwendung schließen Sie diese Lücken, indem Sie die richtige Wechselstrategie wählen und Datenbankänderungen getrennt vom Code planen. Im Folgenden beschreiben wir, wie wir für PHP/WordPress-, Node.js- und containerbasierte Anwendungen Blue-Green, Rolling, Canary und atomaren Versionswechsel sowie Schemaänderungen und Rollback in der Praxis umsetzen.

Woher kommt die Unterbrechung beim Release?

Schauen Sie nach dem Release ins Log, finden Sie nicht die eine Ursache; mehrere kleine Lücken überlagern sich. Lernen Sie sie einzeln kennen, bevor Sie eine Strategie wählen:

  • Neustart von Prozessen: restart stoppt und startet den Prozess; Anfragen dazwischen werden abgewiesen oder abgebrochen. Ein geordneter Wechsel mit reload (Nginx startet neue Worker und beendet die alten, wenn sie fertig sind; PHP-FPM wird mit SIGUSR2 neu geladen) schließt diese Lücke weitgehend. Der Fehler, den wir in der Praxis am häufigsten sehen, ist eine aus Gewohnheit ins Deploy-Skript geschriebene restart-Zeile.
  • Halb kopierte Dateien: Wer das Live-Verzeichnis per rsync oder FTP überschreibt, lässt einige Sekunden lang alte und neue Dateien gemischt laufen. Ist die neue Klassendatei schon da, die aufrufende Datei aber noch nicht, erhalten Sie einen Fatal Error.
  • Alter Code im Cache: PHP OPcache kann alten Bytecode weiterverwenden, wenn sich der Dateipfad nicht ändert. Umgekehrt entsteht beim Leeren des Caches eine kurze CPU-Spitze.
  • Schema-Inkompatibilität: Der neue Code erwartet die neue Spalte, die Migration ist noch nicht gelaufen (oder umgekehrt). Bei großen Tabellen kann ein sperrendes ALTER TABLE das Release minutenlang einfrieren.
  • Asset-Inkompatibilität: Ein Browser oder CDN, der altes HTML im Cache hält, fordert die auf dem Server nicht mehr vorhandene Datei app.3f2a1.js an und erhält 404.
  • Sitzungs- und Cache-Format: Schreibt die neue Version Sitzungsdaten oder Cache-Schlüssel in anderer Struktur, werden Nutzer in dem Fenster, in dem beide Versionen parallel laufen, abgemeldet.

Jeder dieser sechs Punkte erfordert eine eigene Maßnahme. Kein einzelnes Werkzeug löst alle.

Strategien im Vergleich

Die vier Ansätze unterscheiden sich in Ressourcenbedarf und Rollback-Geschwindigkeit. Die Entscheidung bestimmen drei Fragen: Wie viele Anwendungsserver haben Sie, gibt es davor einen Load Balancer, und verkraftet die Anwendung, dass zwei Versionen gleichzeitig laufen?

Strategie Funktionsweise Zusätzliche Ressourcen Rollback
Atomarer Symlink Neue Version wird in einem separaten Verzeichnis vorbereitet, der Link current wird in einem Schritt umgesetzt Keine (ein Server genügt) Sekunden; der Link wird auf das alte Verzeichnis umgesetzt
Blue-Green Zwei gleichwertige Umgebungen; der Traffic wechselt am Load Balancer komplett in die neue Umgebung Doppelte Produktionskapazität Sehr schnell; der Traffic kehrt in die alte Umgebung zurück
Rolling Server oder Container werden nacheinander aktualisiert Gering (Kapazität eines Knotens) Mittel; erneutes Rolling in umgekehrter Richtung
Canary Neue Version erhält zuerst einen kleinen Teil des Traffics, Metriken werden beobachtet Niedrig bis mittel Schnell; das Canary-Gewicht wird auf null gesetzt

Bei einer PHP-Website auf einem einzelnen Server genügt der atomare Symlink meist und ist die günstigste Lösung. Gibt es mehrere Anwendungsserver und einen Load Balancer, ist Rolling die natürliche Wahl; Rolling und Canary bedeuten aber, dass alte und neue Version eine Zeit lang gleichzeitig Traffic erhalten. Bei diesen beiden Strategien ist Abwärtskompatibilität keine Option. Sie ist Pflicht. Blue-Green minimiert das Überschneidungsfenster beider Versionen; im Gegenzug verdoppeln Sie die Umgebung, und die Frage, ob beide Umgebungen dieselbe Datenbank teilen, kommt auf den Tisch. Bewerten Sie die Optionen auf Seite des Load Balancers zusammen mit der Architektur für Lastverteilung und hochverfügbare Websites.

Die Methode, die Capistrano, Deployer und ähnliche Werkzeuge seit Jahren nutzen, ist einfach: Jede Version wird unter releases/ in ein eigenes Verzeichnis entpackt; persistente Daten (uploads, .env, Log-Verzeichnis) liegen unter shared/ und werden in jede Version eingebunden; das Document Root des Webservers zeigt immer auf den Link current.

/var/www/anwendung/
├── releases/
│   ├── 20261108-1412/
│   └── 20261110-0930/
├── shared/
│   ├── .env
│   └── storage/
└── current -> releases/20261110-0930

Entscheidend ist, dass sich der Link wirklich atomar ändert. Das Verhalten des häufig genutzten Befehls ln -sfn hängt von der Implementierung ab: Ältere GNU-coreutils-Versionen und einige andere ln-Implementierungen löschen zuerst den alten Link und legen dann den neuen an; dazwischen existiert für einen sehr kurzen Moment kein Link. Aktuelle GNU coreutils legen einen temporären Link an und verschieben ihn darüber. Verlassen Sie sich nicht auf die Version auf dem Server, sondern schreiben Sie den Wechsel explizit: Legen Sie einen temporären Link an und verschieben Sie ihn mit mv -T, das den Systemaufruf rename nutzt, darüber:

REL=/var/www/anwendung/releases/20261110-0930
cd /var/www/anwendung
ln -s "$REL" current_tmp
mv -T current_tmp current          # rename(2): Wechsel in einem Schritt
sudo systemctl reload php8.2-fpm   # SIGUSR2; Einstellung process_control_timeout beachten

Wie lange PHP-FPM beim Reload wartet, bis laufende Worker ihre Arbeit beendet haben, hängt von der Einstellung process_control_timeout in php-fpm.conf ab. Der Standardwert ist 0; dann können lang laufende Anfragen beim Reload abgebrochen werden. Setzen Sie den Wert so, dass er die längste erwartete Anfragedauer abdeckt (z. B. 10s); erst dann ist der Reload wirklich geordnet.

Die zweite Stelle, an der Sie an der Konsole zuerst nachsehen sollten, ist die FastCGI-Einstellung von Nginx. Der Skriptpfad muss nicht über den Symlink, sondern über den aufgelösten realen Pfad übergeben werden. Andernfalls nutzen OPcache und der Realpath-Cache von PHP eine Zeit lang weiter das alte Versionsverzeichnis, und es kommt die Beschwerde „Wir haben released, aber der alte Code läuft“.

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    fastcgi_param DOCUMENT_ROOT   $realpath_root;
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}

$realpath_root löst Symlinks auf und liefert den realen Pfad releases/…; jede Version wird im OPcache unter einem eigenen Pfad geschlüsselt, beim Wechsel vermischt sich nichts. Installation der Abhängigkeiten (composer install --no-dev, npm ci), Asset-Build und Cache-Vorwärmung müssen im neuen Verzeichnis abgeschlossen sein, bevor der Link umgesetzt wird. composer install im Live-Verzeichnis auszuführen, reproduziert das oben beschriebene Problem halbfertiger Dateien. Wie diese Schritte in einer CI-Pipeline angeordnet werden, beschreibt der Beitrag CI/CD-Pipeline mit GitHub Actions einrichten.

Datenbankänderungen: Expand/Contract

Den Code-Wechsel atomar zu machen, ist einfach. Bei der Datenbank nicht. Die Lösung besteht darin, eine Schemaänderung nicht als einen einzigen Bruch, sondern als über mehrere Releases verteilte, jeweils abwärtskompatible Teile umzusetzen. Dieses Muster ist als „Expand/Contract“ oder „Parallel Change“ bekannt. Beispiel: die Spalte kunde.vollname in vorname und nachname aufteilen.

  1. Expand: Neue Spalten werden so hinzugefügt, dass sie leere Werte akzeptieren. Der alte Code sieht diese Spalten nicht und läuft weiter.
  2. Doppeltes Schreiben: Die neue Version schreibt in alte und neue Spalten, liest aber weiterhin aus der alten Spalte.
  3. Backfill: Bestehende Datensätze werden in kleinen Paketen (z. B. je 1.000 Zeilen) in die neuen Spalten übertragen. Ein einziges riesiges UPDATE kann Tabelle und Replikation sperren.
  4. Lesen umstellen: Die nächste Version liest aus den neuen Spalten und schreibt weiter in die alte; ein Rollback ist weiterhin sicher.
  5. Contract: Nachdem bestätigt ist, dass keine laufende Version die alte Spalte mehr braucht, wird sie in einem separaten Release entfernt.

Das wirkt langsam. Aber in jedem Schritt können alter und neuer Code mit demselben Schema arbeiten; Rolling und Canary werden möglich, und ein Rollback erfordert keine Rückführung des Schemas. Bei MySQL/MariaDB melden Online-DDL-Optionen wie ALTER TABLE … ALGORITHM=INPLACE, LOCK=NONE für große Tabellen einen Fehler, ohne den Vorgang zu starten, wenn die gewünschte Änderung nicht unterstützt wird; daher dienen sie auch als sichere Vorabprüfung. Welche Operationen unterstützt werden, hängt von Version und Engine ab; maßgeblich ist die Dokumentation Ihrer Version.

Achten Sie bei Systemen ohne Migrationswerkzeug wie WordPress besonders auf Fälle, in denen ein Plugin- oder Core-Update ein Datenbank-Upgrade durchführt: Solche Upgrades lassen sich meist nicht rückgängig machen. Testen Sie eine solche Änderung zuerst in einer Testumgebung mit gleichwertigen Daten und erstellen Sie unmittelbar vor dem Release ein Datenbank-Backup.

Health Check und Traffic-Steuerung

Bei einem Rolling- oder Blue-Green-Wechsel muss der Load Balancer die Frage „Ist dieser Knoten bereit?“ korrekt beantworten können. Definieren Sie einen eigenen Readiness-Endpunkt: Eine Adresse wie /healthz prüft, ob die Anwendung sich mit Datenbank und Cache verbinden kann und die Konfiguration geladen ist, und liefert 200; andernfalls 503. Die Startseite als Health Check zu verwenden, ist sowohl teuer als auch wegen Antworten aus dem Cache irreführend. Auch wenn die Datenbank ausgefallen ist, kann die Startseite weiter 200 aus dem Cache liefern.

Im Open-Source-Nginx ist der Upstream-Health-Check passiv: Mit max_fails und fail_timeout wird ein Server für eine Weile deaktiviert, wenn echte Anfragen fehlschlagen. Aktive Health Checks (periodische Testanfragen) gibt es in der kommerziellen Version von Nginx oder in Load Balancern wie HAProxy. Beim Rolling-Deployment mit Open-Source-Nginx gehen wir in dieser Reihenfolge vor: Den zu aktualisierenden Knoten in der Konfiguration als down markieren, mit nginx -s reload den Traffic abziehen, das Update durchführen, den Health Check manuell prüfen, den Knoten wieder aufnehmen.

upstream anwendung {
    server 10.0.10.11:8080 max_fails=3 fail_timeout=10s;
    server 10.0.10.12:8080 max_fails=3 fail_timeout=10s down;  # wird aktualisiert
    keepalive 32;
}

In Kubernetes steuern Readiness Probe und die Deployment-Einstellungen maxUnavailable/maxSurge dieselbe Logik. Ist die Anwendung aber nicht so geschrieben, dass sie bei SIGTERM keine neuen Anfragen mehr annimmt und laufende abschließt, kann der Orchestrator allein die Unterbrechung nicht verhindern. Die Entsprechung für containerisierte Releases auf einem einzelnen Server finden Sie im Beitrag Produktivbetrieb mit Docker Compose.

Assets, Sitzungen und Cache

Fügen Sie den Namen gebauter JS/CSS-Dateien einen Inhalts-Hash hinzu und lassen Sie die Assets mindestens der vorherigen Version auf dem Server; Clients mit altem HTML im Cache erhalten so kein 404. Halten Sie Sitzungen nicht im Dateisystem, sondern in einem gemeinsamen Speicher wie Redis oder der Datenbank; ändert sich die Sitzungsstruktur, muss der neue Code auch das alte Format lesen können. Ein Versionspräfix für Schlüssel im Anwendungscache verhindert, dass die neue Version Einträge im alten Format liest. Nutzen Sie ein CDN, leeren Sie nach dem Release nicht den gesamten Cache, sondern nur die geänderten HTML-Pfade; eine vollständige Leerung erzeugt eine plötzliche Last auf dem Ursprung.

Rollback-Plan

Ein Rollback, über das erst am Release-Tag nachgedacht wird, nützt nichts. Vor jedem Release sollten diese Fragen beantwortet sein:

  • Ist ein Rollback-Befehl oder Pipeline-Schritt definiert und in den letzten drei Monaten mindestens einmal getestet worden?
  • Enthält dieses Release eine nicht umkehrbare Datenbankänderung? Wenn ja: Wurde ein Backup erstellt, und erfolgt die Rückkehr aus diesem Backup?
  • Welche Metrik löst die Rollback-Entscheidung aus: 5xx-Rate, Antwortzeit, Rückgang bei Bestellungen oder Formularübermittlungen?
  • Wer entscheidet, und wie lange wird gewartet?
  • Wurden wartende Hintergrundjobs in der Queue im neuen Format erzeugt; kann die alte Version sie verarbeiten?

Ein ungetestetes Rollback ist kein Plan. Mit Expand/Contract ist ein Code-Rollback fast immer sicher, weil das Schema beide Versionen unterstützt. Bei der Symlink-Methode besteht das Rollback darin, den Link mit derselben mv -T-Methode auf das vorherige Versionsverzeichnis umzusetzen und PHP-FPM neu zu laden. Bei Blue-Green kehrt der Traffic in die alte Umgebung zurück; zwischenzeitlich von der neuen Umgebung geschriebene Daten gehen nicht verloren, weil beide Umgebungen meist dieselbe Datenbank teilen. Deshalb gilt auch bei Blue-Green die Regel der Schemakompatibilität.

Wenn Sie Release-Pipeline und Rollback-Verfahren gemeinsam konzipieren möchten, betten wir diese Schritte im Rahmen von CI/CD- und Web-DevOps-Automatisierung in die Pipeline ein. Als Referenz dienen die Deployment-Dokumentation von Kubernetes und die Seite zum upstream-Modul von Nginx.

Häufig gestellte Fragen

Ist Zero-Downtime-Deployment bei einer WordPress-Website auf einem einzelnen Server möglich?

Auf Code-Seite ja: Entpacken Sie Versionen in getrennte Verzeichnisse, schalten Sie den Link current atomar mit mv -T um und laden Sie PHP-FPM neu. Führt ein Core- oder Plugin-Update jedoch ein Datenbank-Upgrade durch, kann dieser Schritt eine kurze Sperre verursachen. Testen Sie zuerst in der Testumgebung und erstellen Sie vor dem Release ein Backup.

Was ist der grundlegende Unterschied zwischen Blue-Green und Canary?

Bei Blue-Green wechselt der Traffic auf einmal in die neue Umgebung, die alte steht als Reserve bereit. Bei Canary erhält die neue Version zunächst einen kleinen Teil des Traffics; anhand von Fehlerrate und Antwortzeit wird der Anteil schrittweise erhöht. Canary geht mit weniger Ressourcen ein kontrollierteres Risiko ein, setzt aber voraus, dass beide Versionen längere Zeit parallel laufen können.

Nicht immer. Ältere GNU-coreutils-Versionen und einige andere ln-Implementierungen löschen zuerst den bestehenden Link und legen dann den neuen an; dazwischen existiert für einen sehr kurzen Moment kein Link, und eine Anfrage in diesem Moment schlägt fehl. Aktuelle GNU coreutils nutzen einen temporären Link und rename, aber überlassen Sie das nicht der Version: Legen Sie einen temporären Link an und verschieben Sie ihn mit mv -T darüber. Das ist ein einziger rename-Systemaufruf und atomar.

In welcher Phase sollte ich eine Datenbankspalte löschen?

In einem separaten Release, nachdem bestätigt ist, dass keine laufende Version, kein Queue-Job und kein Bericht die alte Spalte mehr liest oder schreibt. Dieser Contract-Schritt lässt sich nicht rückgängig machen; erstellen Sie vorher ein Backup.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge