Gestão de contentores de fluidos
Um Container é a unidade atômica de armazenamento no serviço Azure Fluid Relay e representa os dados armazenados de uma sessão Fluid, incluindo operações e instantâneos. O tempo de execução do Fluid usa o contêiner para reidratar o estado de uma sessão do Fluid quando um usuário entra pela primeira vez ou se junta novamente depois de sair.
Ao criar um aplicativo com o Fluid Framework, há várias coisas que você precisa levar em conta em relação à criação e gerenciamento de contêineres, conforme resumido neste diagrama.
Conceitos-chave
Permissões de contêiner
Na maioria dos casos, os desenvolvedores desejarão gerenciar um inventário de contêineres e permissões de contêiner. Isso incluiria informações sobre quem tem acesso aos contêineres, bem como metadados, como o nome amigável do contêiner.
Acesso a contentores
Os contêineres são referenciados pela ID do contêiner. Antes que um usuário possa criar ou abrir um contêiner, ele deve solicitar um JWT que o Fluid Runtime usará ao se comunicar com o serviço Azure Fluid Relay. Qualquer processo com um JWT válido pode acessar um contêiner. É responsabilidade do desenvolvedor gerar JWTs para acesso ao contêiner, o que o coloca no controle da lógica de negócios para controlar o acesso conforme apropriado para seu cenário. O serviço Azure Fluid Relay não tem conhecimento de quais usuários devem ter acesso a um contêiner. Para obter mais informações sobre este tópico, consulte Contrato de token do Azure Fluid Relay
Nota
O ID do documento de campo JWT corresponde ao ID do contêiner Fluido.
Nomenclatura de contêineres
Os contêineres são nomeados pelo serviço Azure Fluid Relay no momento da criação do contêiner. A ação Criar retorna um nome de contêiner na forma de um GUID que deve ser usado posteriormente para abrir o contêiner. Na maioria dos casos, os desenvolvedores desejarão armazenar esse GUID de ID de contêiner, juntamente com um nome amigável, em seu próprio armazenamento de dados para facilitar os fluxos de descoberta de contêiner.
Descoberta de contêineres
Os desenvolvedores são responsáveis por qualquer experiência e lógica de negócios relacionada à descoberta de contêineres existentes pelo usuário. Isso pode assumir a forma de uma lista navegável de contêineres com base na participação do usuário na sessão Fluid, compartilhamento direto de contêineres entre usuários ou atribuição programática de contêineres a artefatos ou processos existentes.
Exemplo de fluxo de criação de contêiner
Neste exemplo, o aplicativo/página é carregado com um JWT genérico (não vinculado a um contêiner específico) que o aplicativo cliente usará na hora de criar um novo contêiner.
O aplicativo do lado do cliente usa a API do Fluid Framework para criar um novo contêiner no serviço Azure Fluid Relay que resulta em um objeto de contêiner com uma ID de contêiner recém-atribuída. Outras interações com o contêiner exigem um novo JWT que contenha o ID do contêiner.
Depois que o cliente tiver criado o novo contêiner, ele salvará o ID do contêiner em algum sistema que mapeie contêineres e usuários para gerenciar permissões. Este sistema conduzirá qualquer experiência de descoberta/navegação de contentores que o programador pretenda criar para os seus utilizadores.
Antes de interagir com o contêiner, o cliente solicitará um JWT específico do contêiner que será usado para chamadas subsequentes do tempo de execução do Fluid Framework para o serviço Azure Fluid Relay.
Exportando conteúdo de contêiner
Se um aplicativo armazena dados que talvez precisem ser exportados pelos usuários finais, o desenvolvedor do aplicativo é responsável por criar essa funcionalidade de exportação em seu aplicativo, usando o estado atual do contêiner Fluid, conforme representado pelas Estruturas de Dados Distribuídas definidas no contêiner. Para obter mais informações sobre como conectar e abrir recipientes de fluidos, consulte: Contêineres (fluidframework.com). Para obter mais informações sobre como listar e excluir contêineres com a API do plano de controle, consulte: Excluir contêineres Fluid no Microsoft Azure Fluid Relay Server.