Como usar o AzureClient para teste local

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

Configurar e criar um AzureClient

O AzureClient pode ser configurado para ser executado em uma instância local do Azure Fluid Relay passando para ele uma configuração como a indicada a seguir.

    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 serão aceitos pelo serviço Azure Fluid Relay. No entanto, como o nome indica, essa implementação não é segura e não deve ser usada em ambientes de produção. Para saber mais sobre o InsecureTokenProvider, confira Autenticação e autorização em seu aplicativo.

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

Habilitando o log de depuração

Você pode habilitar o registro em log de depuração interno do Fluid Framework usando a configuração a seguir 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 do registro em log. Para saber mais sobre o agente ou a telemetria, confira Registro em log e telemetria em fluidframework.com.

Executando o serviço do Azure Fluid Relay localmente

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