Zum Inhalt springen
Beta

Gemeinsamer Dateispeicher für STACKIT Kubernetes Engine

Zuletzt aktualisiert am

Mehrere Replikate einer Anwendung benötigen dieselben Uploads, erzeugten Berichte oder Arbeitsdateien, auch wenn Kubernetes sie auf unterschiedlichen Nodes ausführt. Dateien ausschließlich im Container stellen dieses gemeinsame Verzeichnis nicht bereit. Dieser Blueprint verbindet die STACKIT Kubernetes Engine (SKE) über NFS mit STACKIT File Storage (SFS) und stellt den Speicher über einen ReadWriteMany-PersistentVolumeClaim (RWX) bereit.

Die Anwendung arbeitet weiter mit Dateipfaden, statt eine Object-Storage-API einzubinden. Typische Anwendungsfälle sind eine replizierte Webanwendung mit gemeinsamen Mediendateien oder Worker, die Dateien austauschen. Die Anwendung muss parallele Zugriffe unterstützen: RWX ermöglicht einen gemeinsamen Mount, übernimmt aber keine Anwendungssperren oder transaktionalen Schreibzugriffe.

STACKIT Network Area verbindet das SKE-Node-Netz und File Storage in einem Projekt. Pods auf verschiedenen Nodes nutzen denselben PVC; der NFS-CSI-Treiber mountet dessen Verzeichnis vom SFS-Share. Terraform provisioniert zuerst Storage und danach den Cluster.

Die Grafik zeigt beispielhaft zwei Pods; die mitgelieferte Demonstration verteilt vier Replikate auf mindestens zwei Nodes. Network Area stellt Adressraum und Netzverbindung bereit. Das Projekt ist dieser Network Area zugeordnet, sodass das SKE-Netz ein Präfix aus ihrem konfigurierten Bereich erhält. Die IP-ACL des SFS-Pools und die Export Policy erlauben standardmäßig Clients aus diesem Bereich.

In SKE bindet der per Helm installierte csi-driver-nfs den vorhandenen SFS-Endpunkt über die StorageClass nfs-client ein. Ihre Parameter server und share stammen aus dem SFS-Mount-Pfad. Die dynamische Provisionierung erzeugt je PVC ein Verzeichnis auf dem Share; Pods mit demselben PVC teilen dieses Verzeichnis. Unterschiedliche PVCs greifen nicht automatisch auf dieselben Dateien zu. Die NFS-CSI-Treiberparameter beschreiben dieses Modell.

Terraform ist in zwei getrennt verwaltete Stufen aufgeteilt. So bleiben Einrichtung auf Organisationsebene und die langsamere Bereitstellung des Storage-Pools von Cluster-Operationen getrennt.

  1. 01-storage: Erstellt Network Area und regionale Adressbereiche, ein zugeordnetes Projekt sowie SFS Resource Pool, Export Policy und Share. Outputs enthalten Projekt-ID, Mount-Pfad und Netzwerkinformationen.
  2. 02-cluster: Liest Projekt-ID und Mount-Pfad aus dem lokalen State der ersten Stufe, erstellt Projektnetz und SKE-Cluster und installiert NFS-CSI-Helm-Chart und StorageClass. Eine ephemere Kubeconfig liefert Helm-Zugangsdaten, ohne diese Kubeconfig im Terraform-State abzulegen.
  3. Optionale Demonstration: Kubernetes-Manifeste erzeugen einen Test-PVC, danach einen zweiten PVC, vier Pods mit Writer und nginx sowie einen LoadBalancer-Service. Die Writer hängen ihre Hostnamen an eine gemeinsame Datei an, die nginx ausliefert. Diese Objekte werden außerhalb von Terraform mit kubectl angelegt.

Für den vollständigen Blueprint ist Terraform ab 1.10 erforderlich: Stufe 1 benötigt 1.5, Stufe 2 wegen der ephemeren Ressource 1.10. Das Beispiel deklariert den STACKIT Provider >= 0.116.0 und den Helm Provider >= 3.1.1. SFS-Beta-Ressourcen und das SKE-Experiment sind in der jeweiligen Provider-Konfiguration aktiviert.

Benötigt werden Organisationsberechtigungen für die erste Stufe, ein für Terraform zugänglicher Service-Account-Schlüssel und eine authentifizierte STACKIT CLI. Das Beispiel legt das Projekt direkt unter der Organisation an, da seine README eine Einschränkung für SKE-Cluster in Projekten unterhalb von Ordnern dokumentiert. Prüfe die aktuelle SKE-Dokumentation , bevor du diese Hierarchie anpasst. Für die Demonstration ist kubectl erforderlich. Berücksichtige Kosten für bereitgestellte Speicherkapazität, Worker-Nodes und den optionalen Load Balancer.

  1. Storage konfigurieren. Klone das Quellrepository und wechsle nach examples/ske-stackit-sfs-integration/01-storage. Kopiere terraform.tfvars.example nach terraform.tfvars, trage Organisation, übergeordneten Container und Eigentümer-E-Mail ein und konfiguriere Zugangsdaten sowie überschneidungsfreie Netzbereiche.
  2. Storage prüfen und erstellen. Führe terraform init, terraform validate und terraform plan aus und wende anschließend den geprüften Plan an. Warte auf einen nutzbaren IPv4-NFS-Endpunkt. Für Pool-Operationen sind 60 Minuten Timeout voreingestellt; die README der Stufe beschreibt die Prüfung eines Timeouts vor einer Wiederherstellung.
  3. Cluster prüfen und erstellen. Wechsle nach ../02-cluster, passe bei Bedarf die Variablen an und führe terraform init, terraform validate und terraform plan aus. Wende den geprüften Plan an. Behalte für die voreingestellte State-Übergabe die vorgesehene Verzeichnisstruktur beider Stufen bei.
  4. Gemeinsamen Zugriff nachweisen. Folge der README von Stufe 2, um eine Kubeconfig abzurufen, den Cluster-Kontext auszuwählen und PersistentVolumeClaim.yaml sowie example-rwx-deployment.yaml anzuwenden. Prüfe gebundene PVCs und vier laufende Pods auf mindestens zwei verschiedenen Nodes. Lies /data/index.html aus Writer-Containern auf verschiedenen Nodes und prüfe Einträge mehrerer Pod-Hostnamen.

