ET-DEPLOYMENT-TOOL-CONTRACT-001

Engineering Platform Deployment Tool Contract#

Verantwortung#

führt ein dokumentiertes lokales Engineering-Platform-Deployment für test oder production aus und erzeugt über Build, Zielzustand und Verifikation. Es besitzt keine Remote-Übertragungsfunktion.

Eingabe#

deploy-engineering-platform.py \
                  [--environment test|production] \
                  [--engineering-home PATH] \
                  [--roundtrip-id ID] \
                  [--evidence-copy PATH]

--environment wählt ausschließlich eine lokale Runtime unter dem

Engineering-Home.

--engineering-home bestimmt die ausdrücklich freigegebene Engineering-Installation.
--roundtrip-id verbindet die Evidence mit dem auslösenden Roundtrip.
--evidence-copy fordert eine zusätzliche Kopie der erzeugten Evidence an.

Vorbedingungen#

Die Installation und Umgebungsprüfung folgen INSTALLATION.md. Fremde oder manuell gestartete Prozesse auf dem Zielport müssen vor einem Neustart als Konflikt erkannt werden.

Ausgaben und Evidence#

Der Lauf dokumentiert die tatsächlich ausgeführten Build-, Deployment- und Verifikationsschritte. Die Evidence muss den verwendeten Zielbereich, die Roundtrip-Zuordnung und festgestellte Port-Ownership nachvollziehbar machen.

Seiteneffekte#

Seiteneffekte sind auf die gewählte lokale Installation, deren User-Service und zugehörige Evidence begrenzt. Öffentliche Online-Promotion ist durch diese Oberfläche nicht freigegeben.

Fehlerverhalten#

Buildfehler, nicht erfüllte Vorbedingungen, fremde Port-Owner, fehlgeschlagener Service-Start oder fehlgeschlagene Verifikation führen zu einem von null verschiedenen Exit-Code. Ein unvollständig ausgeführter Lauf darf nicht als erfolgreich berichtet werden.

Verifikation#

../98-tests/test_deploy_engineering_platform.py
systemd/engineering-platform-test.[[EA-GLOSS-SERVICE-001|service]].template
EP-002-0B-ENGINEERING-ROUNDTRIP.md