Postupy: Použití AzureClient pro místní testování

Tento článek vás provede postupem konfigurace AzureClient v místním režimu a jeho použití k místnímu otestování aplikace Fluid.

Konfigurace a vytvoření AzureClient

AzureClient je možné nakonfigurovat tak, aby běžel na místní instanci Azure Fluid Relay předáním konfigurace, jako je ta níže.

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

Tento příklad používá InsecureTokenProvider ke generování a podepisování ověřovacích tokenů, které služba Azure Fluid Relay přijme. Jak ale název napovídá, tato implementace je nezabezpečená a neměla by se používat v produkčních prostředích. Další informace o InsecureTokenProvider naleznete v tématu Ověřování a autorizace v aplikaci.

Pokud chcete spustit místně, nejprve nakonfigurujete koncový bod tak, aby ukazoval na doménu, a port, ve kterém je spuštěná místní instance služby Azure Fluid Relay (http://localhost:7070 ve výchozím nastavení). Posledním krokem je nastavení tenantId na LOCAL_MODE_TENANT_IDhodnotu . Všechna tato nastavení společně nakonfigurují AzureClient tak, aby fungovala s místní službou Azure Fluid Relay.

Povolení protokolování ladění

Integrované protokolování ladění z rozhraní Fluid Framework můžete povolit pomocí následujícího nastavení v konzole prohlížeče.

localStorage.debug = 'fluid:*'

V případě pokročilejších scénářů můžete předat logger azureClient. To vám umožní přizpůsobit chování protokolování. Další informace o protokolovacím nástroji nebo telemetrii najdete v tématu Protokolování a telemetrie v fluidframework.com.

Místní spuštění služby Azure Fluid Relay

Pokud chcete použít místní režim AzureClient, musíte nejprve spustit místní server. Spuštěním npx @fluidframework/azure-local-service@latest z okna terminálu se spustí místní server Azure Fluid Relay. Po spuštění serveru můžete aplikaci spustit proti místní službě.