Die Demonstration belegt gemeinsamen Zugriff über Node-Grenzen hinweg. Sie belegt weder die Durchsetzung von RWX-Zugriffsmodi durch Kubernetes noch Anwendungskonsistenz, Durchsatz oder Wiederherstellungsverhalten.

Export-Regeln, Root-Squashing, zusätzliche Shares, Backup-Regeln und die Sicherheitseinstellungen der Anwendungs-Pods erfordern Änderungen an Terraform oder Manifesten; sie sind nicht alle als Variablen verfügbar. Behandle Änderungen an Region und Platzierung als Architekturänderungen und prüfe den resultierenden Terraform-Plan.

Grenzen und Entscheidungen für den Produktivbetrieb

Abschnitt betitelt „Grenzen und Entscheidungen für den Produktivbetrieb“
  • Parallele Schreibzugriffe: Gemeinsamer Speicher macht eine Anwendung nicht automatisch für mehrere Writer geeignet. Prüfe Dateisperren, Berechtigungen und Aktualisierungsverhalten. Aus der reinen Append-Demo lässt sich keine Eignung für Datenbanken ableiten.
  • Kapazität und Isolation: Der generische NFS-CSI-Treiber provisioniert Unterverzeichnisse eines bestehenden Shares. Ein PVC-Request erzeugt weder einen eigenen SFS-Share noch eine durch diesen Blueprint konfigurierte Verzeichnisquota. Plane gemeinsame Kapazität und Mandantentrennung ausdrücklich.
  • Zugriffsschutz: IP-ACLs identifizieren Netzwerk-Clients, keine einzelnen Pods. Prüfe Export-Policy-Rechte und passende UID/GID-Einstellungen der Container. Das Beispiel setzt super_user nicht; laut Quellcode gewährt der API-Standard Root-Zugriff. Prüfe Root-Squashing ausdrücklich vor dem Einsatz über Vertrauensgrenzen hinweg.
  • Verfügbarkeit und Wiederherstellung: Der voreingestellte Worker-Pool nutzt eine Availability Zone. Zwei Nodes zeigen gemeinsamen Zugriff, keine Ausfallsicherheit über Zonen. Der Blueprint konfiguriert weder Backup-Zeitpläne und Restore-Tests noch Anwendungs-Failover oder Monitoring; sichtbare Snapshots allein ergeben keine Backup-Strategie.
  • State und Zugangsdaten: Die voreingestellte Übergabe liest einen lokalen State. Schütze beide States und Zugangsdaten; passe Backend und Zugriffsmodell für den Teambetrieb an. Die ephemere Helm-Authentifizierung hält diese Kubeconfig aus dem State, ersetzt aber keinen allgemeinen State-Schutz. Die README von Stufe 2 beschreibt Einschränkungen für Imports, solange der Cluster nicht existiert.
  • Demo-Anwendung: nginx-Endpunkt und Writer demonstrieren die Funktion. Produktive Authentifizierung, TLS, Ressourcenbemessung und Anwendungshärtung sind nicht enthalten. Das Deployment nutzt Recreate und zeigt daher keine unterbrechungsfreien Rollouts.

Entferne die Demonstration nach der Anleitung in der README von Stufe 2, bevor du Terraform-Ressourcen löschst. Terraform verwaltet ihren LoadBalancer-Service nicht. Die StorageClass nutzt reclaimPolicy: Retain: Beim Löschen eines PVCs bleiben PV und Daten erhalten. Auch das Löschen des aufbewahrten PV-Objekts entfernt dessen Verzeichnis auf dem Share nicht; entscheide bewusst über Archivierung oder Löschung dieser Dateien.

Baue zuerst 02-cluster und danach 01-storage ab. Das Löschen von Stufe 1 entfernt auch SFS-Share und Pool. Kubernetes-Retain schützt somit nicht vor dem Löschen der Storage-Infrastruktur.

Implementierung und Stufen-READMEs sind die Referenz für Befehle, Vorgaben und Fehlerbehebung. Die STACKIT-File-Storage-Dokumentation beschreibt aktuelle Service-Funktionen und Grenzen. Das Quellbeispiel nennt Markus Brunsch in MAINTAINERS.md als technischen Maintainer.

Code & Registry github.com SKE- und File-Storage-Blueprint öffnen Terraform-Stufen, konfigurierbare Eingaben, Demo-Manifeste sowie Anleitungen für Prüfung und Bereinigung im Professional-Service-Repository. Repository öffnen