Správa kontejnerů Fluid
Kontejner je atomická jednotka úložiště ve službě Azure Fluid Relay a představuje data uložená z relace fluid, včetně operací a snímků. Modul runtime Fluid používá kontejner k dosazování stavu relace Fluid, když se uživatel poprvé připojí nebo se znovu připojí po opuštění.
Při vytváření aplikace pomocí fluid frameworku je potřeba zohlednit několik věcí týkajících se vytváření a správy kontejnerů, jak je shrnuto v tomto diagramu.
Klíčové koncepty
Oprávnění kontejneru
Ve většině případů budou chtít vývojáři spravovat inventář kontejnerů a oprávnění kontejneru. To by zahrnovalo informace o tom, kdo má přístup k kontejnerům, a také metadata, jako je popisný název kontejneru.
Přístup ke kontejnerům
Na kontejnery odkazuje ID kontejneru. Než uživatel může vytvořit nebo otevřít kontejner, musí požádat O JWT, který bude modul Fluid Runtime používat při komunikaci se službou Azure Fluid Relay. Jakýkoli proces s platným JWT má přístup ke kontejneru. Je zodpovědností vývojáře generovat JWT pro přístup ke kontejnerům, což jim dává kontrolu nad obchodní logikou, která řídí přístup podle potřeby pro jejich scénář. Služba Azure Fluid Relay nemá žádné znalosti o tom, kteří uživatelé by měli mít přístup ke kontejneru. Další informace o tomto tématu najdete v tématu Kontrakt tokenu Azure Fluid Relay.
Poznámka:
ID pole JWT odpovídá ID kontejneru Fluid.
Pojmenování kontejnerů
Kontejnery jsou pojmenovány službou Azure Fluid Relay při vytváření kontejnerů. Akce Vytvořit vrátí název kontejneru ve formě identifikátoru GUID, který je potřeba použít později k otevření kontejneru. Ve většině případů budou chtít vývojáři uložit tento identifikátor GUID ID kontejneru spolu s popisným názvem ve vlastním úložišti dat, aby usnadnili toky zjišťování kontejnerů.
Zjišťování kontejnerů
Vývojáři zodpovídají za veškeré prostředí a obchodní logiku související se zjišťováním uživatelů existujících kontejnerů. To může mít podobu seznamu kontejnerů založených na účasti uživatele v relaci fluid, přímé sdílení kontejnerů mezi uživateli nebo programové přiřazení kontejnerů ke stávajícím artefaktům nebo procesům.
Ukázkový tok vytvoření kontejneru
V tomto příkladu se aplikace nebo stránka načte s obecným prostředím JWT (není svázané s konkrétním kontejnerem), kterou klientská aplikace použije, když přijde čas na vytvoření nového kontejneru.
Aplikace na straně klienta používá rozhraní Fluid Framework API k vytvoření nového kontejneru ve službě Azure Fluid Relay, což vede k objektu kontejneru s nově přiřazeným ID kontejneru. Další interakce s kontejnerem vyžadují nový JWT, který obsahuje ID kontejneru.
Jakmile klient vytvoří nový kontejner, uloží ID kontejneru v některém systému, který mapuje kontejnery a uživatele na správu oprávnění. Tento systém bude řídit zjišťování a procházení kontejnerů, které chce vývojář vytvořit pro své uživatele.
Před interakcí s kontejnerem si klient vyžádá prostředí JWT specifické pro kontejner, které se použije pro následná volání modulu runtime Fluid Framework do služby Azure Fluid Relay.
Export obsahu kontejneru
Pokud aplikace ukládá data, která mohou být potřeba exportovat koncovými uživateli, je vývojář aplikace zodpovědný za sestavení této funkce exportu do své aplikace pomocí aktuálního stavu kontejneru Fluid, jak je znázorněno distribuovanými datovými strukturami definovanými v kontejneru. Další informace o připojení ke kontejnerům Fluid a jejich otevírání najdete v tématu: Kontejnery (fluidframework.com). Další informace o výpisu a odstraňování kontejnerů pomocí rozhraní API řídicí roviny najdete v tématu: Odstranění kontejnerů Fluid na serveru Microsoft Azure Fluid Relay Server.