Saltar al contenido principal

Ejecutar en Kubernetes

El chart Helm de Zaris despliega un clúster Zaris en Kubernetes como un StatefulSet, con el Servicio de Gestión y los endpoints de cliente expuestos como Services. El chart sirve un almacén de forma nativa, por lo que no hay ningún paso de creación de almacén — el almacén está listo en cuanto el clúster está levantado. La API de cliente es la misma que usan todos los demás modos.

Requisitos previos​

Necesitas un clúster Kubernetes y las herramientas de línea de comandos kubectl y helm (v3) configuradas para hablar con él. Cualquier clúster conforme funciona, incluido uno local como kind o minikube.

1. Instala el chart​

Instala el chart desde el registro OCI en su propio namespace, con tres nodos y un factor de replicación de dos:

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

La ruta OCI oci://registry-1.docker.io/clustron/zaris es la ubicación de publicación prevista. Hasta que las imágenes y el chart se publiquen, instala desde el archivo del chart en el paquete de lanzamiento en su lugar:

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

2. Espera al clúster​

Espera a que el StatefulSet termine de desplegarse:

kubectl -n zaris rollout status statefulset/zaris

3. Conecta​

El chart sirve un almacén cuyo nombre es igual al id del clúster — zaris-k8s por defecto — de modo que no se necesita ningún paso de creación de almacén.

Desde una carga de trabajo que se ejecuta dentro del clúster, conéctate a través del Service de cliente:

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

Para el acceso desde fuera del clúster, Zaris usa TLS en el puerto externo anunciado:

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

El acceso externo requiere que el listener externo esté habilitado y un certificado de CA para que el cliente confíe. Consulta Despliegue en Kubernetes y Conexión de cliente asegurada para la configuración completa.

4. Desmonta​

Elimina el release:

helm uninstall zaris -n zaris

Lo que acabas de hacer​

Desplegaste un clúster Zaris en Kubernetes con Helm, con un almacén listo para usar en el momento en que el StatefulSet terminó de desplegarse. Conectarse es solo una cadena de conexión — la misma API de cliente que todos los demás modos.

Próximos pasos​