Zum Hauptinhalt springen

Auf Kubernetes betreiben

Das Zaris-Helm-Chart stellt einen Zaris-Cluster als StatefulSet in Kubernetes bereit, wobei der Management Service und die Client-Endpunkte als Services bereitgestellt werden. Das Chart betreibt einen Store nativ, sodass kein Schritt zur Store-Erstellung nötig ist — der Store ist bereit, sobald der Cluster läuft. Die Client-API ist dieselbe wie in jedem anderen Modus.

Voraussetzungen​

Sie benötigen einen Kubernetes-Cluster sowie die Befehlszeilenwerkzeuge kubectl und helm (v3), die für die Kommunikation mit ihm konfiguriert sind. Jeder konforme Cluster funktioniert, auch ein lokaler wie kind oder minikube.

1. Das Chart installieren​

Installieren Sie das Chart aus der OCI-Registry in einem eigenen Namespace, mit drei Nodes und einem Replikationsfaktor von zwei:

helm install zaris oci://registry-1.docker.io/clustron/zaris \
  --namespace zaris --create-namespace \
  --set node.replicas=3 --set node.replicationFactor=2
hinweis

Der OCI-Pfad oci://registry-1.docker.io/clustron/zaris ist der vorgesehene Veröffentlichungsort. Bis die Images und das Chart veröffentlicht sind, installieren Sie stattdessen aus dem Chart-Archiv im Release-Bundle:

helm install zaris ./zaris-0.1.0.tgz \
  --namespace zaris --create-namespace \
  --set node.replicas=3 --set node.replicationFactor=2

2. Auf den Cluster warten​

Warten Sie, bis das StatefulSet seinen Rollout abgeschlossen hat:

kubectl -n zaris rollout status statefulset/zaris

3. Verbinden​

Das Chart betreibt einen Store, dessen Name der Cluster-ID entspricht — standardmäßig zaris-k8s —, sodass kein Schritt zur Store-Erstellung nötig ist.

Aus einer Workload, die innerhalb des Clusters läuft, verbinden Sie sich über den Client-Service:

zaris://zaris-client.zaris.svc.cluster.local:7861/zaris-k8s

Für den Zugriff von außerhalb des Clusters verwendet Zaris TLS auf dem beworbenen externen Port:

zariss://<external-host>:7863/zaris-k8s?ca=/path/to/ca.pem

Für den externen Zugriff muss der externe Listener aktiviert sein und der Client ein CA-Zertifikat besitzen, dem er vertraut. Das vollständige Setup finden Sie unter Kubernetes-Deployment und Abgesicherte Client-Verbindung.

4. Abbauen​

Entfernen Sie das Release:

helm uninstall zaris -n zaris

Was Sie gerade getan haben​

Sie haben einen Zaris-Cluster mit Helm in Kubernetes bereitgestellt, mit einem Store, der einsatzbereit war, sobald das StatefulSet seinen Rollout abgeschlossen hatte. Das Verbinden ist nur eine Connection String — dieselbe Client-API wie in jedem anderen Modus.

Nächste Schritte​