Seminar Teedy – Installation mit Docker und PostgreSQL

Eine produktionsnahe Installation benötigt mehr als einen gestarteten Container. Das Seminar baut Teedy mit Docker und PostgreSQL so auf, dass Datenhaltung, Konfiguration, Netzwerk, Sicherheit, Protokollierung, Sicherung und späterer Betrieb von Anfang an sauber getrennt sind.

Inhaltsverzeichnis

1. Seminarprofil
2. Zielgruppe
3. Voraussetzungen
4. Lernziele
5. Seminarinhalte
6. Praxisübungen
7. Methodik

Seminarprofil

Vom Infrastrukturentwurf über persistente Volumes und Datenbankbereitstellung bis zu Reverse Proxy, Zertifikaten, OCR-Voraussetzungen und Inbetriebnahmetests entsteht eine dokumentierte Zielumgebung. Die Installation wird reproduziert und mit fachlichen sowie technischen Prüfschritten abgenommen.

Zielgruppe

Systemadministration, DevOps, Plattformbetrieb, technische Projektleitung und Anwendungsbetreuung.

Voraussetzungen

Grundkenntnisse in Linux, Docker, Netzwerken und relationalen Datenbanken. Administrative Berechtigungen in einer geeigneten Testumgebung.

Lernziele

• Infrastruktur, Abhängigkeiten und Betriebsgrenzen vor der Installation vollständig planen.
• Teedy und PostgreSQL mit persistenter, gesicherter Datenhaltung bereitstellen.
• Konfiguration und Geheimnisse sauber vom Containerimage trennen.
• Netzwerkzugriff, TLS, Protokollierung und Ressourcen kontrolliert einrichten.
• Die Inbetriebnahme mit Funktions-, Sicherheits- und Wiederanlauftests abnehmen.

Seminarinhalte

1. Zielarchitektur und Betriebsgrenzen planen

Nutzungsprofil, Datenvolumen, OCR-Last, Verfügbarkeit und Zuständigkeiten werden vor der Installation in eine technische Zielarchitektur überführt.

1. Schritt 1: Benutzerzahl, Dokumentmenge, Dateigrößen und Verarbeitungsspitzen abschätzen.
2. Schritt 2: Host, Speicher, Datenbank, Netzwerk, Namensauflösung und Zertifikate einplanen.
3. Schritt 3: Persistente Datenbereiche, Sicherungsziele und externe Abhängigkeiten benennen.
4. Schritt 4: Verantwortung für Betriebssystem, Container, Datenbank, Anwendung und Support trennen.

2. Host, Verzeichnisse und PostgreSQL vorbereiten

Betriebssystem, Dienstkonto, Dateirechte, persistente Verzeichnisse und Datenbank werden kontrolliert bereitgestellt.

1. Schritt 1: Betriebssystem aktualisieren und nur benötigte Pakete sowie Laufzeitkomponenten installieren.
2. Schritt 2: Dienstkonto und getrennte Daten-, Konfigurations-, Protokoll- und Sicherungsverzeichnisse anlegen.
3. Schritt 3: PostgreSQL mit persistentem Speicher, eigener Datenbank und minimal berechtigtem Benutzer starten.
4. Schritt 4: Verbindung, Zeichensatz, Zeitzone, Speicherplatz und Sicherungszugriff testen.

3. Teedy-Container und externe Konfiguration einrichten

Anwendung, Konfiguration, Geheimnisse und persistente Daten werden so getrennt, dass die Umgebung reproduzierbar bleibt.

1. Schritt 1: Definiertes Image und kontrollierte Version auswählen.
2. Schritt 2: Persistenten Datenbereich korrekt einbinden und Schreibrechte prüfen.
3. Schritt 3: Datenbankparameter und erforderliche Umgebungsvariablen außerhalb des Images verwalten.
4. Schritt 4: Container starten und Startprotokolle auf Verbindungs-, Rechte- oder Migrationsfehler prüfen.

4. Reverse Proxy, Netzwerk und TLS absichern

Der Zugriff erfolgt über eine klar begrenzte, verschlüsselte Eingangsstelle; interne Dienste bleiben abgeschirmt.

1. Schritt 1: Reverse Proxy oder vergleichbare Zugriffsschicht bereitstellen.
2. Schritt 2: Dienstname, Namensauflösung und Zertifikat für die Zielumgebung konfigurieren.
3. Schritt 3: Nur erforderliche Ports veröffentlichen und Datenbank sowie interne Dienste begrenzen.
4. Schritt 4: Weiterleitungen, Header, Uploadgröße, Zeitüberschreitungen und Zertifikatskette testen.

5. OCR, Dateiformate und Ressourcen abnehmen

Die Zielumgebung wird mit repräsentativen Dateien und realistischen Verarbeitungsanforderungen geprüft.

1. Schritt 1: OCR-Voraussetzungen und benötigte Sprachdaten bereitstellen.
2. Schritt 2: PDF-, Bild-, Office- und größere Testdateien kontrolliert hochladen.
3. Schritt 3: Vorschau, Texterkennung, Volltext, Download und Fehlerbehandlung prüfen.
4. Schritt 4: CPU-, Arbeitsspeicher-, Datenträger- und Zeitgrenzen anhand der Testlast dimensionieren.

6. Inbetriebnahme und Wiederanlauf prüfen

Die Installation wird über fachliche Kernfunktionen, Neustart, Sicherung und dokumentierte Übergabe abgenommen.

1. Schritt 1: Administratives Erstkonto absichern und Standardzugänge kontrollieren.
2. Schritt 2: Benutzer, Upload, OCR, Suche, Tags, Berechtigungen, Freigabe und API testen.
3. Schritt 3: Host- und Containerneustart mit vollständigem Wiederanlauf durchführen.
4. Schritt 4: Installationsstand, Konfiguration, Sicherung und Betriebsverantwortung dokumentieren.

7. Sicherungsumfang und Wiederanlaufziele festlegen

Alle für einen Wiederanlauf notwendigen Bestandteile werden mit Datenverlust- und Wiederanlaufzielen erfasst.

1. Schritt 1: Datenbank, Dokumentdateien, Konfiguration, Schlüssel, Zertifikate und Laufzeitparameter inventarisieren.
2. Schritt 2: Speicherorte und Abhängigkeiten zwischen Container, Host und externen Diensten dokumentieren.
3. Schritt 3: Änderungsrate, zulässigen Datenverlust und maximale Wiederanlaufzeit bestimmen.
4. Schritt 4: Verantwortung für Sicherung, Prüfung, Freigabe und Notfallentscheidung zuordnen.

Praxisübungen

1. Aufbau einer vollständigen Testinstallation mit getrennten Daten- und Konfigurationsbereichen.
2. Einrichtung von PostgreSQL, Anwendung, Reverse Proxy und TLS in einer kontrollierten Reihenfolge.
3. Technische Abnahme mit Upload, OCR, Suche, Neustart und Sicherungsprüfung.

Methodik

Die Installation wird schrittweise in einer Übungsumgebung aufgebaut und nach jedem Abschnitt mit einem klaren Test abgesichert. Architektur- und Betriebsentscheidungen werden parallel dokumentiert.