Installation via Helm Charts

Diese Seite beschreibt die grundlegenden Schritte, um die Datenfabrik auf einem Kubernetes-Cluster über die bereitgestellten Helm Charts in Betrieb zu nehmen.

Alle Helm Charts sind im zentralen Repository verfügbar: https://gitlab.opencode.de/sh/zit/datenfabrik/helm-charts

Voraussetzungen

  • Ein laufendes Kubernetes Cluster (Version 1.33+)
  • Installierter Ingress Controller (z.B. Traefik)
  • kubectl mit konfiguriertem Cluster-Zugriff (Cluster-Admin-Rechte)
  • helm (Version 3.0+)
  • Zugriff auf gitlab.opencode.de

Schritt 1 – Cluster-Basisdienste installieren

Bevor die Datenfabrik-Anwendungen ausgerollt werden können, müssen folgende Dienste einmalig cluster-weit installiert sein. Diese Schritte sind durch einen Cluster-Admin durchzuführen.

ApiSix (API-Gateway) (optional)

→ Installationsanleitung: apisix-helm README

Cert-manager (TLS-Zertifikate via Let's Encrypt) (optional)

Wird nur benötigt, wenn TLS-Zertifikate nicht extern bereitgestellt werden (z. B. über einen vorgelagerten Load Balancer oder eine eigene PKI).

→ Installationsanleitung: cert-manager-helm README

CNPG Operator (falls kein externer Postgres Service genutzt wird)

→ Installationsanleitung: cnpg-helm README

MinIO Operator (falls kein externer S3 Service genutzt wird)

→ Installationsanleitung: minio-operator-umbrella README

Schritt 2 – Namespace anlegen

Für jede logische Umgebung (z. B. dev, qa, prod) wird ein eigener Kubernetes-Namespace angelegt:

kubectl create namespace <namespace>

Schritt 3 – Anwendungskomponenten deployen

Die folgenden Anwendungen werden in dieser Reihenfolge installiert, da Keycloak als zentraler Identity Provider von allen anderen Diensten benötigt wird.

Die vollständige Installationsanleitung sowie alle erforderlichen Konfigurationsparameter befinden sich jeweils im README des zugehörigen Helm Charts.

1. Keycloak

→ Chart inkl. Installationsanleitung: keycloak-helm README

Nach der Installation mit dem initialen Admin-User einloggen, einen persönlichen Admin-Account anlegen und den initialen User löschen.

2. MinIO Tenant (optional, s.o.)

→ Chart inkl. Installationsanleitung: minio-tenant-umbrella README

Der Tenant muss nur deployed werden, falls kein externer S3 Dienst zur Verfügung steht.

3. Airflow

→ Chart inkl. Installationsanleitung: airflow-helm README

Nach der Installation die Airflow Connections für die DAG-Repositories und den MinIO S3-Bucket für Logs über die Airflow-Weboberfläche konfigurieren.

4. Cadenza

→ Chart inkl. Installationsanleitung: cadenza-helm README

Die Images sind aktuell noch nicht offen verfügbar, eine Ableitung einer reinen Open-Source Variante ist durch das Land SH geplant.

5. postgREST

→ Chart inkl. Installationsanleitung: pgrest-helm README

Weiterführende Dokumentation

Support und Anfragen

Bei Fragen zur Installation, zu den Helm Charts oder für Support-Anfragen wenden Sie sich bitte an: datenfabrik-zit@stk.landsh.de