Aller au contenu principal

Créer votre premier store

Cet article crée et démarre un store Clustron Zaris depuis la ligne de commande, puis connecte un client et stocke une valeur. À la fin, vous disposez d'un store distribué en cours d'exécution depuis lequel vous pouvez lire et écrire.

remarque

Cet article suppose que Zaris est déjà installé. Si ce n'est pas le cas, suivez d'abord Installation.

Les étapes utilisent deux jeux de cmdlets PowerShell. Les cmdlets d'administration (New-ZrWorkspace, New-ZrStore, Start-ZrStore) gèrent le store à travers le manager. Les cmdlets client (Connect-ZrStore, Set-ZrItem, Get-ZrItem) lisent et écrivent les données.

1. Créer un espace de travail et se connecter au manager​

Le manager coordonne le cluster. Un espace de travail est une connexion nommée vers un ou plusieurs managers que les cmdlets d'administration ciblent. Créez-en un qui pointe vers le manager local sur son port par défaut, 7801, et activez-le avec -Activate, avant de créer un store.

New-ZrWorkspace local -Managers localhost:7801 -Activate

Si un espace de travail portant ce nom existe déjà, ou si le manager fait déjà partie d'un autre espace de travail, activez-le ou rejoignez-le à la place :

Use-ZrWorkspace local -Managers localhost:7801

2. Créer un store​

Définissez un store nommé TestStore qui exécute deux nœuds sur cette machine. PartitionsPerNode définit combien de processus de partition s'exécutent par machine, et ReplicationFactor définit combien de copies de chaque partition conserver (1 signifie aucun réplica). BaseClusterPort est le port de départ que les nœuds utilisent pour se parler entre eux, et BaseClientPort est le port de départ auquel les clients se connectent ; les ports sont attribués en incrémentant ces valeurs de base, une par processus.

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

Cela définit le store mais ne le démarre pas encore.

3. Démarrer le store​

Démarrez le store pour mettre ses nœuds en ligne et former le cluster.

Start-ZrStore TestStore

4. Connecter un client​

Connectez un client au store via l'un de ses points d'accès client. Le point d'accès est l'hôte et le port client que vous avez définis à l'étape 2.

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

La chaîne de connexion porte tout ce dont le client a besoin : zaris:// sélectionne une connexion en clair, localhost:7861 est le point d'accès client à utiliser comme amorce, et le chemin /TestStore est le nom du store.

5. Stocker et lire une valeur​

Stockez une valeur avec Set-ZrItem, puis relisez-la avec Get-ZrItem.

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

Get-ZrItem -Key "order:1001"

Ce que vous venez de faire​

Vous disposez d'un store Zaris distribué en cours d'exécution et d'un client connecté, créés entièrement depuis la ligne de commande. À partir d'ici, vous pouvez configurer le store pour la production, vous y connecter depuis vos applications .NET, ou commencer à utiliser des primitives de coordination telles que les verrous, les baux et les compteurs.

Étapes suivantes​