Como: Usar AzureClient para testes locais

Este artigo descreve as etapas para configurar o AzureClient no modo local e usá-lo para testar seu aplicativo Fluid localmente.

Configurar e criar um AzureClient

AzureClient pode ser configurado para ser executado em uma instância local do Azure Fluid Relay passando-lhe uma configuração como a abaixo.

    import { AzureClient, AzureConnectionConfig, LOCAL_MODE_TENANT_ID } from "@fluidframework/azure-client";
    import { InsecureTokenProvider } from "@fluidframework/test-client-utils";

    const clientProps = {
        connection: {
            tenantId: LOCAL_MODE_TENANT_ID,
            tokenProvider: new InsecureTokenProvider("", { id: "123", name: "Test User" }),
            endpoint: "http://localhost:7070",
            type: "remote",
        },
    };

    const azureClient = new AzureClient(clientProps);

Este exemplo usa o InsecureTokenProvider para gerar e assinar tokens de autenticação que o serviço Azure Fluid Relay aceitará. No entanto, como o nome indica, essa implementação é insegura e não deve ser usada em ambientes de produção. Para obter mais informações sobre InsecureTokenProvider, consulte Autenticação e autorização em seu aplicativo.

Para executar localmente, primeiro configure o ponto de extremidade para apontar para o domínio e a porta na qual a instância de serviço local do Azure Fluid Relay está sendo executada (http://localhost:7070 por padrão). A etapa final é definir o tenantId para LOCAL_MODE_TENANT_ID. Todas essas configurações juntas configuram o AzureClient para trabalhar com um serviço local do Azure Fluid Relay.

Ativando o log de depuração

Você pode habilitar o log de depuração interno do Fluid Framework usando a seguinte configuração em um console do navegador.

localStorage.debug = 'fluid:*'

Para cenários mais avançados, você pode passar um logger para o AzureClient. Isso permite que você personalize o comportamento de log. Para obter mais informações sobre o registrador ou telemetria, consulte Registro em log e telemetria no fluidframework.com.

Executando o serviço Azure Fluid Relay localmente

Para usar o modo local do AzureClient, primeiro você precisa iniciar um servidor local. A execução npx @fluidframework/azure-local-service@latest a partir da janela do terminal iniciará o servidor local do Azure Fluid Relay. Depois que o servidor for iniciado, você poderá executar seu aplicativo no serviço local.