Seminar FerretDB Konfiguration und Betriebsmodi

Zielsetzung

Das Seminar strukturiert die FerretDB-Konfiguration über Kommandozeilenparameter und Umgebungsvariablen. Verbindungsparameter, Listener, Debug-Schnittstellen, Protokollierung sowie Normal-, Proxy- und Differenzmodi werden sicher eingerichtet und durch reproduzierbare Tests geprüft.

Inhaltsübersicht

1. Zielsetzung und Lernziele
2. Teilnehmerkreis und Voraussetzungen
3. Konfigurationsmodell
4. PostgreSQL-Verbindung und Pool
5. Listener und Schnittstellen
6. Betriebsmodi
7. Logging, Telemetrie und Tracing
8. Validierung und Bereitstellung
9. Praxisübungen und Methodik

Lernziele

• Konfigurationsparameter und ihre Umgebungsvariablen systematisch verwalten
• PostgreSQL-Verbindung, Poolparameter und Listener korrekt einstellen
• Normal-, Proxy- und Differenzmodi für Betrieb, Test und Fehlersuche auswählen
• Konfigurationen sicher prüfen, dokumentieren und automatisierbar bereitstellen

Teilnehmerkreis

Administratoren, DevOps-Fachkräfte, Entwickler, Testautomatisierer und Migrationsverantwortliche.

Voraussetzungen

Grundkenntnisse in FerretDB, Netzwerkdiensten und Umgebungsvariablen. Zugriff auf FerretDB, PostgreSQL und optional eine MongoDB-Testinstanz.

Seminarinhalte

Kapitel 1: Konfigurationsmodell

Inhaltsübersicht des Kapitels: Kommandozeilenparameter und gleichwertige Umgebungsvariablen zuordnen; Standardwerte, Containerabweichungen und überschreibende Parameter erfassen; Konfiguration ohne klassische Konfigurationsdatei betriebssicher organisieren.

1. Schritt 1: Kommandozeilenparameter und gleichwertige Umgebungsvariablen zuordnen
2. Schritt 2: Standardwerte, Containerabweichungen und überschreibende Parameter erfassen
3. Schritt 3: Konfiguration ohne klassische Konfigurationsdatei betriebssicher organisieren

Kapitel 2: PostgreSQL-Verbindung und Pool

Inhaltsübersicht des Kapitels: Verbindungs-URL oder geschützte URL-Datei auswählen; Benutzer, Datenbank, TLS-Parameter und Erreichbarkeit prüfen; Minimale und maximale Poolgröße an Last und Backendkapazität anpassen.

1. Schritt 1: Verbindungs-URL oder geschützte URL-Datei auswählen
2. Schritt 2: Benutzer, Datenbank, TLS-Parameter und Erreichbarkeit prüfen
3. Schritt 3: Minimale und maximale Poolgröße an Last und Backendkapazität anpassen

Kapitel 3: Listener und Schnittstellen

Inhaltsübersicht des Kapitels: MongoDB-Protokoll auf TCP- oder Unix-Socket bereitstellen; TLS-, Data-API-, MCP- und Debug-Listener nach Bedarf aktivieren; Nicht benötigte Schnittstellen deaktivieren und Netzwerkzugriff begrenzen.

1. Schritt 1: MongoDB-Protokoll auf TCP- oder Unix-Socket bereitstellen
2. Schritt 2: TLS-, Data-API-, MCP- und Debug-Listener nach Bedarf aktivieren
3. Schritt 3: Nicht benötigte Schnittstellen deaktivieren und Netzwerkzugriff begrenzen

Kapitel 4: Betriebsmodi

Inhaltsübersicht des Kapitels: Normalmodus für reguläre Verarbeitung konfigurieren; Proxymodus für kontrollierte Weiterleitung an ein Vergleichssystem einsetzen; Differenzmodi für Antwortvergleich und Kompatibilitätstests verwenden; Proxy-Adresse und TLS-Parameter sicher festlegen.

1. Schritt 1: Normalmodus für reguläre Verarbeitung konfigurieren
2. Schritt 2: Proxymodus für kontrollierte Weiterleitung an ein Vergleichssystem einsetzen
3. Schritt 3: Differenzmodi für Antwortvergleich und Kompatibilitätstests verwenden
4. Schritt 4: Proxy-Adresse und TLS-Parameter sicher festlegen

Kapitel 5: Logging, Telemetrie und Tracing

Inhaltsübersicht des Kapitels: Logstufe und Instanzkennzeichnung passend zur Umgebung setzen; OpenTelemetry-Ziel und Servicenamen konfigurieren; Telemetrieentscheidung dokumentieren und unbeabsichtigte Datenabflüsse vermeiden.

1. Schritt 1: Logstufe und Instanzkennzeichnung passend zur Umgebung setzen
2. Schritt 2: OpenTelemetry-Ziel und Servicenamen konfigurieren
3. Schritt 3: Telemetrieentscheidung dokumentieren und unbeabsichtigte Datenabflüsse vermeiden

Kapitel 6: Validierung und Bereitstellung

Inhaltsübersicht des Kapitels: Konfiguration mit Start-, Verbindungs-, Negativ- und Lasttests prüfen; Geheimnisse von nicht sensitiven Parametern trennen; Konfigurationsstand versionieren und Änderungen nachvollziehbar freigeben.

1. Schritt 1: Konfiguration mit Start-, Verbindungs-, Negativ- und Lasttests prüfen
2. Schritt 2: Geheimnisse von nicht sensitiven Parametern trennen
3. Schritt 3: Konfigurationsstand versionieren und Änderungen nachvollziehbar freigeben

Praxisübungen

• Eine vollständige Umgebungskonfiguration aus Variablen aufbauen und testen
• Normal-, Proxy- und Differenzmodus anhand definierter Requests vergleichen
• Fehlkonfigurationen bei Listenern, Poolwerten und Zugangsdaten diagnostizieren

Methodik

Parameter werden nicht isoliert betrachtet, sondern in mehreren Betriebsprofilen zusammengeführt. Jede Variante wird gestartet, mit Testrequests geprüft und anhand von Logs sowie Metriken bewertet.