Menyiapkan mode cloud beban kerja

Dalam artikel ini, pelajari persyaratan untuk menyebarkan beban kerja yang beroperasi di server jarak jauh dengan akses internet di Microsoft Fabric.

Penyebaran memiliki dua bagian utama:

  • Kode klien beban kerja: Kode frontend yang disematkan sebagai iFrame di UI Microsoft Fabric.
  • Backend beban kerja: Komponen sisi server backend yang memproses beban kerja Anda.

Sebarkan kedua komponen sebagai layanan cloud. Anda dapat menghosting dua komponen di server terpisah jika diperlukan.

Untuk bekerja dengan beban kerja Dalam mode cloud, Anda harus mengonfigurasi informasi dan domain aplikasi dengan benar.

Format resourceId aplikasi Microsoft Entra ID

Nilai aplikasi resourceId ID Microsoft Entra harus dalam format berikut:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>
  • Domain terverifikasi penyewa ISV: Kecocokan yang tepat dari domain terverifikasi di penyewa penerbit tanpa awalan atau subdomain apa pun. Pelajari caramenambahkan domain kustom ke Microsoft Entra.
  • Server frontend beban kerja: Nama server frontend seperti yang muncul di URL frontend (segmen tambahan di URL frontend di atas domain terverifikasi).
  • Server backend beban kerja: Nama server backend seperti yang muncul di URL backend (segmen tambahan di URL backend di atas domain terverifikasi).
  • ID Beban Kerja: ID beban kerja seperti yang muncul di manifes beban kerja.
  • ID Sumber Daya: String opsional dapat ditambahkan ke akhir resourceId nilai.

Catatan

  • *.onmicrosoft subdomain tidak diizinkan dalam URL.
  • String opsional harus berisi karakter alfanumerik (Bahasa Inggris) atau tanda hubung saja dan tidak boleh melebihi panjang 36 karakter.

Domain frontend dan backend

  • URL frontend dan backend harus berupa subdomain nilai resourceId , dengan maksimum satu segmen tambahan.
  • Domain host URL balasan harus sama dengan domain host frontend.

Contoh

  • Nilai aplikasi resourceId ID Microsoft Entra: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
  • Domain frontend: https://feserver.datafactory.contoso.com
  • Domain backend: https://beserver.datafactory.contoso.com
  • URI Pengalihan: https://feserver.datafactory.contoso.com/close

Mengonfigurasi titik akhir beban kerja

Untuk mengonfigurasi titik akhir beban kerja:

  1. Tambahkan URL backend beban kerja ke bagian CloudServiceConfiguration dalam manifes dan beri Workloadnama .

  2. Tambahkan URL frontend beban kerja ke bagian CloudServiceConfiguration dalam manifes dan beri nama Frontend.

Berikut contohnya:

<CloudServiceConfiguration>
    <Cloud>Public</Cloud>
    ...
    <Endpoints>
        <ServiceEndpoint>
        <Name>Workload</Name>
        <Url>https://beserver.datafactory.contoso.com/workload</Url>
        </ServiceEndpoint>
        <ServiceEndpoint>
        <Name>Frontend</Name>
        <Url>https://feserver.datafactory.contoso.com</Url>
        </ServiceEndpoint>
    </Endpoints>
</CloudServiceConfiguration>

Mengonfigurasi aplikasi Anda di ID Microsoft Entra

Untuk mengonfigurasi aplikasi Anda di Microsoft Entra:

  1. URL pengalihan harus menunjuk ke URL frontend Anda yang ditambahkan dengan /close. Contohnya,feserver.datafactory.contoso.com/close.
  2. URI ID aplikasi harus cocok dengan domain terverifikasi aplikasi Anda.

Catatan

Semua konfigurasi aplikasi lain di MICROSOFT Entra ID sama seperti dalam mode pengembang.

Mengonfigurasi beban kerja Anda (backend)

  1. Dalam sampel backend, buka src/appsettings.json dan konfigurasikan pengaturan berikut:

    • Untuk PublisherTenantId, pilih ID penyewa penerbit.
    • Untuk ClientId, masukkan ID aplikasi Anda (ditemukan di gambaran umum ID Microsoft Entra).
    • Untuk ClientSecret, masukkan rahasia yang Anda buat saat mengonfigurasi aplikasi ID Microsoft Entra.
    • Untuk Audiens, masukkan URI ID yang Anda konfigurasikan di aplikasi ID Microsoft Entra.

  2. Buka src/Packages/manifest/WorkloadManifest.xml.

  3. Di bawah AADApp, atur AppId, redirectUri, dan ResourceId (URI ID).

Perhatikan persyaratan yang ditentukan dalam file XSD dan gambaran umum manifes backend.

Mengonfigurasi aplikasi frontend Anda

Dalam file .env.test, atur WORKLOAD_BE_URL ke URL backend beban kerja Anda (misalnya, atur ke beserver.datafactory.contoso.com).

Berikut contohnya:

WORKLOAD_NAME=Fabric.WorkloadSample
WORKLOAD_BE_URL=beserver.datafactory.contoso.com
  • Last updated on