Zum Hauptinhalt springen

Ersten Store erstellen

In diesem Artikel erstellen und starten Sie einen Clustron-Zaris-Store über die Befehlszeile, verbinden dann einen Client und speichern einen Wert. Am Ende haben Sie einen laufenden verteilten Store, aus dem Sie lesen und in den Sie schreiben können.

hinweis

Dieser Artikel setzt voraus, dass Zaris bereits installiert ist. Falls nicht, folgen Sie zuerst der Installation.

Die Schritte verwenden zwei Gruppen von PowerShell-Cmdlets. Die Admin-Cmdlets (New-ZrWorkspace, New-ZrStore, Start-ZrStore) verwalten den Store über den Manager. Die Client-Cmdlets (Connect-ZrStore, Set-ZrItem, Get-ZrItem) lesen und schreiben Daten.

1. Workspace erstellen und mit dem Manager verbinden​

Der Manager koordiniert den Cluster. Ein Workspace ist eine benannte Verbindung zu einem oder mehreren Managern, auf die die Admin-Cmdlets zielen. Erstellen Sie einen, der auf den lokalen Manager an dessen Default-Port 7801 zeigt, und aktivieren Sie ihn mit -Activate, bevor Sie einen Store erstellen.

New-ZrWorkspace local -Managers localhost:7801 -Activate

Falls bereits ein Workspace mit diesem Namen existiert oder der Manager schon Teil eines anderen Workspace ist, aktivieren Sie ihn stattdessen oder treten ihm bei:

Use-ZrWorkspace local -Managers localhost:7801

2. Store erstellen​

Definieren Sie einen Store namens TestStore, der zwei Nodes auf diesem Rechner betreibt. PartitionsPerNode legt fest, wie viele Partition-Prozesse pro Rechner laufen, und ReplicationFactor bestimmt, wie viele Kopien jeder Partition vorgehalten werden (1 bedeutet keine Replikate). BaseClusterPort ist der Start-Port, über den Nodes miteinander kommunizieren, und BaseClientPort ist der Start-Port, mit dem sich Clients verbinden; die Ports werden durch Hochzählen dieser Basiswerte vergeben, einer pro Prozess.

New-ZrStore `
  -Name TestStore `
  -PartitionsPerNode 2 `
  -ReplicationFactor 1 `
  -BaseClusterPort 7811 `
  -BaseClientPort 7861

Dies definiert den Store, startet ihn aber noch nicht.

3. Store starten​

Starten Sie den Store, um seine Nodes online zu bringen und den Cluster zu bilden.

Start-ZrStore TestStore

4. Client verbinden​

Verbinden Sie einen Client über einen der Client-Endpunkte mit dem Store. Der Endpunkt besteht aus dem Host und dem Client-Port, den Sie in Schritt 2 festgelegt haben.

Connect-ZrStore -ConnectionString "zaris://localhost:7861/TestStore"

Die Connection String enthält alles, was der Client braucht: zaris:// wählt eine unverschlüsselte Verbindung, localhost:7861 ist der Client-Endpunkt, von dem aus gestartet wird, und der Pfad /TestStore ist der Store-Name.

5. Einen Wert speichern und lesen​

Speichern Sie einen Wert mit Set-ZrItem und lesen Sie ihn anschließend mit Get-ZrItem zurück.

Set-ZrItem -Key "order:1001" -Value "confirmed"

Get-ZrItem -Key "order:1001"

Was Sie gerade getan haben​

Sie haben einen laufenden verteilten Zaris-Store und einen verbundenen Client, vollständig über die Befehlszeile erstellt. Von hier aus können Sie den Store für die Produktion konfigurieren, sich aus Ihren .NET-Anwendungen mit ihm verbinden oder Koordinationsprimitive wie Locks, Leases und Counter verwenden.

Nächste Schritte​