Gestione dei contenitori fluidi

Un contenitore è l'unità atomica di archiviazione nel servizio Inoltro fluido di Azure e rappresenta i dati archiviati da una sessione fluida, incluse operazioni e snapshot. Il runtime fluida usa il contenitore per riattivare lo stato di una sessione Fluid quando un utente si unisce per la prima volta o si unisce nuovamente dopo l'uscita.

Quando si compila un'applicazione con Fluid Framework, è necessario tenere conto di diversi aspetti relativi alla creazione e alla gestione dei contenitori, come riepilogato in questo diagramma.

Concetti chiave

Autorizzazioni contenitori

Nella maggior parte dei casi, gli sviluppatori vogliono gestire un inventario dei contenitori e delle autorizzazioni per i contenitori. Ciò include informazioni su chi può accedere ai contenitori, nonché metadati come il nome descrittivo del contenitore.

Accesso ai contenitori

I contenitori vengono a cui viene fatto riferimento in base all'ID contenitore. Prima che un utente possa creare o aprire un contenitore, deve richiedere un token JWT che fluid runtime userà durante la comunicazione con il servizio Inoltro fluido di Azure. Qualsiasi processo con un token JWT valido può accedere a un contenitore. È responsabilità dello sviluppatore generare JWT per l'accesso ai contenitori, che li pone sotto il controllo della logica di business per controllare l'accesso in base al proprio scenario. Il servizio Inoltro fluido di Azure non ha alcuna conoscenza di quali utenti devono avere accesso a un contenitore. Per altre informazioni su questo argomento, vedere Contratto token di inoltro fluido di Azure

Nota

Il campo JWT documentID corrisponde all'ID contenitore Fluid.

Denominazione dei contenitori

I contenitori vengono denominati dal servizio Inoltro fluido di Azure in fase di creazione del contenitore. L'azione Crea restituisce un nome di contenitore sotto forma di GUID che deve essere usato in un secondo momento per aprire il contenitore. Nella maggior parte dei casi, gli sviluppatori vogliono archiviare questo GUID ID contenitore, insieme a un nome descrittivo, nel proprio archivio dati per facilitare i flussi di individuazione dei contenitori.

Individuazione dei contenitori

Gli sviluppatori sono responsabili di qualsiasi esperienza e logica di business correlata all'individuazione degli utenti di contenitori esistenti. Questo potrebbe assumere la forma di un elenco esplorabile di contenitori in base alla partecipazione dell'utente alla sessione Fluid, alla condivisione diretta di contenitori tra utenti o l'assegnazione programmatica di contenitori a artefatti o processi esistenti.

Flusso di creazione di contenitori di esempio

In questo esempio, l'app/pagina viene caricata con un token JWT generico (non associato a un contenitore specifico) che l'app client userà quando si tratta di creare un nuovo contenitore.

L'app sul lato client usa l'API Fluid Framework per creare un nuovo contenitore nel servizio Inoltro fluido di Azure che genera un oggetto contenitore con un ID contenitore appena assegnato. Altre interazioni con il contenitore richiedono un nuovo token JWT contenente l'ID contenitore.

Dopo aver creato il nuovo contenitore, il client salverà l'ID contenitore in un sistema che esegue il mapping di contenitori e utenti per gestire le autorizzazioni. Questo sistema determina qualsiasi esperienza di individuazione/esplorazione dei contenitori che lo sviluppatore vuole creare per gli utenti.

Prima di interagire con il contenitore, il client richiederà un token JWT specifico del contenitore che verrà usato per le chiamate successive dal runtime di Fluid Framework al servizio Inoltro fluido di Azure.

Esportazione del contenuto del contenitore

Se un'applicazione archivia i dati che possono essere esportati dagli utenti finali, lo sviluppatore dell'applicazione è responsabile della compilazione di tale funzionalità di esportazione nell'applicazione, usando lo stato corrente del contenitore Fluid come rappresentato dalle strutture di dati distribuite definite nel contenitore. Per altre informazioni sulla connessione e l'apertura di contenitori Fluid, vedere: Contenitori (fluidframework.com).For more information on connecting to and opening Fluid containers, see: Containers (fluidframework.com). Per altre informazioni sull'elenco e l'eliminazione di contenitori con l'API del piano di controllo, vedere Eliminare contenitori fluidi nel server di inoltro fluido di Microsoft Azure.

Vedi anche

• Panoramica dell'architettura di Inoltro fluido di Azure
• Strutture di dati distribuite
• Contratto token di Inoltro fluido di Azure