Aller au contenu principal

Exécuter sur Kubernetes

Le chart Helm de Zaris déploie un cluster Zaris sur Kubernetes sous forme de StatefulSet, avec le service de gestion (Management Service) et les points de terminaison clients exposés comme des Services. Le chart sert un store nativement, il n'y a donc pas d'étape de création de store — le store est prêt dès que le cluster est en ligne. L'API client est la même que celle que tous les autres modes utilisent.

Prérequis​

Vous avez besoin d'un cluster Kubernetes et des outils en ligne de commande kubectl et helm (v3) configurés pour dialoguer avec lui. Tout cluster conforme fonctionne, y compris un cluster local tel que kind ou minikube.

1. Installer le chart​

Installez le chart depuis le registre OCI dans son propre espace de noms, avec trois nœuds et un facteur de réplication de deux :

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

Le chemin OCI oci://registry-1.docker.io/clustron/zaris est l'emplacement de publication prévu. Tant que les images et le chart ne sont pas publiés, installez plutôt depuis l'archive du chart présente dans le bundle de version :

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

2. Attendre le cluster​

Attendez que le StatefulSet termine son déploiement progressif :

kubectl -n zaris rollout status statefulset/zaris

3. Se connecter​

Le chart sert un store dont le nom est égal à l'id du cluster — zaris-k8s par défaut — de sorte qu'aucune étape de création de store n'est nécessaire.

Depuis une charge de travail s'exécutant à l'intérieur du cluster, connectez-vous via le Service client :

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

Pour un accès depuis l'extérieur du cluster, Zaris utilise TLS sur le port externe annoncé :

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

L'accès externe requiert que l'écouteur externe soit activé et un certificat CA auquel le client puisse faire confiance. Voir Déploiement Kubernetes et Connexion cliente sécurisée pour la configuration complète.

4. Démanteler​

Supprimez la release :

helm uninstall zaris -n zaris

Ce que vous venez de faire​

Vous avez déployé un cluster Zaris sur Kubernetes avec Helm, avec un store prêt à l'emploi dès l'instant où le StatefulSet a terminé son déploiement progressif. Se connecter n'est qu'une affaire de chaîne de connexion — la même API client que tous les autres modes.

Étapes suivantes​