Практическое руководство. Использование AzureClient для локального тестирования

  • Статья

В этой статье описаны действия по настройке AzureClient в локальном режиме и его использовании для локального тестирования приложения Fluid.

Настройка и создание AzureClient

AzureClient можно настроить для запуска в локальном экземпляре Ретранслятора Azure, передав его конфигурацию, как показано ниже.

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

В этом примере используется InsecureTokenProvider для создания и подписывания маркеров проверки подлинности, которые будет принимать служба Azure Fluid Relay. Однако, как подразумевает имя, эта реализация небезопасна и не должна использоваться в рабочих средах. Дополнительные сведения о InsecureTokenProvider см. в разделе "Проверка подлинности и авторизация" в приложении.

Чтобы запустить локально, сначала настройте конечную точку для указания домена и порт, на который выполняетсяhttp://localhost:7070 локальный экземпляр службы Ретранслятора Azure (по умолчанию). Последний шаг — задать tenantId значение LOCAL_MODE_TENANT_ID. Все эти параметры вместе настраивают AzureClient для работы с локальной службой Ретранслятора Жидкости Azure.

Включение ведения журналов отладки

Вы можете включить встроенное ведение журнала отладки из Fluid Framework с помощью следующего параметра в консоли браузера.

localStorage.debug = 'fluid:*'

Для более сложных сценариев можно передать в logger AzureClient. Это позволяет настроить поведение ведения журнала. Дополнительные сведения о средстве ведения журнала или телеметрии см. в разделе "Ведение журнала и телеметрия " на fluidframework.com.

Локальное выполнение службы Ретранслятора Azure

Чтобы использовать локальный режим AzureClient, сначала необходимо запустить локальный сервер. При запуске npx @fluidframework/azure-local-service@latest из окна терминала запустится локальный сервер Ретранслятора Azure Fluid Relay. После запуска сервера вы можете запустить приложение в локальной службе.