account-api: DB-Start mit Backoff, Fehlerklassifizierung, Restart-Limits #410

Merged
patrick merged 1 commits from fix/account-api-start into main 2026-10-28 14:53:00 +01:00
Owner

Änderung

  • cmd/account-api/dbstart.go: waitForDB pingt die Mandanten-DB mit Backoff (1s bis 30s, Timeout NEXARCH_ACCOUNT_DB_STARTUP_TIMEOUT_SECONDS, Standard 120). SQLSTATE 28P01/28000/3D000 gelten als dauerhaft: klare Meldung, Exit 2. Verbindungsfehler werden wiederholt.
  • Unit-Template: RestartSec=5, StartLimitIntervalSec=300, StartLimitBurst=10, RestartPreventExitStatus=2. Vorher 5 Neustarts in 2 s, dann "Start request repeated too quickly".
  • Tests: Klassifizierung, Backoff, Timeout.

Auswirkungen

Nur Startverhalten. Keine API-Änderung. Die installierte Unit auf 131 muss aus dem Template neu erzeugt werden.

Nicht enthalten

Die Ursache auf 131 ist ein Betriebsfehler: Passwort in account-api.env passt nicht zur Rolle nexarch_core (28P01). Das behebt dieser PR nicht. /healthz vor DB-Init und /readyz sind nicht umgesetzt.

🤖 Generated with Claude Code

## Änderung - `cmd/account-api/dbstart.go`: `waitForDB` pingt die Mandanten-DB mit Backoff (1s bis 30s, Timeout `NEXARCH_ACCOUNT_DB_STARTUP_TIMEOUT_SECONDS`, Standard 120). SQLSTATE 28P01/28000/3D000 gelten als dauerhaft: klare Meldung, Exit 2. Verbindungsfehler werden wiederholt. - Unit-Template: `RestartSec=5`, `StartLimitIntervalSec=300`, `StartLimitBurst=10`, `RestartPreventExitStatus=2`. Vorher 5 Neustarts in 2 s, dann "Start request repeated too quickly". - Tests: Klassifizierung, Backoff, Timeout. ## Auswirkungen Nur Startverhalten. Keine API-Änderung. Die installierte Unit auf 131 muss aus dem Template neu erzeugt werden. ## Nicht enthalten Die Ursache auf 131 ist ein Betriebsfehler: Passwort in `account-api.env` passt nicht zur Rolle `nexarch_core` (28P01). Das behebt dieser PR nicht. `/healthz` vor DB-Init und `/readyz` sind nicht umgesetzt. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
patrick added 1 commit 2026-10-28 14:22:42 +01:00
account-api: DB-Start mit Backoff und Fehlerklassifizierung, systemd-Restart-Limits
CI / Web-Barrierefreiheitspruefung (axe, Tastatur, Reflow, Textabstaende) (pull_request) Canceled after 0s
CI / Core-Modul (Build/Vet/Test) (push) Successful in 39s
CI / Web-Barrierefreiheitspruefung (axe, Tastatur, Reflow, Textabstaende) (push) Canceled after 0s
CI / DMS Security-Test-Gate (AC5, Merge-Gate) (push) Successful in 3s
CI / Connect Security-Test-Gate (QA-01 AC4, Merge-Gate) (push) Successful in 3s
CI / DMS-Modul Supply-Chain-Scan (govulncheck) (push) Failing after 14s
CI / Web (dms-browser) (push) Failing after 53s
CI / Web (pdf-viewer) (push) Failing after 38s
CI / Web (shl) (push) Failing after 7s
CI / Core-Modul (Build/Vet/Test) (pull_request) Successful in 37s
CI / DMS Security-Test-Gate (AC5, Merge-Gate) (pull_request) Successful in 3s
CI / Connect Security-Test-Gate (QA-01 AC4, Merge-Gate) (pull_request) Successful in 2s
CI / DMS-Modul Supply-Chain-Scan (govulncheck) (pull_request) Failing after 13s
CI / Web (dms-browser) (pull_request) Failing after 49s
CI / Web (pdf-viewer) (pull_request) Failing after 39s
CI / Web (shl) (pull_request) Failing after 7s
Supply-Chain-Scan (Go) / govulncheck (push) Failing after 1m15s
Core-Schnittstellen-Vertragstests / contract-tests (pull_request) Successful in 13m17s
Supply-Chain-Scan (Go) / govulncheck (pull_request) Failing after 53s
Supply-Chain-Scan (npm) / npm-audit (pull_request) Failing after 1m21s
Core-Pflichttest-Gate / pflichttest-gate (pull_request) Successful in 13m17s
RBAC-Rollenhierarchie-Pflichtgate / rbac-policy-invariant (pull_request) Successful in 12m42s
CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (pull_request) Canceled after 0s
CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (push) Canceled after 0s
e428de553d
Dauerhafte Fehler (28P01, 28000, 3D000) beenden mit Exit 2 und klarer Meldung,
transiente Fehler werden bis NEXARCH_ACCOUNT_DB_STARTUP_TIMEOUT_SECONDS wiederholt.
Unit-Template: RestartSec, StartLimit, RestartPreventExitStatus=2.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
patrick merged commit a16d8cef66 into main 2026-10-28 14:53:00 +01:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: scripte/nexarch#410