BOOTSTRAP-CONTRACT

Bootstrap Contract – Engineering Platform#

Aktueller Status#

Der bestehende Python-Bootstrap materialisiert Runtime-Strukturen und Konfigurationsdateien. Die Datenbankkonfiguration besitzt derzeit eine bekannte Lücke: Der Execute-Pfad kann ohne Fehlerbericht enden, obwohl Datenbanken und Benutzer nicht angelegt wurden.

Diese Datei ist der verbindliche Vertrag für die Korrektur.

Allgemeiner Ablauf#

Load Configuration
                → Discover Environment
                → Build Plan
                → Confirm / Apply
                → Execute Steps
                → Verify Every Required Postcondition
                → Create Evidence
                → Write Report
                → Return Process Status

MariaDB-Step#

Plan#

• Root-Zugang mit EP_DATABASE_ROOT_USER und EP_DATABASE_ROOT_PASSWORD prüfen.
• Datenbank, Benutzer, Host, Rechte und Charset ermitteln.
• Änderungen als Plan ausgeben.

Execute#

• fehlende Datenbanken anlegen,
• fehlende Benutzer anlegen,
• Passwort und Rechte kontrolliert setzen,
• utf8mb4 konfigurieren.

Verify#

Für Test und Produktion jeweils:

1. TCP-Verbindung mit dem Anwendungsbenutzer aufbauen,
2. erwartete Datenbank auswählen,
3. SELECT DATABASE(), CURRENT_USER(), 1 ausführen,
4. erwarteten Datenbanknamen prüfen,
5. Schreibrecht in einer kontrollierten Transaktion prüfen oder über Privilege Inspection belegen,
6. temporäre Verify-Objekte wieder entfernen.

⌘EvidenceTechnical documentation artifact.#

• Umgebung,
• MariaDB-Version,
• geprüfter Benutzername ohne Passwort,
• Datenbankname,
• Verification-Zeitpunkt,
• Resultat.

Fehlerverhalten#

• Root-Login fehlgeschlagen: planning_failed oder execution_failed.
• Benutzeranlage fehlgeschlagen: execution_failed.
• Anwendungslogin fehlgeschlagen: verification_failed.
• Der Prozess endet bei Pflichtfehlern mit Exit-Code ungleich null.

Secret Handling#

Root- und Anwendungspasswörter werden nicht als CLI-Argument an mariadb übergeben. Eine temporäre Client-Optionsdatei erhält Modus 0600 und wird in einem finally-Pfad gelöscht.

Report#

Der Report unterscheidet:

• Findings vor Ausführung,
• geplante Änderungen,
• tatsächlich ausgeführte Änderungen,
• Verification Results,
• ◆EvidenceTechnical documentation artifact.,
• offene Findings,
• Gesamtstatus.