Gestion des conteneurs Fluid
Un conteneur est l’unité atomique de stockage dans le service Azure Fluid Relay et représente les données stockées à partir d’une session Fluid, y compris les opérations et les instantanés. Le runtime Fluid utilise le conteneur pour réalimenter l’état d’une session Fluid lorsqu’un utilisateur rejoint la session pour la première fois, ou s’il la rejoint après l’avoir quittée.
Lors de la création d’une application avec l’infrastructure Fluid, vous devez tenir compte de plusieurs choses pour la création et la gestion d’un conteneur, comme indiqué dans ce diagramme.
Concepts clés
Autorisations du conteneur
Dans la plupart des cas, les développeurs doivent gérer un inventaire des conteneurs et des autorisations de conteneur. Cela inclut des informations sur les personnes qui ont accès aux conteneurs, ainsi que des métadonnées telles que le nom convivial du conteneur.
Accès aux conteneurs
Les conteneurs sont référencés par ID de conteneur. Pour qu’un utilisateur puisse créer ou ouvrir un conteneur, il doit demander un JWT que le runtime fluide utilisera lors de la communication avec le service Relais Azure Fluid. Tout processus avec un jeton JWT valide peut accéder à un conteneur. Il incombe au développeur de générer des jetons JWT pour l’accès au conteneur, ce qui leur permet de maîtriser la logique métier afin de contrôler l’accès en fonction de leur scénario. Le service Relais Azure Fluid n’a aucune connaissance des utilisateurs qui doivent avoir accès à un conteneur. Pour plus d’informations sur cette rubrique, consultez Contrat de jeton Relais Azure Fluid
Remarque
Le champ JWT documentID correspond à l’ID de conteneur Fluid.
Attribution de noms aux conteneurs
Les conteneurs sont nommés par le service Relais Azure Fluid au moment de la création du conteneur. L’action Créer retourne un nom de conteneur sous la forme d’un GUID qui doit être utilisé ultérieurement pour ouvrir le conteneur. Dans la plupart des cas, les développeurs souhaitent stocker ce GUID d’ID de conteneur, ainsi qu’un nom convivial, dans leur propre magasin de données pour faciliter les flux de détection de conteneur.
Détection de conteneur
Les développeurs sont responsables des expériences et de la logique métier liées à la détection par les utilisateurs des conteneurs existants. Cela peut prendre la forme d’une liste navigable de conteneurs en fonction de la participation de l’utilisateur à la session Fluid, du partage direct des conteneurs entre les utilisateurs ou de l’affectation programmatique de conteneurs à des artefacts ou des processus existants.
Exemple de flux de création de conteneur
Dans cet exemple, l’application ou la page est chargée avec un jeton JWT générique (non lié à un conteneur spécifique) qui sera utilisé par l’application cliente lors de la création d’un conteneur.
L’application côté client utilise l’API de l’Infrastructure Fluid pour créer un conteneur dans le service Relais Azure Fluid, ce qui aboutit à un objet conteneur auquel un nouvel ID de conteneur est affecté. Les interactions supplémentaires avec le conteneur exigent un nouveau jeton JWT contenant l’ID de conteneur.
Une fois qu’il a créé le conteneur, le client enregistre l’ID de conteneur dans un système qui mappe les conteneurs et les utilisateurs pour gérer les autorisations. Ce système pilote toute l’expérience de découverte des conteneurs et de navigation que le développeur souhaite créer pour ses utilisateurs.
Avant d’interagir avec le conteneur, le client demande un jeton JWT propre au conteneur, qui sera utilisé pour les appels suivants du runtime de l’Infrastructure Fluid au service Relais Azure Fluid.
Exportation du contenu du conteneur
Si une application stocke des données qui doivent être exportées par les utilisateurs finaux, le développeur est responsable de la création de cette fonctionnalité d’exportation dans son application, en utilisant l’état actuel du conteneur Fluid représenté par les structures de données distribuées définies dans le conteneur. Pour plus d’informations sur la connexion aux conteneurs Fluid et leur ouverture, consultez Conteneurs (fluidframework.com). Pour plus d’informations sur l’affichage et la suppression de conteneurs avec l’API de plan de contrôle, consultez Suppression de conteneurs Fluid dans le serveur Relais Azure Fluid.