Aller au contenu principal

Exécuter avec Docker Compose

Docker Compose est le moyen le plus rapide d'exécuter un véritable cluster Zaris sur votre propre machine. Une seule commande met en service un cluster de 3 nœuds, un service de gestion et la console web, avec un store déjà créé pour vous. Il utilise exactement la même API cliente que tous les autres modes — seule la chaîne de connexion pointe vers une adresse réseau au lieu de inproc.

Prérequis​

Vous avez besoin de Docker avec Compose v2 (docker compose, inclus avec Docker Desktop). Aucune installation de Zaris n'est requise — les images sont récupérées pour vous.

1. Télécharger le fichier Compose​

Téléchargez le fichier Compose de démarrage rapide publié :

curl -fL https://clustron.io/quick-start.yml -o quick-start.yml
remarque

https://clustron.io/quick-start.yml est l'URL canonique hébergée par les mainteneurs. Tant qu'elle n'est pas publiée, utilisez plutôt le fichier compose/quick-start.yml du bundle de release — les commandes ci-dessous sont identiques une fois que vous disposez du fichier en local.

2. Démarrer le cluster​

Mettez tout en service en arrière-plan :

docker compose -f quick-start.yml up -d

Ceci démarre un cluster Zaris de 3 nœuds, un service de gestion et la console web. Un service d'amorçage crée automatiquement un store nommé demo, il n'y a donc aucune étape de création de store à exécuter vous-même.

La console web est disponible à l'adresse :

http://localhost:7810

3. Se connecter​

Depuis une application s'exécutant sur votre hôte, connectez-vous au store sur le port client :

zaris://localhost:7861/demo

Depuis un autre conteneur sur le même réseau Compose, connectez-vous aux nœuds par leurs noms de service :

zaris://zaris-0:7861,zaris-1:7861,zaris-2:7861/demo

Lister les trois nœuds donne au client plus d'une amorce à partir de laquelle démarrer, de sorte qu'il peut se connecter même si un nœud est indisponible.

4. Démanteler​

Lorsque vous avez terminé, arrêtez le cluster et supprimez ses volumes :

docker compose -f quick-start.yml down -v

Ce que vous venez de faire​

Vous avez mis en service un véritable cluster Zaris de 3 nœuds sur votre ordinateur portable avec une seule commande, complet avec un service de gestion, la console web et un store demo prêt à l'emploi. L'API cliente est identique au mode in-process — seule la chaîne de connexion a changé.

Étapes suivantes​