Instrukcje: używanie elementu AzureClient do testowania lokalnego

W tym artykule przedstawiono kroki konfigurowania elementu AzureClient w trybie lokalnym i używania go do lokalnego testowania aplikacji Fluid.

Konfigurowanie i tworzenie elementu AzureClient

Program AzureClient można skonfigurować do uruchamiania względem lokalnego wystąpienia usługi Azure Fluid Relay, przekazując konfigurację podobną do poniższej.

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

W tym przykładzie użyto insecureTokenProvider do generowania i podpisywania tokenów uwierzytelniania akceptowanych przez usługę Azure Fluid Relay. Jednak jak sama nazwa wskazuje, ta implementacja jest niezabezpieczona i nie powinna być używana w środowiskach produkcyjnych. Aby uzyskać więcej informacji na temat insecureTokenProvider, zobacz Uwierzytelnianie i autoryzacja w aplikacji.

Aby uruchomić lokalnie, należy najpierw skonfigurować punkt końcowy w taki sposób, aby wskazywał domenę i port, na którym działa lokalne wystąpienie usługi Azure Fluid Relay (http://localhost:7070 domyślnie). Ostatnim krokiem jest ustawienie wartości tenantId LOCAL_MODE_TENANT_ID. Wszystkie te ustawienia umożliwiają skonfigurowanie klienta AzureClient do pracy z lokalną usługą Azure Fluid Relay.

Włączanie rejestrowania debugowania

Wbudowane rejestrowanie debugowania można włączyć z poziomu Elastyczna struktura przy użyciu następującego ustawienia w konsoli przeglądarki.

localStorage.debug = 'fluid:*'

W przypadku bardziej zaawansowanych scenariuszy można przekazać element logger do elementu AzureClient. Dzięki temu można dostosować zachowanie rejestrowania. Aby uzyskać więcej informacji na temat rejestratora lub telemetrii, zobacz Rejestrowanie i telemetria na fluidframework.com.

Lokalne uruchamianie usługi Azure Fluid Relay

Aby użyć trybu lokalnego programu AzureClient, należy najpierw uruchomić serwer lokalny. Uruchomienie npx @fluidframework/azure-local-service@latest z poziomu okna terminalu spowoduje uruchomienie lokalnego serwera usługi Azure Fluid Relay. Po uruchomieniu serwera możesz uruchomić aplikację względem usługi lokalnej.