Gerenciando de contêineres de fluidos
Um contêiner é a unidade atômica de armazenamento no serviço de Azure Fluid Relay e representa os dados armazenados de uma sessão fluida, incluindo operações e instantâneos. O tempo de execução de fluido usa o contêiner para reidratar o estado de uma sessão de fluido quando um usuário se une pela primeira vez ou se reúne após sair.
Ao criar um aplicativo com o Fluid Framework, há várias coisas que você precisa considerar em relação à criação e ao gerenciamento de contêiner, conforme resumido neste diagrama.
Conceitos principais
Permissões do contêiner
Na maioria dos casos, os desenvolvedores desejarão gerenciar um inventário de contêineres e permissões de contêiner. Isso inclui informações sobre quem tem acesso aos contêineres, bem como metadados como o nome amigável do contêiner.
Acessando contêineres
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 será usado pelo tempo de execução de fluido ao se comunicar com o Serviço do Azure Fluid Relay. Qualquer processo com um JWT válido pode acessar um contêiner. É responsabilidade do desenvolvedor gerar JWTs para acesso de contêiner, o que os coloca no controle da lógica de negócios para controlar o acesso conforme apropriado para seu cenário. O serviço de 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
Observação
O campo do JWT corresponde à ID do contêiner de fluido.
Nomenclatura de contêiner
Os contêineres são nomeados pelo serviço de 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êineres.
Descoberta de contêiner
Os desenvolvedores são responsáveis por qualquer experiência e lógica de negócios relacionada à descoberta de usuários de contêineres existentes. Isso pode assumir a forma de uma lista navegável de contêineres com base na participação do usuário na sessão de fluido, o compartilhamento direto de contêineres entre usuários ou a atribuição programática de contêineres a artefatos ou processos existentes.
Fluxo de criação do contêiner de exemplo
Neste exemplo, a página ou o aplicativo é carregado com um JWT genérico (não limitado a um contêiner específico) que o aplicativo cliente usará durante a criação de um contêiner.
O aplicativo do cliente usa uma API do Fluid Framework para criar um contêiner no serviço do Azure Fluid Relay. Isso resultará em um objeto contêiner com uma ID do contêiner recém atribuída. Outras interações com o contêiner exigem obter um JWT que contenha a ID do contêiner.
Após criar o contêiner, o cliente salvará a ID do contêiner em um sistema que mapeia contêineres e usuários para gerenciar permissões. Esse sistema conduzirá todas as experiências de navegação/descoberta do contêiner que o desenvolvedor deseja criar para os usuários.
Antes de interagir com o contêiner, o cliente solicitará um JWT específico do contêiner que será usado para executar chamadas subsequentes do runtime do Fluid Framework para o serviço do Azure Fluid Relay.
Como exportar conteúdo do contêiner
Caso um aplicativo armazene dados que os usuários finais talvez precisem exportar, o desenvolvedor de aplicativos será responsável por criar essa funcionalidade de exportação no aplicativo, usando o estado atual do contêiner do Fluid, conforme representado pelas Estruturas de Dados Distribuídas definidas no contêiner. Para obter mais informações sobre como se conectar a contêineres do Fluid e abri-los, confira Contêineres (fluidframework.com). Para obter mais informações sobre como listar e excluir contêineres com uma API do painel de controle, confira como Excluir contêineres do Fluid no Servidor do Microsoft Azure Fluid Relay.