Útmutató: Az AzureClient használata helyi teszteléshez

Ez a cikk végigvezeti az AzureClient helyi módban való konfigurálásához és a Fluid-alkalmazás helyi teszteléséhez szükséges lépéseken.

AzureClient konfigurálása és létrehozása

Az AzureClient úgy konfigurálható, hogy egy helyi Azure Fluid Relay-példányon fusson úgy, hogy az alábbihoz hasonló konfigurációt ad át neki.

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

Ez a példa az InsecureTokenProvider használatával hoz létre és ír alá hitelesítési jogkivonatokat, amelyeket az Azure Fluid Relay szolgáltatás elfogad. Azonban, ahogy a neve is mutatja, ez a megvalósítás nem biztonságos, és nem szabad éles környezetben használni. Az InsecureTokenProvider szolgáltatással kapcsolatos további információkért lásd : Hitelesítés és engedélyezés az alkalmazásban.

A helyi futtatáshoz először konfigurálja a végpontot arra a tartományra és portra, amelyen a helyi Azure Fluid Relay szolgáltatáspéldány fut (http://localhost:7070 alapértelmezés szerint). Az utolsó lépés az érték beállítása tenantIdLOCAL_MODE_TENANT_ID. Ezek a beállítások együttesen konfigurálják az AzureClientet egy helyi Azure Fluid Relay szolgáltatással való együttműködésre.

Hibakeresési naplózás engedélyezése

A beépített hibakeresési naplózást a böngészőkonzolon az alábbi beállítással engedélyezheti a Dinamikus keretrendszer.

localStorage.debug = 'fluid:*'

Speciálisabb forgatókönyvek esetén átadhat egy lehetőséget logger az AzureClientnek. Ez lehetővé teszi a naplózási viselkedés testreszabását. A naplózóval vagy telemetriával kapcsolatos további információkért lásd : Naplózás és telemetria fluidframework.com.

Az Azure Fluid Relay szolgáltatás helyi futtatása

Az AzureClient helyi módjának használatához először el kell indítania egy helyi kiszolgálót. A terminálablakból futtatva npx @fluidframework/azure-local-service@latest elindítja az Azure Fluid Relay helyi kiszolgálóját. A kiszolgáló elindítása után futtathatja az alkalmazást a helyi szolgáltatáson.