本文介绍在本地模式下配置 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 本地服务器。 启动服务器后,可以针对本地服务运行应用程序。