방법: 로컬 테스트에 AzureClient 사용

이 문서에서는 로컬 모드에서 AzureClient를 구성하고 이를 사용하여 Fluid 애플리케이션을 로컬에서 테스트하는 단계를 안내합니다.

AzureClient 구성 및 만들기

AzureClient는 아래와 같은 구성을 전달하여 로컬 Azure Fluid Relay 인스턴스에 대해 실행되도록 구성할 수 있습니다.

    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에 대한 자세한 내용은 앱의 인증 및 권한 부여을 참조하세요.

로컬로 실행하려면 먼저 로컬 Azure Fluid Relay 서비스 인스턴스가 실행 중인 도메인 및 포트(기본적으로 http://localhost:7070)를 가리키도록 엔드포인트를 구성합니다. 마지막 단계는 tenantId를 LOCAL_MODE_TENANT_ID로 설정하는 것입니다. 이러한 모든 설정은 로컬 Azure Fluid Relay 서비스와 함께 작동하도록 AzureClient를 함께 구성합니다.

디버그 로깅 사용

브라우저 콘솔에서 다음 설정을 사용하여 Fluid Framework에서 기본 제공 디버그 로깅을 사용하도록 설정할 수 있습니다.

localStorage.debug = 'fluid:*'

고급 시나리오의 경우 logger를 AzureClient에 전달할 수 있습니다. 이렇게 하면 로깅 동작을 사용자 지정할 수 있습니다. 로거 또는 원격 분석에 대한 자세한 내용은 fluidframework.com에서 로깅 및 원격 분석을 참조하세요.

Azure Fluid Relay 서비스를 로컬로 실행

AzureClient의 로컬 모드를 사용하려면 먼저 로컬 서버를 시작해야 합니다. 터미널 창에서 npx @fluidframework/azure-local-service@latest를 실행하면 Azure Fluid Relay 로컬 서버가 시작됩니다. 서버가 시작되면 로컬 서비스에 대해 애플리케이션을 실행할 수 있습니다.