Aller au contenu principal

Exécuter sur Mesh

Un groupe hospitalier possède souvent des données réparties sur plusieurs sites, impossibles à centraliser. Run on Mesh permet de créer un flux de travail unique et d'en exécuter différentes parties sur différents sites. Les données transitent entre les sites via Connect.

Comment ça marche​

Chaque nœud d'un flux de travail peut être associé à un emplacement : le site sur lequel il s'exécute. Lors du lancement d'une exécution de maillage, le coordinateur divise le flux de travail en segments, chaque segment étant un groupe de nœuds par emplacement. Chaque segment s'exécute sur le moteur de flux de travail de ce site (un nœud rayonnant). La sortie d'un segment est transmise au segment suivant via Connect.

Topologie de type Mesh : un coordinateur, des exécuteurs sur les sites A et B, une liaison Connect entre eux et des événements d’état renvoyés au coordinateur.

  • Le coordinateur est un rôle du même serveur moteur de workflow (option HYDRA_ROLE=coordinator ou -coordinator). Il compile le plan, conserve un registre de chaque exécution et segment dans Postgres, et n'envoie que le premier segment (entrée). Les modules suivants enchaînent les autres segments.
  • Les plans et les enveloppes comportent des signatures Ed25519 au format JSON canonique. La vérification des signatures est activée par défaut.
  • Les événements d'état renvoyés au coordinateur sont par défaut exempts de données de santé personnelles : aucune entrée ni sortie par nœud, et les erreurs sont réduites à un ensemble fermé de codes.
  • Les données qui quittent le site du responsable du traitement des données par la faille de sécurité sont pseudonymisées, et non anonymisées. Elles peuvent néanmoins constituer des données personnelles au sens du RGPD.

Ce que le maillage prend en charge​

Déclaration du propriétaire

Ces fonctionnalités sont disponibles, comme confirmé par le propriétaire. Consultez l'état des fonctionnalités pour connaître la source et le périmètre de vérification, y compris les anciens enregistrements de conception non encore harmonisés. Confirmez le déploiement pris en charge auprès de votre administrateur.

  • Jointures qui combinent des données, y compris des informations de santé protégées, provenant de plusieurs sites.
  • Livraison durable et ponctuelle entre les sites.
  • Apprentissage fédéré entre les sites.

Exécuter un flux de travail sur le maillage​

  1. Ouvrez le flux de travail dans Tiet · Studio → Workflows → Builder.
  2. Sélectionnez un nœud et ouvrez la section Runtime de son inspecteur. Dans Runs on (placement), choisissez un site ou saisissez-en un. Le champ suggère le hub et chaque spoke enregistré. Laissez-le vide pour exécuter le nœud sur la VM hydra-platform, en dehors du maillage.
  3. Répétez l'opération pour les nœuds appartenant à d'autres sites.
  4. Ouvrez le menu Run L'option Run on mesh (description « Distribué sur plusieurs sites ») est maintenant activée. Tant qu'aucun nœud n'est placé, cette option est désactivée, avec l'indication « Activer le placement Runs-on d'un nœud ».
  5. Choisissez Run on mesh. Une boîte de dialogue vous demandera des informations, puis le flux de travail sera enregistré et l'exécution commencera.

Une fois l'exécution lancée, le panneau inférieur ouvre un onglet MESH Si vous démarrez à partir d'un panneau vide, le message suivant s'affiche : « Aucune exécution sur le maillage pour le moment. Indiquez l'emplacement d'un nœud et choisissez Exécuter sur le maillage. »

Séquence d'exécution : Studio, coordinateur, Connect et deux satellites

Lisez l'onglet MESH​

L'onglet interroge le coordinateur toutes les 2 secondes jusqu'à la fin de l'exécution. Il affiche l'état de l'exécution, son identifiant et l'identifiant du plan, puis les segments regroupés par emplacement. Chaque ligne de segment affiche son identifiant, le rayon (@spoke), un badge ×N si l'exécution a été tentée plusieurs fois, son état et un code d'erreur en cas d'échec.

État d'exécutionSignification
pending, runningEn cours
doneTous les segments sont terminés.
failedUn segment a échoué
stalledAucun progrès avant l'échéance (les délais d'expiration par défaut pour la planification, l'exécution et la participation sont de 15 minutes).
revokedLa politique d'accès de la course a été révoquée et le coupe-circuit l'a arrêtée à son prochain saut.
cancelledArrêté par un utilisateur

Les statuts des segments sont pending, running, done, skipped, failed, dlq et cancelled. Les résultats par nœud apparaissent sous un segment uniquement lorsque le processus est configuré avec HYDRA_MESH_STATUS_DETAIL=full. Les sites détenteurs de données ne les envoient jamais.

L'utilisation de la commande d'arrêt du constructeur pendant qu'une exécution de maillage est active l'annule.

Où chercher ailleurs​

LieuCe que vous voyez
Tiet · Connect → Network → MeshSites, rayons et leur santé
Tiet · Studio → Workflows → Builder, panneau inférieur MESH ongletÉtat par segment de l'exécution que vous avez commencée

Tiet · Connect → Réseau → Mesh : le hub et les antennes enregistrées

Contrôles de sécurité​

ContrôleEffet
Authentification par échecChaque route /api/mesh sauf /api/mesh/health nécessite un jeton d'accès. Une configuration de jeton vide refuse toute requête.
Plans et enveloppes signésUne tentative de falsification a été détectée. Un processus mesh sans son magasin de certificats de confiance refuse de démarrer.
jetons à portée de placementLe jeton d'un site ne peut récupérer, signaler et rejoindre que les segments de son propre emplacement.
porte de politique d'accèsUne exécution qui s'étend sur plusieurs emplacements nécessite une politique publiée, non révoquée et non expirée qui corresponde au pipeline, au hachage du plan compilé et aux emplacements. Sinon, le démarrage est refusé avec SEAM_POLICY_MISSING, SEAM_POLICY_REVOKED, SEAM_POLICY_MISMATCH ou SEAM_REGIME_MIXED.
Interrupteur d'arrêt d'urgenceLa révocation d'une politique arrête les exécutions qu'elle a admises (revoked).
événements de statut sans PHILa surveillance ne divulgue pas les données des patients.

Limites​

  • La Run on mesh est proposée uniquement pour un flux de travail enregistré (un flux de travail possédant un identifiant de pipeline).
  • L'annulation met fin aux travaux ultérieurs, mais n'annule pas les effets secondaires sur le site.

Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.