Orchestration

Exécutez un parc de nœuds edge MiroxOS comme un cluster unique et auto-réparateur sur votre site, chaque nœud évoluant à travers une machine à états protégée afin qu'un appareil ne puisse jamais se retrouver dans un état invalide ou partiellement configuré.

Vue d'ensemble

Mettre en place un cluster edge est une poignée de main coordonnée entre les actions que vous exécutez sur l'appareil et celles que le personnel Mirox effectue dans le cloud. Chaque nœud progresse à travers une machine à états stricte, et chaque transition vérifie d'abord ses prérequis — vous ne pouvez donc pas, par exemple, retirer un nœud d'un parc tant qu'il dessert encore un cluster actif. Lorsqu'un appareil prend du retard par rapport au cloud (par exemple après un nettoyage forcé alors qu'il était hors ligne), une seule commande de synchronisation le réconcilie.

Machine à états

Diagramme d'états de l'appareil

Légende :

Flèches pleines : transitions normales (exécutées sur l'appareil ou par un administrateur d'organisation)
Flèches en pointillés : transitions forcées effectuées par le personnel Mirox, avec nettoyage automatique
Verrouillé au parc Cluster edge en cours d'exécution Point de synchronisation

Comportement des transitions forcées

Lorsque le personnel Mirox utilise l'option de forçage, tous les nettoyages intermédiaires s'exécutent automatiquement :

Action forcée	Exécute automatiquement
Supprimer l'appareil (depuis CLUSTER_ACTIVE)	quitter le cluster → désinitialiser le nœud → retirer du parc → retirer de l'organisation → désenregistrer
Supprimer l'appareil (depuis NODE_INITIALIZED)	désinitialiser le nœud → retirer du parc → retirer de l'organisation → désenregistrer
Retirer de l'organisation (depuis NODE_INITIALIZED)	désinitialiser le nœud → retirer du parc → retirer de l'organisation
Retirer du parc (depuis NODE_INITIALIZED)	désinitialiser le nœud → retirer du parc

Synchronisation de l'appareil

L'appareil peut exécuter mrxcloud sync pour récupérer l'état actuel du cloud et réconcilier sa configuration locale :

Si l'appareil a été retiré de force du parc → la configuration locale du nœud est effacée
Si l'appareil a été retiré de force de l'organisation → la configuration locale de l'organisation est effacée
Si l'appareil a été supprimé de force → l'appareil doit se réenregistrer

Diagramme d'états du cluster

Légende :

Flèches pleines : transitions normales
Flèches en pointillés : transitions forcées effectuées par le personnel Mirox
En attente de nœuds Cluster opérationnel

États de l'appareil

État	Description	États suivants autorisés
`UNREGISTERED`	L'appareil n'est enregistré sur aucun cloud	`REGISTERED`
`REGISTERED`	L'appareil est enregistré sur le cloud	`ASSIGNED_ORG`, `UNREGISTERED`
`ASSIGNED_ORG`	L'appareil est affecté à une organisation	`ASSIGNED_PARK`, `REGISTERED`
`ASSIGNED_PARK`	L'appareil est affecté à un parc	`NODE_INITIALIZED`, `ASSIGNED_ORG`
`NODE_INITIALIZED`	L'appareil est initialisé comme nœud edge	`CLUSTER_ACTIVE`, `ASSIGNED_PARK`
`CLUSTER_ACTIVE`	Le cluster edge est en cours d'exécution sur l'appareil	`NODE_INITIALIZED`

États du cluster

État	Description
`NOT_CREATED`	Aucun cluster edge n'existe pour le parc
`CREATED`	Cluster edge créé, en attente de nœuds
`ACTIVE`	Au moins un nœud a rejoint le cluster

Étapes du workflow

Flux aller (mise en place)

Étape	Action	Acteur	Outil	Prérequis
1	Enregistrer l'appareil	Appareil	`mrxcloud register`	-
2	Affecter à une organisation	Personnel Mirox	Cloud	Étape 1
3	Affecter à un parc	Administrateur d'organisation	Cloud	Étape 2
4	Créer le cluster edge	Personnel Mirox	Cloud	Étape 3 (le parc existe)
5	Initialiser le nœud	Appareil	`mrxcloud node init`	Étapes 3 + 4
6	Initialiser le cluster	Appareil	`mrxnode init`	Étape 5
7	Déployer les charges de travail	Appareil	`mrxnode bootstrap`	Étape 6

Flux retour (démantèlement)

Étape	Action	Acteur	Outil	Prérequis
7	Arrêter les charges de travail	Appareil	`mrxnode teardown`	-
6	Quitter le cluster	Appareil	`mrxnode leave`	Étape 7
5	Désinitialiser le nœud	Appareil	`mrxcloud node deinit`	Étape 6
4	Supprimer le cluster edge	Personnel Mirox	Cloud	Aucun nœud actif
3	Retirer du parc	Administrateur d'organisation	Cloud	Étape 5 (nœud désinitialisé)
2	Retirer de l'organisation	Personnel Mirox	Cloud	Étape 3
1	Désenregistrer l'appareil	Appareil	`mrxcloud unregister`	Étape 2

Contraintes de verrouillage

Verrou d'affectation au parc

Lorsqu'un appareil est initialisé comme nœud edge (étape 5), l'appareil devient verrouillé au parc :

