Saltar al contenido principal

Crea tu primer almacén

Este artículo crea e inicia un almacén de Clustron Zaris desde la línea de comandos, luego conecta un cliente y almacena un valor. Al final tendrás un almacén distribuido en ejecución del que podrás leer y escribir.

nota

Este artículo asume que Zaris ya está instalado. Si no lo está, sigue primero Instalación.

Los pasos usan dos conjuntos de cmdlets de PowerShell. Los cmdlets de administración (New-ZrWorkspace, New-ZrStore, Start-ZrStore) gestionan el almacén a través del manager. Los cmdlets de cliente (Connect-ZrStore, Set-ZrItem, Get-ZrItem) leen y escriben datos.

1. Crea un workspace y conéctate al manager​

El manager coordina el clúster. Un workspace es una conexión con nombre a uno o más managers a los que apuntan los cmdlets de administración. Crea uno que apunte al manager local en su puerto predeterminado, 7801, y actívalo con -Activate, antes de crear un almacén.

New-ZrWorkspace local -Managers localhost:7801 -Activate

Si ya existe un workspace con ese nombre, o el manager ya forma parte de otro workspace, actívalo o únete a él en su lugar:

Use-ZrWorkspace local -Managers localhost:7801

2. Crea un almacén​

Define un almacén llamado TestStore que ejecuta dos nodos en esta máquina. PartitionsPerNode establece cuántos procesos de partición se ejecutan por máquina, y ReplicationFactor establece cuántas copias de cada partición mantener (1 significa sin réplicas). BaseClusterPort es el puerto inicial que los nodos usan para hablar entre sí, y BaseClientPort es el puerto inicial al que se conectan los clientes; los puertos se asignan incrementando estos valores base, uno por proceso.

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

Esto define el almacén pero aún no lo inicia.

3. Inicia el almacén​

Inicia el almacén para poner sus nodos en línea y formar el clúster.

Start-ZrStore TestStore

4. Conecta un cliente​

Conecta un cliente al almacén a través de uno de sus endpoints de cliente. El endpoint es el host y el puerto de cliente que estableciste en el paso 2.

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

La cadena de conexión lleva todo lo que el cliente necesita: zaris:// selecciona una conexión en texto plano, localhost:7861 es el endpoint de cliente desde el que sembrar, y la ruta /TestStore es el nombre del almacén.

5. Almacena y lee un valor​

Almacena un valor con Set-ZrItem, luego vuelve a leerlo con Get-ZrItem.

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

Get-ZrItem -Key "order:1001"

Lo que acabas de hacer​

Tienes un almacén Zaris distribuido en ejecución y un cliente conectado, creados por completo desde la línea de comandos. Desde aquí puedes configurar el almacén para producción, conectarte a él desde tus aplicaciones .NET, o empezar a usar primitivas de coordinación como locks, leases y contadores.

Próximos pasos​