Menerapkan aplikasi Fabric ke Fabric

Terapkan aplikasi Fabric ke Fabric dengan masuk, menjalankan alur deployment CLI, dan meninjau apa yang dikonfigurasi oleh npx rayfin up untuk aplikasi Anda. Artikel ini menjelaskan konsep apa yang terjadi selama penyebaran.

Prasyarat

  • Proyek Fabric Apps dengan file konfigurasi rayfin/rayfin.yml. Jika Anda belum memiliki proyek, lihat Buat proyek Fabric Apps pertama Anda.
  • Akun Microsoft Entra ID dengan akses ke ruang kerja Fabric.

Menyebarkan aplikasi Anda

Jalankan perintah berikut dari akar proyek Anda:

npx rayfin up

Jika Anda tidak masuk, CLI meluncurkan alur masuk interaktif secara otomatis.

Fungsi penerapan

Perintah rayfin up melakukan langkah-langkah ini secara berurutan:

  1. Membuat item aplikasi Fabric di ruang kerja Fabric Anda (atau menggunakan kembali item yang sudah ada pada penyebaran berikutnya).
  2. Mengambil kunci yang dapat diterbitkan dari layanan jarak jauh.
  3. Menyinkronkan pengaturan runtime dari Anda rayfin.yml ke layanan jarak jauh, termasuk konfigurasi autentikasi dan bendera layanan.
  4. Menerapkan skema database yang dihasilkan dari dekorator model data TypeScript Anda.
  5. Membangun dan menyebarkan konten statis jika staticHosting diaktifkan di rayfin.yml—menjalankan perintah build Anda, mengemas folder output ke dalam ZIP, dan mengunggahnya.
  6. Menyimpan detail deployment ke file rayfin.yml dan .env.fabric-* untuk deployment berikutnya.

Setelah penerapan, CLI menampilkan:

  • URL hosting tempat aplikasi Anda ditayangkan
  • Tautan portal Fabric untuk mengelola penyebaran
  • ID penerapan sebagai referensi

Konfigurasikan autentikasi

Hanya autentikasi broker Fabric (Entra SSO) yang didukung untuk aplikasi yang diterapkan. Autentikasi email dan kata sandi tersedia selama pengembangan lokal tetapi tidak berfungsi setelah menyebarkan ke Fabric.

Pastikan rayfin.yml Anda mengaktifkan autentikasi Fabric sebelum menjalankan rayfin up:

services:
  auth:
    enabled: true
    fabric:
      enabled: true

Pratinjau penerapan tanpa perubahan

Gunakan --dry-run untuk melihat apa yang akan dilakukan CLI tanpa membuat atau memodifikasi sumber daya apa pun:

npx rayfin up --dry-run

Menerapkan perubahan database

Setelah memperbarui model data Anda, dorong perubahan skema ke database jarak jauh tanpa menyebarkan ulang tumpukan penuh:

npx rayfin up db apply

Jika perubahan skema melibatkan operasi yang berpotensi merusak (menghilangkan kolom, mengganti nama tabel), CLI memperingatkan Anda dan menolak untuk melanjutkan. Gunakan --force untuk mengambil alih pemeriksaan keamanan:

npx rayfin up db apply --force

Caution

Menggunakan --force dapat menyebabkan kehilangan data. Tinjau operasi yang tercantum dengan hati-hati dan konfirmasikan bahwa Anda menerima konsekuensi sebelum melanjutkan.

Menyebarkan ulang konten statis

Ketika Anda hanya mengubah kode frontend, sebarkan ulang konten statis secara independen untuk siklus iterasi yang lebih cepat:

npx rayfin up staticapp deploy

Perintah ini menjalankan konfigurasi Anda buildCommand, mengemas output, dan mengunggahnya ke layanan jarak jauh.

Untuk melewati langkah build dan menyebarkan output yang ada:

npx rayfin up staticapp deploy --skip-build

Memeriksa status penyebaran

Lihat status penyebaran Fabric Anda saat ini:

npx rayfin up status

Tambahkan --json untuk output yang dapat dibaca mesin:

npx rayfin up status --json

Memperbarui penyebaran yang ada

Setelah penyebaran pertama, rayfin.yml menyimpan detail penyebaran (rayfinItemId, fabricWorkspaceId, dan titik akhir item). Menjalankan npx rayfin up lagi akan memperbarui deployment yang sama alih-alih membuat deployment baru.

Untuk pembaruan yang ditargetkan, gunakan sub-perintah:

Perintah Apa yang diperbarui
npx rayfin up Semuanya: pengaturan, database, dan konten statis.
npx rayfin up db apply Skema basis data saja.
npx rayfin up staticapp deploy Konten statis saja.

Memecahkan masalah penyebaran

Penerapan gagal dengan error 401 atau 403

Sesi Anda mungkin telah kedaluwarsa. Jalankan npx rayfin login untuk mengotortikasi ulang, lalu coba npx rayfin uplagi .

Database menerapkan perubahan yang merusak laporan

Rayfin CLI memblokir perubahan skema yang dapat menyebabkan kehilangan data. Tinjau operasi yang tercantum dan gunakan npx rayfin up db apply --force hanya setelah Anda mengonfirmasi bahwa Anda menerima risiko kehilangan data.

Penyebaran statis melebihi batas ukuran

Arsip terkompresi tidak boleh melebihi 100 MB. Optimalkan output build Anda dengan mengecualikan peta sumber dan aset pengembangan besar, atau pindahkan file biner ke penyimpanan Fabric Apps.

Mengelola aplikasi Anda di portal Fabric

Setelah penyebaran, Anda dapat mengelola aplikasi Fabric langsung di portal Fabric.

Lihat properti item

Buka aplikasi Fabric di portal Fabric untuk melihat:

  • URL Aplikasi — URL publik tempat konten statis Anda dihosting.
  • URL backend aplikasi — URL dasar untuk semua layanan backend.

Mengelola layanan anak

Pilih aplikasi Fabric untuk melihat layanan anaknya:

  • SQL Database — Membuka editor kueri SQL Fabric. Anda dapat menjalankan kueri baca terhadap data Anda. Perubahan skema yang dilakukan langsung di portal Fabric akan ditimpa pada deployment rayfin up berikutnya.
  • Autentikasi — Menampilkan dan mengelola pengguna terautentikasi dalam tabel Pengguna di SQL Database anak.

Izin aplikasi

Untuk setiap kontributor aplikasi Fabric, untuk menyebarkan aplikasi Fabric, mereka memerlukan setidaknya Edit izin pada item.

Konten terkait

  • Last updated on