Guide pratique : Utiliser AzureClient pour les tests locaux

Cet article décrit les étapes de configuration d’AzureClient en mode local et comment l’utiliser pour tester votre application Fluid localement.

Configurer et créer une instance AzureClient

AzureClient peut être configuré pour s’exécuter sur une instance Relais Azure Fluid locale en lui passant une configuration comme celle qui suit.

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

Cet exemple utilise InsecureTokenProvider pour générer et signer des jetons d’authentification que le service Relais Azure Fluid doit accepter. Toutefois, comme son nom l’indique, cette implémentation n’est pas sécurisée et ne doit pas être utilisée dans des environnements de production. Pour plus d’informations sur InsecureTokenProvider, consultez Authentification et autorisation dans votre application.

Pour une exécution locale, vous devez d’abord configurer le point de terminaison de sorte qu’il pointe vers le domaine et le port sur lesquels l’instance du service Relais Azure Fluid locale s’exécute (http://localhost:7070 par défaut). La dernière étape consiste à définir tenantId sur LOCAL_MODE_TENANT_ID. Tous ces paramètres configurent AzureClient pour qu’il fonctionne avec un service Relais Azure Fluid local.

Enabling debug logging

Vous pouvez activer la journalisation de débogage intégrée à partir de l’infrastructure Fluid à l’aide du paramètre suivant dans une console de navigateur.

localStorage.debug = 'fluid:*'

Dans les scénarios plus avancés, vous pouvez passer un logger à AzureClient. Cela vous permet de personnaliser le comportement de journalisation. Pour plus d’informations sur l’enregistreur d’événements ou la télémétrie, consultez Journalisation et télémétrie sur fluidframework.com.

Exécution du service Relais Azure Fluid localement

Pour utiliser le mode local d’AzureClient, vous devez d’abord démarrer un serveur local. L’exécution de npx @fluidframework/azure-local-service@latest à partir de la fenêtre de votre terminal lance le serveur local Relais Azure Fluid. Une fois le serveur démarré, vous pouvez exécuter votre application sur le service local.