Cara: Menggunakan AzureClient untuk pengujian lokal

Artikel ini memandu melalui langkah-langkah untuk mengonfigurasi AzureClient dalam mode lokal dan menggunakannya untuk menguji aplikasi Fluid Anda secara lokal.

Mengonfigurasi dan membuat AzureClient

AzureClient dapat dikonfigurasi untuk menjalankan terhadap instans Azure Fluid Relay lokal dengan melewati konfigurasi seperti yang di bawah.

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

Contoh ini menggunakan InsecureTokenProvider untuk membuat dan menandatangani token autentikasi yang akan diterima oleh layanan Azure Fluid Relay. Namun, seperti namanya, implementasi ini tidak aman dan tidak boleh digunakan di lingkungan produksi. Untuk informasi selengkapnya tentang InsecureTokenProvider, lihat Autentikasi dan otorisasi di aplikasi Anda.

Untuk berjalan secara lokal, Anda terlebih dahulu mengonfigurasi titik akhir untuk menunjuk ke domain, dan port yang dijalankan instans layanan Azure Fluid Relay lokal di (http://localhost:7070 secara default). Langkah terakhir adalah mengatur tenantId ke LOCAL_MODE_TENANT_ID. Semua pengaturan ini bersama-sama mengonfigurasi AzureClient untuk bekerja dengan layanan Azure Fluid Relay lokal.

Mengaktifkan pengelogan debug

Anda dapat mengaktifkan pengelogan debug bawaan dari Fluid Framework menggunakan pengaturan berikut di konsol browser.

localStorage.debug = 'fluid:*'

Untuk skenario yang lebih lanjut, Anda dapat meneruskan logger ke AzureClient. Ini memungkinkan Anda menyesuaikan perilaku pengelogan. Untuk informasi selengkapnya tentang pencatata atau telemetri, lihat Pengelogan dan telemetri di fluidframework.com.

Menjalankan layanan Azure Fluid Relay secara lokal

Untuk menggunakan mode lokal AzureClient, Anda harus terlebih dahulu memulai server lokal. Menjalankan npx @fluidframework/azure-local-service@latest dari jendela terminal Anda akan meluncurkan server lokal Azure Fluid Relay. Setelah server dimulai, Anda dapat menjalankan aplikasi terhadap layanan lokal.