Verwalten von Fluid-Containern
Ein Container ist die unteilbare Speichereinheit im Azure Fluid Relay-Dienst und stellt die aus einer Fluid-Sitzung gespeicherten Daten dar, einschließlich Vorgängen und Momentaufnahmen. Die Fluid-Runtime verwendet den Container, um den Zustand einer Fluid-Sitzung zu aktivieren, wenn ein Benutzer zum ersten Mal beitritt oder nach dem Verlassen erneut beitritt.
Beim Erstellen einer Anwendung mit dem Fluid Framework müssen Sie bei der Containererstellung und -verwaltung verschiedene Faktoren berücksichtigen, wie in diesem Diagramm zusammengefasst.
Wichtige Begriffe
Containerberechtigungen
In den meisten Fällen möchten Entwickler einen Bestand an Containern und Containerberechtigungen verwalten. Dies umfasst Informationen darüber, wer Zugriff auf die Container hat, sowie Metadaten wie den Anzeigenamen des Containers.
Zugreifen auf Container
Container werden über die Container-ID referenziert. Bevor ein Benutzer einen Container erstellen oder öffnen kann, muss er ein JWT anfordern, das von der Fluid-Runtime bei der Kommunikation mit dem Azure Fluid Relay-Dienst verwendet wird. Jeder Prozess mit einem gültigen JWT kann auf einen Container zugreifen. Es liegt in der Verantwortung des Entwicklers, JWTs für den Containerzugriff zu generieren, wodurch er die Kontrolle über die Geschäftslogik hat, um den Zugriff je nach Szenario zu steuern. Der Azure Fluid Relay-Dienst hat keine Kenntnis darüber, welche Benutzer Zugriff auf einen Container haben sollen. Weitere Informationen zu diesem Thema finden Sie unter Azure Fluid Relay-Tokenvertrag.
Hinweis
Das JWT-Feld documentID entspricht der Fluid-Container-ID.
Containerbenennung
Container werden zum Zeitpunkt der Containererstellung vom Azure Fluid Relay-Dienst benannt. Die Aktion „Erstellen“ gibt einen Containernamen in Form einer GUID zurück, die später zum Öffnen des Containers verwendet werden muss. In den meisten Fällen möchten Entwickler diese Container-ID-GUID zusammen mit einem Anzeigenamen in ihrem eigenen Datenspeicher speichern, um Containerermittlungsabläufe zu vereinfachen.
Containerermittlung
Entwickler sind für alle Erfahrungen und Geschäftslogiken im Zusammenhang mit der Benutzerermittlung von vorhandenen Containern verantwortlich. Dies könnte in Form einer durchsuchbaren Liste von Containern auf der Grundlage der Teilnahme des Benutzers an der Fluid-Sitzung, der direkten gemeinsamen Nutzung von Containern durch andere Benutzer oder der programmgesteuerten Zuweisung von Containern zu bestehenden Artefakten oder Prozessen erfolgen.
Beispielflow für die Containererstellung
In diesem Beispiel wird die App/Seite mit einem generischen JWT geladen (nicht an einen bestimmten Container gebunden), den die Client-App zum Zeitpunkt der Erstellung eines neuen Containers verwendet.
Die clientseitige App verwendet die Fluid Framework-API, um einen neuen Container im Azure Fluid Relay-Dienst zu erstellen, was zu einem Containerobjekt mit einer neu zugewiesenen Container-ID führt. Weitere Interaktionen mit dem Container erfordern ein neues JWT, das die Container-ID enthält.
Nachdem der Client den neuen Container erstellt hat, speichert er die Container-ID in einem System, das Containern und Benutzern die Verwaltung von Berechtigungen zuordnet. Dieses System steuert alle Containerermittlungs-/Browserumgebungen, die Entwickler*innen für ihre Benutzer*innen erstellen möchten.
Vor der Interaktion mit dem Container fordert der Client ein containerspezifisches JWT an, das für nachfolgende Aufrufe von der Fluid Framework-Runtime an den Azure Fluid Relay-Dienst verwendet wird.
Exportieren von Containerinhalten
Wenn eine Anwendung Daten speichert, die möglicherweise von Endbenutzer*innen exportiert werden müssen, sind Anwendungsentwickler*innen dafür verantwortlich, diese Exportfunktionalität in die Anwendung zu integrieren. Dabei wird der aktuelle Status des Fluidcontainers verwendet, wie er durch die im Container definierten verteilten Datenstrukturen dargestellt wird. Weitere Informationen zum Herstellen einer Verbindung mit und zum Öffnen von Fluid-Containern finden Sie unter Container (fluidframework.com). Weitere Informationen zum Auflisten und Löschen von Containern mit der Steuerungsebenen-API finden Sie unter Löschen von Fluidcontainern in Microsoft Azure Fluid Relay Server.