Vloeistofcontainers beheren
Een container is de atomische opslageenheid in de Azure Fluid Relay-service en vertegenwoordigt de gegevens die zijn opgeslagen vanuit een Fluid-sessie, inclusief bewerkingen en momentopnamen. De Fluid Runtime gebruikt de container om de status van een Fluid-sessie te reactiveren wanneer een gebruiker voor het eerst deelneemt of opnieuw deelneemt na het verlaten.
Wanneer u een toepassing bouwt met de Vloeiend Framework, moet u rekening houden met het maken en beheren van containers, zoals in dit diagram wordt samengevat.
Belangrijkste concepten
Containermachtigingen
In de meeste gevallen willen ontwikkelaars een inventaris van containers en containermachtigingen beheren. Dit omvat informatie over wie toegang heeft tot de containers en metagegevens, zoals de beschrijvende naam van de container.
Toegang tot containers
Naar containers wordt verwezen door container-id. Voordat een gebruiker een container kan maken of openen, moet deze een JWT aanvragen die door de Fluid Runtime wordt gebruikt bij de communicatie met de Azure Fluid Relay-service. Elk proces met een geldige JWT heeft toegang tot een container. Het is de verantwoordelijkheid van de ontwikkelaar om JWT's te genereren voor containertoegang, waardoor ze controle krijgen over de bedrijfslogica om de toegang te beheren die geschikt is voor hun scenario. De Azure Fluid Relay-service heeft geen kennis van welke gebruikers toegang moeten hebben tot een container. Zie het Azure Fluid Relay-tokencontract voor meer informatie over dit onderwerp
Notitie
De documentID van het JWT-veld komt overeen met de id van de vloeistofcontainer.
Naamgeving van container
Containers worden benoemd door de Azure Fluid Relay-service tijdens het maken van containers. De actie Maken retourneert een containernaam in de vorm van een GUID die later moet worden gebruikt om de container te openen. In de meeste gevallen willen ontwikkelaars deze container-id-GUID, samen met een beschrijvende naam, opslaan in hun eigen gegevensarchief om containerdetectiestromen te vergemakkelijken.
Containerdetectie
Ontwikkelaars zijn verantwoordelijk voor elke ervaring en bedrijfslogica met betrekking tot gebruikersdetectie van bestaande containers. Dit kan de vorm aannemen van een doorzoekbare lijst met containers op basis van gebruikersdeelname in de Fluid-sessie, het direct delen van containers tussen gebruikers of programmatische toewijzing van containers aan bestaande artefacten of processen.
Voorbeeldstroom voor het maken van containers
In dit voorbeeld wordt de app/pagina geladen met een algemene JWT (niet gebonden aan een specifieke container) die de client-app gebruikt wanneer het tijd is om een nieuwe container te maken.
De app aan de clientzijde maakt gebruik van de Vloeiend Framework-API om een nieuwe container te maken in de Azure Fluid Relay-service, wat resulteert in een containerobject met een nieuw toegewezen container-id. Voor verdere interacties met de container is een nieuwe JWT vereist die de container-id bevat.
Zodra de client de nieuwe container heeft gemaakt, wordt de container-id opgeslagen in een bepaald systeem waarmee containers en gebruikers machtigingen worden toegewezen. Met dit systeem wordt elke containerdetectie-/browse-ervaring aangedreven die de ontwikkelaar wil maken voor hun gebruikers.
Voordat de client met de container communiceert, wordt een containerspecifieke JWT aangevraagd die wordt gebruikt voor volgende aanroepen van de Vloeiend Framework runtime naar de Azure Fluid Relay-service.
Containerinhoud exporteren
Als een toepassing gegevens opslaat die mogelijk door eindgebruikers moeten worden geëxporteerd, is de ontwikkelaar van de toepassing verantwoordelijk voor het bouwen van die exportfunctionaliteit in hun toepassing, met behulp van de huidige status van de Fluid-container, zoals vertegenwoordigd door de gedistribueerde gegevensstructuren die in de container zijn gedefinieerd. Zie: Containers (fluidframework.com) voor meer informatie over het maken van verbinding met en openen van Fluid-containers. Zie voor meer informatie over het weergeven en verwijderen van containers met de besturingsvlak-API: Fluid-containers verwijderen in Microsoft Azure Fluid Relay Server.