Kubernetes: Verwendung von Helm
Für die Installation auf Kubernetes ist ein Helm-Chart in unserem Charts-Repository verfügbar. Der Quellcode des Charts ist auf GitHub fivenet-app/charts verfügbar.
Prüfen Sie vor Beginn die Anforderungen und stellen Sie sicher, dass Datenbank, NATS-Server, Storage, Domain und Cluster-Ingress bereit sind.
0. Voraussetzungen
Diese Anleitung setzt voraus, dass Sie über einen funktionierenden Kubernetes-Cluster und einen installierten Helm-Client verfügen. Falls Sie noch keinen Kubernetes-Cluster eingerichtet haben, lesen Sie bitte die Kubernetes-Installationsanleitung. Sie können jeden Kubernetes-Cluster verwenden, einschließlich lokaler Cluster wie Minikube oder KinD, oder Cloud-Anbieter wie GKE, EKS oder AKS.
1. Helm-Chart-Repository hinzufügen
Fügen Sie das FiveNet-Helm-Chart-Repository zu Ihrem Helm-Client hinzu:
helm repo add fivenet https://fivenet.app/charts
helm repo update
2. Namespace erstellen
Erstellen Sie einen eigenen Namespace für FiveNet, falls Sie noch keinen haben:
kubectl create namespace fivenet
3. Aktuelle values.yaml abrufen
Laden Sie die Standard-values.yaml-Datei für das Helm-Chart herunter, um Ihre Bereitstellung zu konfigurieren:
helm show values fivenet/fivenet > values.yaml
4. values.yaml konfigurieren
Bearbeiten Sie die values.yaml-Datei entsprechend Ihren Bereitstellungsanforderungen. Folgen Sie der Anleitung FiveNet konfigurieren für die erforderlichen Einstellungen in .fivenet.config und verwenden Sie anschließend die Konfigurationsdatei-Referenz für einzelne Optionen.
Prüfen Sie mindestens die FiveNet-Konfiguration, Secrets, Persistenz und wie die Bereitstellung in Ihrem Cluster erreichbar sein soll.
5. FiveNet installieren oder aktualisieren
Deployen oder aktualisieren Sie FiveNet in Ihrem Kubernetes-Cluster mit der konfigurierten values.yaml-Datei:
helm upgrade --install fivenet fivenet/fivenet \
--namespace fivenet \
-f values.yaml
6. Bereitstellung überprüfen
Nachdem das Helm-Release installiert wurde, prüfen Sie, ob die Workloads korrekt starten:
kubectl get pods -n fivenet
helm status fivenet -n fivenet
Stellen Sie sicher, dass FiveNet extern erreichbar ist, wie in Ihrer values.yaml konfiguriert, zum Beispiel über Ihren Ingress, Service, Hostnamen und TLS-Einstellungen.
7. Nach der Installation
Nach der Installation folgen Sie den Schritten nach der Installation, um die Einrichtung abzuschließen.
Fehlerbehebung
Für häufige Probleme während der Kubernetes- oder Helm-Installation, wie z. B. datenbankbezogene Fehler, lesen Sie die Seite Datenbank- und Installationsfehlerbehebung.