容器是 Azure Fluid Relay 服務中的原子單位儲存,表示來自 Fluid 會話儲存的資料,包括操作和快照。 當使用者第一次加入或離開后重新加入時,Fluid 運行時間會使用容器來重新凍結 Fluid 會話的狀態。
使用 Fluid Framework 建置應用程式時,您需要考慮關於容器建立和管理的事項,如下圖所示。
重要概念
容器權限
在大部分情況下,開發人員會想要管理容器以及容器許可權的目錄。 這包括可存取容器的人員以及容器易記名稱等元數據的相關信息。
存取容器
容器會依容器標識碼參考。 在使用者能建立或開啟容器之前,他們必須請求 Fluid Runtime 在與 Azure Fluid Relay 服務通訊時使用的 JWT。 任何具有有效 JWT 的進程都可以存取容器。 開發人員必須負責產生 JWT 以進行容器存取,這可讓他們控制商業規則,以適當地控制其案例的存取。 Azure Fluid Relay 服務不知道哪些用戶應該可以存取容器。 如需本主題的詳細資訊,請參閱 Azure Fluid Relay 令牌合約
備註
JWT 欄位 documentID 會對應至 Fluid 容器標識碼。
容器命名
容器會在容器建立時由 Azure Fluid Relay 服務命名。 [建立] 動作會以 GUID 的形式傳回容器名稱,該 GUID 稍後必須用來開啟容器。 在大部分情況下,開發人員會想要將此容器標識碼 GUID 連同易記名稱儲存在自己的數據存放區中,以利容器探索流程。
容器發現
開發人員須負責與使用者探索現有容器相關的任何體驗和商業規則。 這可能採用可流覽的容器清單形式,根據用戶參與流暢會話、在用戶之間直接共用容器,或以程式設計方式將容器指派給現有的成品或進程。
範例容器建立流程
在此範例中,應用程式/頁面會載入一般 JWT(未系結至特定容器),用戶端應用程式會在建立新容器時使用。
用戶端應用程式會使用 Fluid Framework API 在 Azure Fluid Relay 服務中建立新的容器,以產生具有新指派容器標識碼的容器物件。 與容器的進一步互動需要包含容器標識碼的新 JWT。
用戶端建立新的容器之後,它會將容器標識符儲存在一些對應容器和使用者來管理許可權的系統中。 此系統會驅動開發人員想要為其使用者建立的任何容器探索/瀏覽體驗。
在與容器互動之前,用戶端會要求容器特定的 JWT,以用於從 Fluid Framework 運行時間到 Azure Fluid Relay 服務的後續呼叫。
匯出容器內容
如果應用程式儲存使用者可能需要匯出的數據,應用程式開發人員會負責使用容器中所定義之分散式數據結構所代表的 Fluid 容器目前狀態,在應用程式中建置該匯出功能。 如需連線至和開啟流暢容器的詳細資訊,請參閱:容器(fluidframework.com)。 如需以控制平面 API 列出和刪除容器的詳細資訊,請參閱: 刪除 Microsoft Azure Fluid Relay Server 中的流暢容器。