Panduan penyiapan manual

Sebaiknya gunakan Panduan Penyiapan alih-alih mengikuti instruksi ini. Jika Anda tertarik dengan detailnya atau mencoba melewati beberapa langkah, Anda dapat menemukan informasi tentang cara mengonfigurasi repositori secara manual dalam artikel ini.

Membuat file konfigurasi

Repositori mengambil nilai konfigurasi dari file .env.{ENVIRONMENT}. Untuk ini, pertama-tama Anda perlu menyalin file .env.template ke .env.dev, .env.test, dan .env.prod di direktori yang sama dan mengisi nilai. Nilai dalam file tersebut digunakan dalam membuat Manifes. Untuk pengembangan lokal hanya file .env.dev yang biasanya diperlukan.

Tentukan WorkloadName dan isi dalam file .env.dev.

Mendaftarkan aplikasi front-end Microsoft Entra

Anda dapat menggunakan CreateDevAADApp.ps1 untuk membuat aplikasi Microsoft Entra baru atau Anda dapat mengikuti langkah-langkahnya.

1. Buka Pendaftaran aplikasi di Portal Microsoft Entra IDmin.
2. Buat aplikasi Multitenancy baru.

3. Tambahkan URL pengalihan SPA berikut ke manifes aplikasi:

• https://app.fabric.microsoft.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}
• https://app.powerbi.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}
• https://msit.fabric.microsoft.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}
• https://msit.powerbi.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}

Pilih {WORKLOAD_NAME} dalam proses penyiapan. Lihat Struktur Proyek di repositori.

Mencari {TENANT_ID} Anda? Ikuti langkah-langkah ini:

1. Buka Microsoft Fabric dan pilih gambar profil Anda di sudut kanan atas.
2. Pilih Tentang dari menu dropdown.
3. Dalam dialog Tentang, Anda menemukan ID Penyewa dan Wilayah Penyewa.

Setelah Aplikasi dibuat, buka file "Workload/.env.dev" dan masukkan nama Beban Kerja Anda di "WORKLOAD_NAME" dan ID klien aplikasi frontend Anda di properti konfigurasi "FRONTEND_APPID".

DevGateway

Repositori memerlukan lebih banyak perangkat lunak yang perlu diunduh. Untuk ini, Anda perlu mengunduh DevGateway dan membuka zipnya ke tools direktori.

Untuk memulai DevGateway, file konfigurasi bernama workload-dev-mode.json harus tersedia di build/DevGateway/ direktori. File ini memberi tahu DevGateway cara menemukan dan melayani beban kerja Anda.

Konfigurasi contoh:

{
    "WorkspaceGuid": "your-workspace-guid-here",
    "ManifestPackageFilePath": "path/to/Your/Repo/build/Manifest/[WorkloadName].[Version].nupkg",
    "WorkloadEndpointURL": "http://127.0.0.1:5000/workload"
}

Penjelasan kolom:

• WorkspaceGuid: GUID dari ruang kerja Fabric Anda di mana beban kerja tersedia.
• ManifestPackageFilePath: Jalur menuju paket manifes workload yang sudah dikompilasi (file .nupkg).
• WorkloadEndpointURL: URL tempat backend beban kerja Anda dihosting (biasanya server dev lokal Anda).