如何:使用 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)。 最后一步是将 tenantId 设置为 LOCAL_MODE_TENANT_ID。 结合所有这些设置,将 AzureClient 配置为与本地 Azure Fluid Relay 服务一起使用。

启用调试日志记录

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

localStorage.debug = 'fluid:*'

在更高级的方案中,可以将 logger 传递给 AzureClient。 这样一来,就可以自定义日志记录行为。 有关记录器或遥测的详细信息,请参阅 fluidframework.com 上的 Logging and telemetry(日志记录和遥测)。

在本地运行 Azure Fluid Relay 服务

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