Zarządzanie kontenerami płynów
Kontener to niepodzielna jednostka magazynu w usłudze Azure Fluid Relay i reprezentuje dane przechowywane z sesji Fluid, w tym operacje i migawki. Środowisko uruchomieniowe Fluid używa kontenera do ponownego wypełniania stanu sesji płynu, gdy użytkownik dołącza po raz pierwszy lub ponownie dołącza po opuszczeniu.
Podczas tworzenia aplikacji za pomocą Elastyczna struktura należy uwzględnić kilka kwestii dotyczących tworzenia kontenerów i zarządzania nimi, jak podsumowano na tym diagramie.
Kluczowe pojęcia
Uprawnienia kontenera
W większości przypadków deweloperzy będą chcieli zarządzać spisem kontenerów i uprawnień kontenerów. Obejmuje to informacje o tym, kto ma dostęp do kontenerów, a także metadane, takie jak przyjazna nazwa kontenera.
Uzyskiwanie dostępu do kontenerów
Kontenery odwołują się do identyfikatora kontenera. Zanim użytkownik będzie mógł utworzyć lub otworzyć kontener, musi zażądać biblioteki JWT, która będzie używana przez środowisko uruchomieniowe płynów podczas komunikacji z usługą Azure Fluid Relay. Każdy proces z prawidłowym zestawem JWT może uzyskać dostęp do kontenera. Jest to odpowiedzialność dewelopera za generowanie zestawów JWTs na potrzeby dostępu do kontenerów, która kontroluje logikę biznesową w celu kontrolowania dostępu zgodnie z potrzebami w ich scenariuszu. Usługa Azure Fluid Relay nie ma wiedzy o tym, którzy użytkownicy powinni mieć dostęp do kontenera. Aby uzyskać więcej informacji na temat tego tematu, zobacz Kontrakt tokenu usługi Azure Fluid Relay
Uwaga
Identyfikator dokumentu pola JWT odpowiada identyfikatorowi kontenera Fluid.
Nazewnictwo kontenerów
Kontenery są nazwane przez usługę Azure Fluid Relay w czasie tworzenia kontenera. Akcja Utwórz zwraca nazwę kontenera w postaci identyfikatora GUID, który należy użyć później do otwarcia kontenera. W większości przypadków deweloperzy będą chcieli przechowywać ten identyfikator GUID identyfikatora kontenera wraz z przyjazną nazwą we własnym magazynie danych, aby ułatwić przepływy odnajdywania kontenerów.
Odnajdywanie kontenerów
Deweloperzy są odpowiedzialni za wszelkie doświadczenia i logikę biznesową związaną z odnajdywaniem istniejących kontenerów przez użytkowników. Może to mieć postać listy kontenerów z możliwością przeglądania na podstawie udziału użytkownika w sesji Fluid, bezpośredniego udostępniania kontenerów między użytkownikami lub programowego przypisania kontenerów do istniejących artefaktów lub procesów.
Przykładowy przepływ tworzenia kontenera
W tym przykładzie aplikacja/strona jest ładowana z ogólnym zestawem JWT (niezwiązanym z określonym kontenerem), który będzie używany przez aplikację kliencką podczas tworzenia nowego kontenera.
Aplikacja po stronie klienta używa interfejsu API Elastyczna struktura do utworzenia nowego kontenera w usłudze Azure Fluid Relay, co powoduje, że obiekt kontenera ma nowo przypisany identyfikator kontenera. Dalsze interakcje z kontenerem wymagają nowego zestawu JWT zawierającego identyfikator kontenera.
Po utworzeniu nowego kontenera klient zapisze identyfikator kontenera w niektórych systemach mapujących kontenery i użytkowników na zarządzanie uprawnieniami. Ten system będzie obsługiwać dowolne środowisko odnajdywania/przeglądania kontenerów, które deweloper chce utworzyć dla swoich użytkowników.
Przed rozpoczęciem interakcji z kontenerem klient zażąda specyficznego dla kontenera zestawu JWT, który będzie używany do kolejnych wywołań ze środowiska uruchomieniowego Elastyczna struktura do usługi Azure Fluid Relay.
Eksportowanie zawartości kontenera
Jeśli aplikacja przechowuje dane, które mogą być konieczne przez użytkowników końcowych, deweloper aplikacji jest odpowiedzialny za kompilowanie tej funkcji eksportu do aplikacji przy użyciu bieżącego stanu kontenera fluidu reprezentowanego przez rozproszone struktury danych zdefiniowane w kontenerze. Aby uzyskać więcej informacji na temat nawiązywania połączenia z kontenerami fluidu i otwierania ich, zobacz: Containers (fluidframework.com). Aby uzyskać więcej informacji na temat wyświetlania listy i usuwania kontenerów za pomocą interfejsu API płaszczyzny sterowania, zobacz: Usuwanie kontenerów płynów na serwerze Microsoft Azure Fluid Relay.