Seminar Credo TypeScript – Deployment mit Node.js, Containern und PostgreSQL

Das zweitägige Seminar überführt einen Credo-Agenten in eine reproduzierbare Produktionsbereitstellung. Node.js-Laufzeit, Container-Images, Konfiguration, Secrets, PostgreSQL, Datenmigration, Health Checks, Rollout, Rollback, Backup und Betriebsübergabe werden als durchgängige Deployment-Kette aufgebaut.

Inhaltsverzeichnis

• Lernziele und fachliche Einordnung
• Schrittweise Seminarinhalte
• Praxisübungen und Laborszenarien
• Zielgruppe und Voraussetzungen
• Didaktik und Arbeitsweise

Lernziele

• Eine produktionsgeeignete Node.js-Laufzeit für Credo konfigurieren.
• Sichere, reproduzierbare Container-Images und Startprozesse erstellen.
• PostgreSQL-Persistenz und Datenmigrationen kontrolliert bereitstellen.
• Health Checks, Rolling Updates und Rollback-Verfahren umsetzen.
• Backup, Restore, Observability und Betriebsübergabe dokumentieren.

Schrittweise Seminarinhalte

1. Produktionsprofil und Laufzeitvoraussetzungen

Schwerpunkt: Node.js-Version, ESM, CPU und Speicher, native Abhängigkeiten, Ports, DNS, Zeit, TLS, Dateisystem, Prozesssignale und Shutdown.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Produktionsprofil und Laufzeitvoraussetzungen“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Node.js-Version, ESM, CPU und Speicher, native Abhängigkeiten, Ports, DNS, Zeit, TLS, Dateisystem, Prozesssignale und Shutdown modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis eine geprüfte Runtime-Baseline dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

2. Build- und Container-Image

Schwerpunkt: mehrstufiger Build, Paketmanager-Lockfile, Produktionsabhängigkeiten, Non-Root-User, minimale Basis, native Libraries, SBOM und Schwachstellenprüfung.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Build- und Container-Image“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von mehrstufiger Build, Paketmanager-Lockfile, Produktionsabhängigkeiten, Non-Root-User, minimale Basis, native Libraries, SBOM und Schwachstellenprüfung modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis ein reproduzierbares und gehärtetes Image dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

3. Konfiguration und Secret Management

Schwerpunkt: Umgebungsvariablen, Konfigurationsdateien, Validierung, Secret Stores, Wallet-Schlüssel, Datenbankzugang, Zertifikate, Rotation und Fehlstart.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Konfiguration und Secret Management“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Umgebungsvariablen, Konfigurationsdateien, Validierung, Secret Stores, Wallet-Schlüssel, Datenbankzugang, Zertifikate, Rotation und Fehlstart modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis ein kontrolliertes Konfigurationsmodell dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

4. PostgreSQL und Drizzle-Persistenz

Schwerpunkt: Schema, Rollen, TLS, Connection Pool, Transaktionen, Migrationsartefakte, Indizes, Timeouts, Aufbewahrung und Datenbankhärtung.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „PostgreSQL und Drizzle-Persistenz“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Schema, Rollen, TLS, Connection Pool, Transaktionen, Migrationsartefakte, Indizes, Timeouts, Aufbewahrung und Datenbankhärtung modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis eine produktionsfähige Datenbankanbindung dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

5. Migrations- und Startreihenfolge

Schwerpunkt: Pre-Deployment Checks, Migration Job, Sperren, Abwärtskompatibilität, Agent-Start, Readiness, Teilausfälle, Rollback-Grenzen und Nachprüfung.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Migrations- und Startreihenfolge“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Pre-Deployment Checks, Migration Job, Sperren, Abwärtskompatibilität, Agent-Start, Readiness, Teilausfälle, Rollback-Grenzen und Nachprüfung modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis einen sicheren Deployment-Ablauf dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

6. Rollout, Skalierung und Rollback

Schwerpunkt: Rolling Update, Blue-Green, Replikate, Affinität, Queueing, Health Gates, Abbruchkriterien, Image-Rückwechsel und Datenkompatibilität.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Rollout, Skalierung und Rollback“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Rolling Update, Blue-Green, Replikate, Affinität, Queueing, Health Gates, Abbruchkriterien, Image-Rückwechsel und Datenkompatibilität modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis einen getesteten Release- und Rollback-Prozess dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

7. Backup, Monitoring und Betriebsübergabe

Schwerpunkt: Datenbankbackup, Wallet- und Schlüsselabhängigkeiten, Restore, Logs, Metriken, Alerts, Runbooks, Verantwortungen und Abnahme.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Backup, Monitoring und Betriebsübergabe“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Datenbankbackup, Wallet- und Schlüsselabhängigkeiten, Restore, Logs, Metriken, Alerts, Runbooks, Verantwortungen und Abnahme modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis eine vollständige Betriebsübergabe dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

Praxisübungen und Laborszenarien

• Erstellung eines mehrstufigen Container-Builds für einen Credo-Agenten.
• Konfiguration einer TLS-geschützten PostgreSQL-Verbindung und Migration.
• Implementierung von Liveness- und Readiness-Prüfungen.
• Simulation eines fehlerhaften Rollouts mit kontrolliertem Rollback.
• Durchführung einer Backup- und Restore-Abnahme.

Zielgruppe und Voraussetzungen

Zielgruppe: TypeScript- und Backend-Entwicklung, DevOps und SRE, Plattformbetrieb, Datenbankadministration und technische Release-Verantwortung.

Voraussetzungen: Praktische Erfahrung mit Node.js, Containern, SQL-Datenbanken und CI/CD; Credo-Grundkenntnisse.

Didaktik und Arbeitsweise

Kurze Fachimpulse werden unmittelbar mit Demonstrationen, strukturierten Implementierungsschritten, Code-Reviews, praktischen Übungen und kontrollierten Fehlerfällen verbunden. Jede Übung verwendet definierte Ausgangswerte, Prüfpunkte und Dokumentationsanforderungen, damit die erarbeiteten Lösungen reproduzierbar weiterentwickelt und in den Betrieb überführt werden können.