Anvisningar: Använda AzureClient för lokal testning

Den här artikeln går igenom stegen för att konfigurera AzureClient i lokalt läge och använda den för att testa ditt Fluid-program lokalt.

Konfigurera och skapa en AzureClient

AzureClient kan konfigureras för att köras mot en lokal Azure Fluid Relay-instans genom att skicka en konfiguration som den nedan.

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

I det här exemplet används InsecureTokenProvider för att generera och signera autentiseringstoken som Azure Fluid Relay-tjänsten accepterar. Men som namnet antyder är den här implementeringen osäker och bör inte användas i produktionsmiljöer. Mer information om InsecureTokenProvider finns i Autentisering och auktorisering i din app.

Om du vill köra lokalt konfigurerar du först slutpunkten så att den pekar på domänen och porten som den lokala Azure Fluid Relay-tjänstinstansen körs på (http://localhost:7070 som standard). Det sista steget är att ange tenantId till LOCAL_MODE_TENANT_ID. Alla dessa inställningar konfigurerar tillsammans AzureClient för att fungera med en lokal Azure Fluid Relay-tjänst.

Aktivera felsökningsloggning

Du kan aktivera den inbyggda felsökningsloggningen från Fluid Framework med hjälp av följande inställning i en webbläsarkonsol.

localStorage.debug = 'fluid:*'

För mer avancerade scenarier kan du skicka en logger till AzureClient. På så sätt kan du anpassa loggningsbeteendet. Mer information om loggning eller telemetri finns i Loggning och telemetri på fluidframework.com.

Köra Azure Fluid Relay-tjänsten lokalt

Om du vill använda AzureClients lokala läge måste du först starta en lokal server. När du kör npx @fluidframework/azure-local-service@latest från terminalfönstret startas den lokala Azure Fluid Relay-servern. När servern har startats kan du köra programmet mot den lokala tjänsten.