Procedura: Usare AzureClient per i test locali

Questo articolo illustra i passaggi per configurare AzureClient in modalità locale e usarlo per testare l'applicazione Fluid in locale.

Configurare e creare un'istanza di AzureClient

AzureClient può essere configurato per l'esecuzione in un'istanza locale di Inoltro fluido di Azure passando una configurazione simile a quella seguente.

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

Questo esempio usa InsecureTokenProvider per generare e firmare i token di autenticazione che il servizio Inoltro fluido di Azure accetterà. Tuttavia, come suggerisce il nome, questa implementazione non è sicura e non deve essere usata negli ambienti di produzione. Per altre informazioni su InsecureTokenProvider, vedere Autenticazione e autorizzazione nell'app.

Per l'esecuzione in locale, configurare prima l'endpoint in modo che punti al dominio e convertire l'istanza locale del servizio Inoltro fluido di Azure sia in esecuzione in (http://localhost:7070 per impostazione predefinita). Il passaggio finale consiste nell'impostare su tenantId LOCAL_MODE_TENANT_ID. Tutte queste impostazioni insieme configurano AzureClient per l'uso con un servizio di inoltro fluido di Azure locale.

Abilitazione della registrazione del debug

È possibile abilitare la registrazione di debug predefinita da Fluid Framework usando l'impostazione seguente in una console del browser.

localStorage.debug = 'fluid:*'

Per scenari più avanzati, è possibile passare un logger oggetto ad AzureClient. In questo modo è possibile personalizzare il comportamento di registrazione. Per altre informazioni sul logger o sui dati di telemetria, vedere Registrazione e telemetria su fluidframework.com.

Esecuzione del servizio Inoltro fluido di Azure in locale

Per usare la modalità locale di AzureClient, è prima necessario avviare un server locale. L'esecuzione npx @fluidframework/azure-local-service@latest dalla finestra del terminale avvierà il server locale di Inoltro fluido di Azure. Dopo l'avvio del server, è possibile eseguire l'applicazione nel servizio locale.