EF-006

EF-006 – Port ownership must be verified before restart#

Kategorie#

Deployment

Kontext und Beobachtung#

Während des ersten systemd-Deployments lief noch ein manuell gestarteter Engineering-Platform-Prozess auf Port 18082.

Symptom#

Der User-service geriet durch Restart=on-failure in eine Neustartschleife. Das Journal zeigte wiederholt bind: address already in use. Ein paralleler Health-Check war dennoch erfolgreich, weil er den alten Prozess erreichte.

Ursache#

Der Deploymentpfad prüfte weder den Besitzer des Zielports noch, ob die Health-Antwort vom gerade deployten systemd-Prozess stammte.

Engineering Rule#

Vor einem Restart wird die Port-Eigentümerschaft geprüft, nicht nur die Erreichbarkeit des Ports.

Zulässig ist der bereits laufende Zielservice. Fremde oder manuelle Prozesse führen vor dem Restart zu einem kontrollierten Fehler.

Architektur-Auswirkung#

Service-Status und Health müssen gemeinsam verifiziert werden. Eine erfolgreiche HTTP-Antwort allein ist keine Deployment-Evidence.

Implementierung und Verifikation#

Der Deploymentpfad erzeugt port-ownership.json und unterscheidet Zielservice-PID von fremden Listener-PIDs.

Evidence#

Nach Beendigung des manuellen Prozesses startete der systemd-Service stabil und belegte Port 18082 mit seiner eigenen PID.

Beziehungen#

• ◆Execution-Evidence-ModellOrdnet Engineering Execution und Evidence als Spezialisierung der universellen Enterprise-Execution ein. — informs

Weitere Hinweise#

• EF-005
• EF-009