如何:使用 AzureClient 进行本地测试

本文介绍在本地模式下配置 AzureClient 的步骤,并使用它在本地测试 Fluid 应用程序。

配置和创建 AzureClient

可以通过传递如下所示的配置,将 AzureClient 配置为针对本地 Azure Fluid Relay 实例运行。

    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);

此示例使用 InsecureTokenProvider 生成 Azure Fluid Relay 服务将接受的身份验证令牌并签名。 但是,顾名思义,此实现不安全,不应在生产环境中使用。 有关 InsecureTokenProvider 的详细信息,请参阅 应用中的身份验证和授权

若要在本地运行,首先将终结点配置为指向域,并移植本地 Azure Fluid Relay 服务实例在 (http://localhost:7070 默认情况下) 运行。 最后一步是将它LOCAL_MODE_TENANT_ID设置为 tenantId 。 所有这些设置将 AzureClient 配置为使用本地 Azure Fluid Relay 服务。

启用调试日志记录

可以在浏览器控制台中使用以下设置从 Fluid Framework 启用内置调试日志记录。

localStorage.debug = 'fluid:*'

对于更高级的方案,可以传递给 logger AzureClient。 这使你可以自定义日志记录行为。 有关记录器或遥测的详细信息,请参阅有关 fluidframework.com 的 日志记录和遥测 数据。

在本地运行 Azure Fluid Relay 服务

若要使用 AzureClient 的本地模式,首先需要启动本地服务器。 从终端窗口运行 npx @fluidframework/azure-local-service@latest 将启动 Azure Fluid Relay 本地服务器。 启动服务器后,可以针对本地服务运行应用程序。