Espace de travail
Un espace de travail est une connexion nommée côté client vers un ensemble de managers. C'est ainsi que la CLI et la console web ciblent un cluster ; ce n'est ni un serveur ni un store.
Ce qu'est un espace de travail
Un espace de travail est un pointeur nommé, enregistré sur la machine depuis laquelle vous administrez, qui consigne à quels managers vos commandes d'administration parlent. Il contient un nom, la liste des points de terminaison des managers (chacun écrit sous la forme host:port, avec le port de gestion 7801 par défaut), un token d'administration optionnel et le mode de déploiement du cluster. Vous en créez un avec New-ZrWorkspace et vous en faites la cible active avec Use-ZrWorkspace.
Un espace de travail est purement un signet côté client. Créer un espace de travail ou en changer ne démarre, n'arrête ni ne modifie aucun serveur, nœud ou store — cela change seulement les managers que votre session adresse. L'espace de travail PowerShell est le pendant de l'espace de travail de la console web : les deux ont la même forme (id, nom, managers, token), de sorte que les deux outils décrivent le même cluster de la même façon.
# Create a workspace named "prod" targeting two managers, then activate it
New-ZrWorkspace -Name "prod" -Managers "10.0.0.10:7801","10.0.0.11:7801"
Use-ZrWorkspace prod
Ce qu'un espace de travail n'est pas
Parce que les termes sont faciles à confondre, il est utile d'énoncer les frontières directement.
- Un espace de travail n'est pas un serveur. Un serveur est une vraie machine qui exécute Zaris ; un espace de travail est une liste des points de terminaison de gestion des serveurs, stockée de votre côté.
- Un espace de travail n'est pas un store. Un store est les données que vous lisez et écrivez. Un espace de travail cible un cluster qui peut héberger de nombreux stores.
- Un espace de travail n'est pas un cluster. Un cluster est l'ensemble des nœuds en cours d'exécution. L'espace de travail nomme seulement la façon d'atteindre les managers qui observent ou supervisent ce cluster.
Créer ou rejoindre
New-ZrWorkspace et Use-ZrWorkspace font des choses différentes, et la distinction compte.
New-ZrWorkspace crée un espace de travail en y revendiquant des managers actuellement non revendiqués. Elle rejette les managers qui appartiennent déjà à un autre espace de travail, de sorte qu'elle ne peut pas silencieusement s'emparer d'un cluster existant.
Use-ZrWorkspace active un espace de travail. Si l'espace de travail nommé est déjà enregistré localement, elle bascule simplement dessus sans appel réseau. S'il n'est pas enregistré — ou si vous passez une adresse de manager d'amorçage — elle rejoint l'espace de travail existant : elle lit la liaison de ce manager, vérifie le nom, découvre la liste complète des managers, l'enregistre et l'active. Use-ZrWorkspace ne crée ni ne revendique jamais.
# Join an existing "prod" workspace from one of its managers, then activate it
Use-ZrWorkspace prod @('10.0.0.11:7801')
Mode de déploiement
Un espace de travail consigne le modèle de déploiement du cluster que ses managers fronten : superviseur ou attach. En mode superviseur, chaque manager fork et possède les processus de nœud sur sa propre machine, et la console et la CLI agrègent les vues des managers en une seule image. En mode attach, les nœuds s'exécutent sous un orchestrateur et le manager se contente d'observer. Lorsque vous n'indiquez pas le mode explicitement, New-ZrWorkspace le détecte automatiquement en sondant le premier manager, et tous les managers d'un espace de travail doivent rapporter le même mode.
Comment les termes se rapportent
Un espace de travail se situe au sommet de la chaîne d'adressage : il nomme les managers, les managers frontent un cluster, le cluster exécute un ou plusieurs stores, et les données de chaque store sont découpées en partitions et répliquées entre les nœuds. Le tableau met en contraste les sept briques.
| Terme | Ce que c'est | Identifié par | Où cela vit |
|---|---|---|---|
| Espace de travail | Une connexion nommée côté client vers un ensemble de managers | Nom + liste de managers | Sur votre machine d'administration (~/.clustron) et la console |
| Serveur | Une machine qui exécute le service de gestion Zaris | Adresse de gestion, host:7801 | Un par machine (mode superviseur) |
| Store | L'unité logique contre laquelle vous lisez et écrivez | Nom du store | Présenté à travers le cluster |
| Cluster | L'ensemble des nœuds qui exécutent ensemble un store | Ses nœuds membres | Sur un ou plusieurs serveurs |
| Nœud | Un unique processus de store en cours d'exécution | <host>-n<index> | Un par emplacement partition-réplica |
| Partition | Une tranche du keyspace | Un mot de code (Amber, Onyx, …) | Possédée par un nœud à la fois |
| Réplica | Une copie d'une partition détenue sur un autre nœud | Sa partition + le nœud qui la détient | Sur un nœud autre que le primaire |
Un espace de travail devrait pointer vers des managers qui observent tous le même cluster. New-ZrWorkspace avertit si un manager que vous ajoutez appartient déjà à un autre espace de travail, car un manager est censé fronter exactement un cluster.