EF-010

EF-010 – Deployment is a coordinated runtime transaction#

Übersicht · 2: zweite Ebene · Ziehen/Klicken: navigieren

Kategorie#

Deployment / Runtime Consistency

Kontext und Beobachtung#

Bei der Materialisierung der ersten Engineering Workbench wurden Backend-Binary, Frontend, systemd-Service und Verifikation zunächst als weitgehend unabhängige Einzelschritte behandelt.

Beobachtete Ergebnisse#

Ein laufendes Binary konnte nicht direkt überschrieben werden (Text file busy).
Ein erfolgreicher Import bedeutete nicht, dass der neue Frontend-Stand in der Runtime lag.
Ein erfolgreicher Health Check belegte nicht, dass die erwartete Frontend-Version ausgeliefert wurde.
Ein unvollständiger Frontend-Import konnte neue Module bereitstellen, während index.html weiterhin den alten Composition-Schnitt enthielt.
Abhängige Roundtrip-Korrekturen konnten bei getrennter Einspielung einen vorübergehend inkonsistenten Engineering-Stand erzeugen.

Ursache#

Deployment wurde als Folge einzelner Dateioperationen betrachtet. Es fehlte ein verbindlicher Vertrag für den konsistenten Austausch des vollständigen Runtime-Zustands.

Engineering Rule#

Binary, Frontend, Runtime-Metadaten, Service-Lifecycle, Verifikation und bilden gemeinsam eine koordinierte Runtime-Transaktion.

Architektur-Auswirkung#

Der verbindliche Ablauf lautet:

Build und Tests
                → Frontend Build oder Materialisierung
                → Service kontrolliert stoppen
                → Binary atomar ersetzen
                → Frontend atomar ersetzen
                → Runtime-Metadaten schreiben
                → Service starten
                → Service-Status prüfen
                → Health prüfen
                → Frontend und Deployment-Fingerabdruck prüfen
                → Evidence und Report erzeugen

Runtime-Konsistenz hat während des Deployments Vorrang vor unterbrechungsfreier Verfügbarkeit.

Implementierung und Verifikation#

Der Engineering-Platform-Deployer stoppt den User-systemd-Service vor dem Binary-Austausch, materialisiert Binary und Frontend als zusammengehörigen Stand und startet den anschließend neu. Ein Deployment-Marker dient als Fingerabdruck des ausgelieferten Frontends. Der Roundtrip-Vertragstest schützt Importklassifikation, Frontend-Materialisierung, Service-Lifecycle und Marker-Verifikation.

Evidence#

Am 16. Juli 2026 wurde die Engineering Workbench nach Korrektur des Roundtrips vollständig in die Test-Runtime übertragen. Nach einem tatsächlichen Browser-Reload wurden Perspective, Navigation und Knowledge Panel aus dem neuen EP-002.1-Stand dargestellt.

Beziehungen#

— informs

Weitere Hinweise#

ADR-010
ADR-009
EF-003
EF-006
EF-007
EF-008
EF-009