Betten Sie es in Sekunden in Ihre .NET-Anwendung ein oder betreiben Sie einen Server oder Cluster mit Docker, Compose oder Kubernetes — derselbe Client und dieselbe Connection String erreichen sie alle.
Lassen Sie Ihren KI-Coding-Agenten Zaris für Sie installieren und prüfen. Er erkennt Ihre Umgebung — In-Process, Docker, Kubernetes oder Windows — und führt den passenden Weg durchgängig aus.
1 · Fügen Sie Ihrem Agenten den Zaris-Skill hinzu
npx skills add clustron/zaris
2 · Dann einfach fragen
Install Clustron Zaris and set it up so I can connect to a store.
Fügen Sie das .NET-SDK hinzu und betreiben Sie einen vollständigen Store im eigenen Prozess — ideal für Entwicklung und Tests. Derselbe Client verbindet sich auch mit jedem Zaris-Cluster, ohne Codeänderungen.
# Add the Clustron Zaris SDK to your project
dotnet add package Clustron.Zaris.SDK
using Clustron.Zaris.Client.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;
// An embedded, in-process store — no servers, no install.
// In-process is just a connection string: zaris://inproc/demo
var sp = new ServiceCollection()
.AddClustronZaris("demo", "zaris://inproc/demo")
.BuildServiceProvider();
Hosten Sie überall selbst — Ihre Daten verlassen nie Ihre Umgebung. Laden Sie von Docker Hub oder installieren Sie das Windows-Paket. Wählen Sie Ihre Plattform:
# Pull the compose file and start a 4-node cluster + web console
curl -fL https://clustron.io/quick-start.yml | docker compose -f - up -d
Standard ist 4 Nodes bei RF 2 (2 Partitionen, jeweils repliziert — übersteht den Verlust eines Nodes). Brauchen Sie eine andere Größe? Speichern Sie die Datei (curl -fL https://clustron.io/quick-start.yml -o quick-start.yml) und bearbeiten Sie die Node-Liste — die Node-Anzahl muss ein Vielfaches des Replikationsfaktors sein (bei RF 2 gerade).
Öffnen Sie http://localhost:7810 — der Store demo erscheint, und seine 3 Nodes werden gesund. Oder prüfen Sie die Datenebene über die Shell:
# Prove the data plane: put a key and read it back (runs inside the manager container)
docker exec $(docker ps -qf name=manager) pwsh -Command "Connect-ZrStore -ConnectionString 'zaris://zaris-0:7861/demo'; Set-ZrItem hello world; Get-ZrItem hello"
# Point your app at the store — the path segment is the store name
zaris://localhost:7861/demo
# One command: 4 nodes at RF 2 (2 partitions x 2 copies), store auto-attached.
helm install zaris oci://registry-1.docker.io/clustron/zaris -n zaris --create-namespace
Der Store wird beim Deployment automatisch angebunden — keine manuelle Registrierung. Ändern Sie die Größe mit --set node.replicas / --set node.replicationFactor (replicas muss ein Vielfaches des Replikationsfaktors bleiben: RF 2 → 4, 6, …).
# Open the console (private port-forward — works on any cluster):
kubectl -n zaris port-forward svc/zaris-manager-console 8080:7810
# -> http://localhost:8080
# Connect from inside the cluster
zaris://zaris-client.zaris.svc.cluster.local:7861/zaris-k8s
Das Absichern des Workspace, das Bereitstellen der Konsole über HTTPS, dedizierte Cache-Node-Pools und cloudspezifische Schritte für AKS / EKS / GKE / OpenShift finden Sie in den Leitfäden unten.
# In the extracted folder, in a terminal running as Administrator
# (or right-click install.cmd -> Run as administrator)
.\install.cmd
Registriert den Management Service & die Web-Konsole als Windows-Dienste sowie die PowerShell-Module.
# 1) Point a workspace at the local Management Service (:7801) and activate it
New-ZrWorkspace -Name local -Managers "localhost:7801" -Activate
# 2) Create the store — supervisor mode forks the node processes.
# BaseClientPort is the port your app connects to.
New-ZrStore -Name orders -ReplicationFactor 2 `
-BaseClusterPort 7811 -BaseClientPort 7861
Oder erledigen Sie alles in der Web-Konsole unter http://localhost:7810 (kein Workspace-Cmdlet nötig — fügen Sie den Manager in der Oberfläche hinzu).
# Connect to the store you created (BaseClientPort 7861 above)
zaris://localhost:7861/orders
Richten Sie Ihre Anwendung mit einer einzigen Connection String auf den Store. Welche Hosts Sie verwenden, hängt davon ab, wo Ihre Anwendung läuft — im selben Netzwerk oder Cluster oder außerhalb davon.
Läuft Ihre Anwendung neben dem Store — als weiterer Compose-Dienst oder als Pod im selben Cluster —, erreichen Sie ihn direkt über das interne Netzwerk.
# Docker Compose — app on the same network
zaris://zaris-0:7861,zaris-1:7861,zaris-2:7861/demo
# Kubernetes — in-cluster
zaris://zaris-client.zaris.svc.cluster.local:7861/zaris-k8s
# Local quick-start — from your host (Docker quick-start)
zaris://localhost:7861/demo
Standardmäßig bewirbt der Cluster Adressen innerhalb des Netzwerks. Um ihn von außen zu erreichen, aktivieren Sie den externen Zugriff — jeder Node bewirbt zusätzlich eine extern erreichbare Adresse auf einem zweiten Listener, abgesichert mit TLS.
# Docker Compose or Kubernetes — external access (TLS + cluster CA)
zariss://node-1.example.com:7863,node-2.example.com:7863/zaris-k8s?ca=/path/ca.pem
Erfordert aktivierten externen Zugriff (beworbene Adressen). Verwenden Sie zariss:// mit der Cluster-CA — und ?token=env:VAR, falls die Token-Authentifizierung aktiv ist.
Legen Sie die Connection String in DI oder appsettings.json ab. Das Pfadsegment ist der Store-Name — er entspricht der Cluster-ID; der DI-Schlüssel ist nur eine lokale Bezeichnung. Kommagetrennte Hosts sind eine Seed-Liste mit automatischem Failover.
using Clustron.Zaris.Client.DependencyInjection;
// The store name in the path IS the cluster id — set it in one place.
services.AddClustronZaris(
"demo", "zaris://localhost:7861/demo");
// …or from appsettings.json:
// "ConnectionStrings": { "demo": "zaris://localhost:7861/demo" }
services.AddClustronZarisFromConnectionStrings(configuration);
// Resolve and use it:
var provider = sp.GetRequiredService<IZarisClientProvider>();
var client = await provider.GetAsync("demo");
await client.PutAsync("k", "v");
Nodus — Peer-to-Peer-Mitgliedschaft, Leader-Election und typisiertes Messaging — ist ein einzelnes NuGet-Paket, das Sie in Ihren .NET-Dienst einbetten. Kein Paket zu hosten, kein Server zu betreiben.
dotnet add package Clustron.Nodus.Client
Durchsuchen Sie alle Releases oder lesen Sie die Richtlinie zu Versionierung und Kompatibilität.