Ejecutar con Docker Compose
Docker Compose es la forma más rápida de ejecutar un clúster Zaris real en tu propia máquina. Un solo comando levanta un clúster de 3 nodos, un Servicio de Gestión y la Consola Web, con un almacén ya creado para ti. Usa exactamente la misma API de cliente que todos los demás modos — solo la cadena de conexión apunta a una dirección de red en lugar de a inproc.
Requisitos previos
Necesitas Docker con Compose v2 (docker compose, incluido con Docker Desktop). No se requiere ninguna instalación de Zaris — las imágenes se descargan por ti.
1. Descarga el archivo Compose
Descarga el archivo Compose de inicio rápido publicado:
curl -fL https://clustron.io/quick-start.yml -o quick-start.yml
https://clustron.io/quick-start.yml es la URL canónica que alojan los mantenedores. Hasta que se publique, usa el archivo compose/quick-start.yml del paquete de lanzamiento en su lugar — los comandos de abajo son idénticos una vez que tienes el archivo localmente.
2. Inicia el clúster
Levanta todo en segundo plano:
docker compose -f quick-start.yml up -d
Esto inicia un clúster Zaris de 3 nodos, un Servicio de Gestión y la Consola Web. Un servicio de arranque crea un almacén llamado demo automáticamente, de modo que no hay ningún paso de creación de almacén que ejecutar tú mismo.
La Consola Web está disponible en:
http://localhost:7810
3. Conecta
Desde una aplicación que se ejecuta en tu host, conéctate al almacén en el puerto de cliente:
zaris://localhost:7861/demo
Desde otro contenedor en la misma red de Compose, conéctate a los nodos por sus nombres de servicio:
zaris://zaris-0:7861,zaris-1:7861,zaris-2:7861/demo
Listar los tres nodos le da al cliente más de un seed desde el que empezar, de modo que puede conectarse aunque uno de los nodos no esté disponible.
4. Desmonta
Cuando hayas terminado, detén el clúster y elimina sus volúmenes:
docker compose -f quick-start.yml down -v
Lo que acabas de hacer
Levantaste un clúster Zaris real de 3 nodos en tu portátil con un solo comando, completo con un Servicio de Gestión, la Consola Web y un almacén demo listo para usar. La API de cliente es idéntica a la del modo en proceso — solo cambió la cadena de conexión.