Verwenden von AzureClient für lokale Tests

In diesem Artikel werden die Schritte zum Konfigurieren von AzureClient im lokalen Modus und zum lokalen Testen Ihrer Fluid-Anwendung beschrieben.

Konfigurieren und Erstellen von AzureClient

AzureClient kann zur Ausführung für eine lokale Azure Fluid Relay-Instanz konfiguriert werden, indem eine Konfiguration wie die folgende übergeben wird.

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

In diesem Beispiel wird der InsecureTokenProvider verwendet, um Authentifizierungstoken zu generieren und zu signieren, die vom Azure Fluid Relay-Dienst akzeptiert werden. Wie der Name schon sagt, ist diese Implementierung jedoch unsicher und sollte in Produktionsumgebungen nicht verwendet werden. Weitere Informationen zum InsecureTokenProvider finden Sie unter Authentifizierung und Autorisierung in Ihrer App.

Für die lokale Ausführung konfigurieren Sie zunächst den Endpunkt so, dass er auf die Domäne und den Port verweist, unter denen die lokale Azure Fluid Relay-Dienstinstanz ausgeführt wird (standardmäßig http://localhost:7070). Der letzte Schritt besteht darin, tenantId auf LOCAL_MODE_TENANT_ID festzulegen. Über all diese Einstellungen wird AzureClient für die Arbeit mit einem lokalen Azure Fluid Relay-Dienst konfiguriert.

Aktivieren der Debugprotokollierung

Sie können die integrierte Debugprotokollierung über das Fluid-Framework aktivieren, indem Sie die folgende Einstellung in einer Browserkonsole verwenden.

localStorage.debug = 'fluid:*'

Für komplexere Szenarien können Sie logger an AzureClient übergeben. So können Sie das Protokollierungsverhalten anpassen. Weitere Informationen zu Protokollierung oder Telemetrie finden Sie unter Protokollierung und Telemetrie auf fluidframework.com.

Lokales Ausführen des Azure Fluid Relay-Diensts

Um den lokalen Modus von AzureClient zu verwenden, müssen Sie zunächst einen lokalen Server starten. Wenn Sie npx @fluidframework/azure-local-service@latest über Ihr Terminalfenster ausführen, wird der lokale Azure Fluid Relay-Server gestartet. Nachdem der Server gestartet wurde, können Sie Ihre Anwendung für den lokalen Dienst ausführen.