Action	Autorisée quand	Bloquée quand
Retirer l'appareil du parc	Nœud NON initialisé	Nœud initialisé
Retirer l'appareil de l'organisation	Appareil NON affecté à un parc	Appareil affecté à un parc
Supprimer le cluster edge	Aucun nœud initialisé	Au moins un nœud initialisé

Matrice d'application

Chaque action est refusée tant qu'un verrou est actif, sauf si elle est exécutée avec l'option force — auquel cas la plateforme effectue à votre place chaque nettoyage intermédiaire :

Action	Sans force	Avec force
Retirer l'appareil du parc	Refusé tant que l'appareil est un nœud initialisé	Désinitialisation automatique du nœud, puis retrait
Retirer l'appareil de l'organisation	Refusé tant que l'appareil est affecté à un parc	Retrait automatique du parc (et désinitialisation du nœud si nécessaire)
Supprimer l'appareil	Refusé tant que l'appareil possède des affectations	Chaîne de nettoyage complète automatique
Supprimer le cluster edge	Refusé tant que des nœuds sont initialisés	Désinitialisation automatique de tous les nœuds, puis suppression
Initialiser le nœud (`mrxcloud node init`)	Nécessite que l'appareil soit affecté à un parc disposant d'un cluster edge	-
Quitter le cluster (`mrxcloud node deinit`)	Nécessite que l'appareil détienne actuellement un numéro de nœud	-

Référence des commandes

Commandes côté appareil (mrxcloud)

Commande	Description
`mrxcloud register <domain>`	Enregistrer l'appareil sur le cloud
`mrxcloud unregister`	Désenregistrer l'appareil
`mrxcloud sync`	Récupérer et réconcilier l'état actuel du cloud
`mrxcloud node init`	Initialiser l'appareil comme nœud edge
`mrxcloud node deinit`	Désinitialiser le nœud du cluster
`mrxcloud node info`	Afficher la configuration de nœud de l'appareil

Commandes côté appareil (mrxnode)

Commande	Description
`mrxnode init`	Démarrer le cluster edge (premier nœud) ou en rejoindre un existant
`mrxnode leave`	Quitter le cluster edge
`mrxnode bootstrap`	Déployer les charges de travail de la centrale sur le cluster
`mrxnode teardown`	Arrêter et supprimer les charges de travail déployées
`mrxnode check`	Vérifier l'état du cluster

Actions côté cloud

Ces étapes sont effectuées dans le cloud plutôt que sur l'appareil. L'affectation d'un appareil à un parc et sa gestion au sein du parc sont accessibles à vos administrateurs d'organisation ; l'enregistrement ou l'affectation d'un appareil à une organisation, ainsi que la création ou la suppression du cluster edge lui-même, sont effectués par le personnel Mirox.

Action	Effectuée par	Avec force
Affecter l'appareil à une organisation	Personnel Mirox	-
Retirer l'appareil de l'organisation	Personnel Mirox	Retrait automatique du parc + désinitialisation du nœud
Supprimer l'appareil	Personnel Mirox	Chaîne de nettoyage complète automatique
Affecter / retirer l'appareil d'un parc	Administrateur d'organisation	Désinitialisation automatique du nœud lors du retrait
Créer le cluster edge pour un parc	Personnel Mirox	-
Supprimer le cluster edge	Personnel Mirox	Désinitialisation automatique de tous les nœuds

Vérification de l'état

Vérifier l'état actuel

# Sur l'appareil : vérifier l'enregistrement et l'état du nœud
mrxcloud status
mrxcloud node info

# Vérifier l'état du cluster edge
mrxnode check

Indicateurs d'état

mrxcloud node info indique la configuration de nœud actuelle de l'appareil :

Indicateur	Signification
`edge_location`	UID du parc que cet appareil dessert en tant que nœud
`edge_node_number`	Numéro de nœud attribué (1, 2, 3...)
`private_ip`	IP réseau privée du nœud au sein du cluster
`token_to_join`	Jeton de jonction au cluster utilisé par les nœuds supplémentaires

Gestion des erreurs

Erreurs courantes

Erreur	Cause	Résolution
"Device is not assigned to a park"	Étape 3 non effectuée	Affecter l'appareil à un parc dans le cloud
"No edge cluster exists for park"	Étape 4 non effectuée	Faire créer le cluster edge dans le cloud
"Cannot unassign: device is initialized as edge node"	Étape 5 effectuée, verrou actif	Exécuter `mrxcloud node deinit`, ou utiliser l'option de forçage
"Cannot delete cluster: active nodes exist"	Des nœuds sont encore initialisés	Désinitialiser tous les nœuds, ou utiliser l'option de forçage
"Cannot unassign from org: device assigned to park"	L'appareil est encore dans un parc	Le retirer d'abord du parc, ou utiliser l'option de forçage
"State mismatch: device was forcefully modified"	L'état du cloud a changé pendant que l'appareil était hors ligne	Exécuter `mrxcloud sync` pour réconcilier

Fonctionnalités associées

mrxnode — le nœud matériel edge qui fonctionne au sein du cluster
Vue d'ensemble de mrxnode — configuration de l'appareil, enregistrement et présentation de la CLI
Aide-mémoire mrxnode — référence rapide des commandes mrxcloud et mrxnode
Dépannage — schémas de récupération lorsqu'un nœud se comporte mal
Options de déploiement de l'agent — clusters edge sur site versus agents hébergés dans le cloud