Membuat aplikasi Fabric dengan Rayfin CLI

Tutorial ini menunjukkan kepada Anda cara menggunakan Rayfin CLI untuk membuat proyek, menjalankannya secara lokal, dan menyebarkannya ke Microsoft Fabric. Anda menggunakan alur kerja CLI yang sama untuk aplikasi baru dan untuk pembaruan nanti pada skema atau frontend Anda.

Di tutorial ini, Anda akan:

  • Buat proyek Fabric Apps dari templat.
  • Mulai aplikasi secara lokal.
  • Masuk ke Microsoft Fabric dari CLI.
  • Sebarkan aplikasi ke ruang kerja Fabric.
  • Verifikasi status penyebaran.

Prasyarat

  • Akses ke Microsoft Fabric.
  • Ruang kerja Fabric tempat Anda memiliki izin Kontributor, Anggota, atau Admin.
  • Fitur Fabric Apps yang diaktifkan di tenant Anda
  • Node.js dan npm terinstal.

Jika beban kerja Fabric Apps belum diaktifkan, minta administrator Fabric untuk mengaktifkan Fabric Apps (pratinjau) di portal admin Fabric.

Langkah 1: Buat proyek baru

Untuk membuat aplikasi baru dari templat, gunakan npm create:

npm create @microsoft/rayfin@latest -- my-app --workspace <workspacename>

Perintah ini membuat folder proyek baru dengan templat aplikasi, rayfin konfigurasi, dan kode sumber frontend.

Buka direktori proyek:

cd my-app

Tip

Jika Anda sudah memiliki folder proyek kosong atau kode sumber yang sudah ada, gunakan npx rayfin init alih-alih npm create.

npx rayfin init .

Langkah 2: Tinjau proyek yang dihasilkan

Setelah kerangka proyek dibuat, proyek ini mencakup file-file yang Anda perlukan untuk mulai mengembangkan proyek:

  • rayfin/rayfin.yml menyimpan layanan aplikasi dan pengaturan penyebaran.
  • rayfin/.env menyimpan nilai lingkungan yang digunakan oleh CLI.
  • rayfin/data/ berisi file model data Anda.
  • Aplikasi frontend Anda berada di struktur proyek akar yang dibuat oleh templat yang dipilih.

Untuk perincian file demi file terperinci, lihat Memahami struktur proyek.

Langkah 3: Jalankan aplikasi secara lokal

Mulai lingkungan pengembangan lokal:

npm run dev

Perintah ini memulai server pengembangan frontend untuk aplikasi perancah dan menyebarkan backend ke Fabric. Untuk mengonfirmasi aplikasi dimulai dengan benar, buka URL lokal yang ditampilkan di terminal.

Langkah 4: Sebarkan aplikasi ke Fabric

Bangun lebih banyak fitur ke dalam aplikasi Anda. Setelah Menguji perubahan, sebarkan ke Fabric lagi.

npx rayfin up

Untuk mempratinjau penyebaran tanpa membuat perubahan, jalankan:

npx rayfin up --dry-run

Langkah 5: Verifikasi penyebaran

Periksa status penyebaran saat ini:

npx rayfin up status

Untuk respons yang dapat dibaca mesin, gunakan output JSON:

npx rayfin up status --json

Setelah penyebaran berhasil, CLI mencetak URL aplikasi yang dihosting dan tautan portal Fabric untuk item yang disebarkan.

Langkah 6: Terapkan basis data atau hanya konten statis

Jika Anda hanya mengubah model data, terapkan perubahan database tanpa penyebaran ulang penuh:

npx rayfin up db apply

Jika Anda hanya mengubah kode frontend, sebarkan ulang aset statis:

npx rayfin up staticapp deploy

Mengatasi masalah umum

Proses masuk gagal atau penyebaran mengembalikan 401 atau 403

Jalankan npx rayfin login lagi, lalu coba npx rayfin uplagi .

Anda perlu memeriksa apa yang akan dilakukan CLI

Sebelum menyebarkan perubahan, jalankan npx rayfin up --dry-run.

Aplikasi berhasil di-deploy, tetapi Anda hanya mengubah skema

Untuk mendorong perubahan skema secara independen, gunakan npx rayfin up db apply. Jika Anda melakukan perubahan destruktif seperti mengubah jenis kolom atau menghapus kolom, perintah ini gagal. Untuk memaksa perubahan, Anda dapat menggunakan --force bendera. Tindakan ini bisa menjadi perubahan yang melanggar.

Langkah berikutnya

  • Last updated on