Procedimiento: Uso de AzureClient para pruebas locales

Este artículo le guía por los pasos necesarios para configurar AzureClient en modo local y usarlo para probar cualquier aplicación de Fluid localmente.

Configuración y creación de AzureClient

AzureClient se puede configurar para ejecutarse en una instancia local de Azure Fluid Relay, para lo que se usa una configuración como la siguiente.

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

En este ejemplo se usa InsecureTokenProvider para generar y firmar tokens de autenticación que el servicio Azure Fluid Relay aceptará. Sin embargo, como su nombre indica, esta implementación no es segura y no se debe utilizar en entornos de producción. Para más información sobre InsecureTokenProvider, consulte Autenticación y autorización en la aplicación.

Para realizar la ejecución a nivel local, primero es preciso configurar el punto de conexión para que apunte al dominio y puerto en el que se ejecuta la instancia local del servicio Azure Fluid Relay (http://localhost:7070 de forma predeterminada). El último paso es establecer tenantId en LOCAL_MODE_TENANT_ID. Todos estos valores juntos configuran AzureClient para que funcione con un servicio Azure Fluid Relay local.

Habilitación del registro de depuración

Puede habilitar el registro de depuración integrado desde Fluid Framework con la siguiente configuración en una consola del explorador.

localStorage.debug = 'fluid:*'

Para escenarios más avanzados, puede usar logger en AzureClient. Esto permite personalizar el comportamiento del registro. Para más información sobre el registrador o la telemetría, consulte el artículo sobre registro y telemetría en fluidframework.com.

Ejecución local del servicio Azure Fluid Relay

Para usar el modo local de AzureClient, primero debe iniciar un servidor local. La ejecución de npx @fluidframework/azure-local-service@latest desde la ventana del terminal iniciará el servidor local de Azure Fluid Relay. Una vez iniciado el servidor, puede ejecutar la aplicación en el servicio local.