Zum Hauptinhalt springen

Mit Docker Compose betreiben

Docker Compose ist der schnellste Weg, einen echten Zaris-Cluster auf Ihrem eigenen Rechner zu betreiben. Ein Befehl startet einen 3-Node-Cluster, einen Management Service und die Web Console, mit einem bereits für Sie erstellten Store. Es verwendet exakt dieselbe Client-API wie jeder andere Modus — nur die Connection String zeigt statt auf inproc auf eine Netzwerkadresse.

Voraussetzungen​

Sie benötigen Docker mit Compose v2 (docker compose, in Docker Desktop enthalten). Eine Zaris-Installation ist nicht erforderlich — die Images werden für Sie geladen.

1. Die Compose-Datei herunterladen​

Laden Sie die veröffentlichte Quick-Start-Compose-Datei herunter:

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

https://clustron.io/quick-start.yml ist die kanonische URL, die die Maintainer hosten. Bis sie veröffentlicht ist, verwenden Sie stattdessen die Datei compose/quick-start.yml aus dem Release-Bundle — die folgenden Befehle sind identisch, sobald Sie die Datei lokal haben.

2. Den Cluster starten​

Starten Sie alles im Hintergrund:

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

Dies startet einen 3-Node-Zaris-Cluster, einen Management Service und die Web Console. Ein Bootstrap-Dienst erstellt automatisch einen Store namens demo, sodass Sie keinen Schritt zur Store-Erstellung selbst ausführen müssen.

Die Web Console ist erreichbar unter:

http://localhost:7810

3. Verbinden​

Aus einer Anwendung, die auf Ihrem Host läuft, verbinden Sie sich über den Client-Port mit dem Store:

zaris://localhost:7861/demo

Aus einem anderen Container im selben Compose-Netzwerk verbinden Sie sich über die Service-Namen mit den Nodes:

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

Wenn Sie alle drei Nodes auflisten, hat der Client mehr als einen Seed als Ausgangspunkt und kann sich auch verbinden, wenn ein Node nicht verfügbar ist.

4. Abbauen​

Wenn Sie fertig sind, stoppen Sie den Cluster und entfernen Sie seine Volumes:

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

Was Sie gerade getan haben​

Sie haben mit einem einzigen Befehl einen echten 3-Node-Zaris-Cluster auf Ihrem Laptop gestartet, komplett mit Management Service, Web Console und einem sofort nutzbaren Store demo. Die Client-API ist identisch mit dem In-Process-Modus — nur die Connection String hat sich geändert.

Nächste Schritte​