Seminar Tenzir – Packages und wiederverwendbare Integrationen

Einzelne Pipelines lösen lokale Aufgaben; Packages machen Integrationen wiederverwendbar, testbar und kontrolliert weiterentwickelbar. Im Mittelpunkt stehen den Aufbau transportierbarer und wartbarer Packages aus TQL-Operatoren, Pipelines, Contexts, Parametern, Tests, Dokumentation und Release-Metadaten.

Seminarziel

Nach dem Seminar können Packages geplant, entwickelt, parametrisiert, getestet, versioniert, installiert und sicher gewartet werden.

Inhaltsübersicht

1. Kapitel 1: Paketgrenzen, Manifest und Struktur
2. Kapitel 2: Operatoren, Pipelines, Contexts und Konstanten
3. Kapitel 3: Eingaben, Parameter und Secrets
4. Kapitel 4: Beispiele, Tests und Dokumentation
5. Kapitel 5: Versionierung, Veröffentlichung und Wartung
6. Praxisübungen
7. Zielgruppe und Voraussetzungen

Kapitel 1: Paketgrenzen, Manifest und Struktur

1. Schritt 1: Use Case, unterstützte Quellen, Zielschemata, Abhängigkeiten und Betriebsannahmen des Packages abgrenzen.
2. Schritt 2: Manifest, Verzeichnisse, Namen, Metadaten und Dokumentation konsistent strukturieren.
3. Schritt 3: Wiederverwendbare Logik von umgebungsspezifischen Werten und Zugangsdaten trennen.
4. Schritt 4: Kompatibilitäts- und Upgradeversprechen für Nutzer des Packages festlegen.

Kapitel 2: Operatoren, Pipelines, Contexts und Konstanten

1. Schritt 1: Benutzerdefinierte Operatoren für Parser, Normalisierung, Enrichment und Hilfslogik definieren.
2. Schritt 2: Startfähige und einbettbare Pipelines mit klaren Eingaben und Ausgaben bereitstellen.
3. Schritt 3: Contexts und Konstanten mit nachvollziehbarer Herkunft und Aktualisierung integrieren.
4. Schritt 4: Abhängigkeiten zwischen Paketbestandteilen explizit machen und zyklische Kopplungen vermeiden.

Kapitel 3: Eingaben, Parameter und Secrets

1. Schritt 1: Konfigurierbare Parameter mit Typ, Standardwert, Beschreibung und Validierungsregel definieren.
2. Schritt 2: Secret-Referenzen statt Klartextzugängen verwenden und minimale Berechtigungen dokumentieren.
3. Schritt 3: Mehrere Betriebsvarianten über überschaubare Eingabekombinationen abbilden.
4. Schritt 4: Fehlende oder widersprüchliche Eingaben früh und verständlich zurückweisen.

Kapitel 4: Beispiele, Tests und Dokumentation

1. Schritt 1: Ausführbare Beispiele für Normalbetrieb, Varianten und Fehlerfälle bereitstellen.
2. Schritt 2: Fixtures, Baselines und Tenzir-Testfälle für Operatoren und End-to-End-Pipelines erstellen.
3. Schritt 3: Installations-, Konfigurations-, Betriebs- und Fehlersuchanleitungen aus Anwendersicht verfassen.
4. Schritt 4: Sensible Daten, interne Endpunkte und nicht redistribuierbare Inhalte vor Bereitstellung entfernen.

Kapitel 5: Versionierung, Veröffentlichung und Wartung

1. Schritt 1: Semantische Änderungen, Breaking Changes und Migrationsschritte in Version und Changelog abbilden.
2. Schritt 2: Review, automatisierte Prüfung, Freigabe und signierte Artefakte in den Veröffentlichungsprozess integrieren.
3. Schritt 3: Installation, Update, Rollback und Entfernung in einer sauberen Testumgebung prüfen.
4. Schritt 4: Fehlerberichte und Sicherheitskorrekturen in einen geregelten Wartungsprozess überführen.

Praxisübungen

1. Übung 1: Package-Gerüst mit Manifest anlegen.
2. Übung 2: Parser, OCSF-Mapping und Context bündeln.
3. Übung 3: Eingaben und Secret-Referenzen definieren.
4. Übung 4: Test, Versionierung und Installation durchführen.

Zielgruppe

TQL-Entwickler, Security Data Engineers, Integratoren, Package-Verantwortliche, Platform Engineers und technische Produktteams.

Voraussetzungen

Sichere TQL-Kenntnisse, Erfahrung mit Pipelines und Git sowie Grundlagen zu Tests und Versionierung.