Vytvorte Fabric aplikáciu s Rayfin CLI

Tento tutoriál vám ukáže, ako použiť Rayfin CLI na vytvorenie projektu, jeho lokálne spustenie a nasadenie do Microsoft Fabric. Rovnaký CLI workflow používate pre nové aplikácie a neskoršie aktualizácie schémy alebo frontendu.

V tomto kurze:

  • Vytvorte projekt Fabric Apps zo šablóny.
  • Spusti aplikáciu lokálne.
  • Prihláste sa do Microsoft Fabric cez CLI.
  • Nainštalujte aplikáciu do pracovného priestoru Fabric.
  • Overte stav nasadenia.

Predpoklady

  • Prístup k Microsoft Fabric.
  • Fabric pracovný priestor, kde máte oprávnenia prispievateľa, člena alebo administrátora.
  • Záťaž Fabric Apps je zapnutá vo vašom tenante.
  • Node.js a NPM nainštalované.

Ak záťaž Fabric Apps ešte nie je povolená, požiadajte Fabric administrátora, aby v Fabric admin portáli zapol Fabric Apps (preview).

Krok 1: Vytvorenie nového projektu

Na vytvorenie novej aplikácie zo šablóny použite npm create:

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

Tento príkaz vytvorí nový projektový priečinok s aplikačnou šablónou, konfiguráciou rayfin a zdrojovým kódom frontendu.

Prejdite do adresára projektov:

cd my-app

Tip

Ak už máte prázdny projektový priečinok alebo existujúci zdrojový kód, použite npx rayfin init namiesto .npm create

npx rayfin init .

Krok 2: Skontrolujte vygenerovaný projekt

Po scaffoldingu projekt obsahuje súbory, ktoré potrebujete začať vyvíjať:

  • rayfin/rayfin.yml Ukladajú aplikačné služby a nastavenia nasadenia.
  • rayfin/.env ukladá environmentálne hodnoty používané CLI.
  • rayfin/data/ obsahuje vaše dátové modelové súbory.
  • Vaša frontendová aplikácia sa nachádza v koreňovej štruktúre projektu vytvorenej vybranou šablónou.

Pre podrobný rozbor jednotlivých súborov pozri Pochopenie štruktúry projektu.

Krok 3: Spustiť aplikáciu lokálne

Začnite prostredie miestneho rozvoja:

npm run dev

Tento príkaz spustí frontendový vývojový server pre scaffolded aplikáciu a nasadí backend do Fabric. Aby ste si overili, že aplikácia správne štartuje, otvorte lokálnu URL adresu zobrazenú v termináli.

Krok 4: Nasadiť aplikáciu na Fabric

Zabudujte do svojej aplikácie viac funkcií. Po otestovaní zmien opäť nasad do Fabric.

npx rayfin up

Ak chcete zobraziť nasadenie bez zmien, spustite to:

npx rayfin up --dry-run

Krok 5: Overte nasadenie

Skontrolujte aktuálny stav nasadenia:

npx rayfin up status

Pre strojovo čitateľnú odpoveď použite výstup JSON:

npx rayfin up status --json

Po úspešnom nasadení CLI vytlačí URL hostovanej aplikácie a odkaz na Fabric portál pre nasadenú položku.

Krok 6: Len databáza Deloy alebo statický obsah

Ak ste zmenili len dátové modely, aplikujte zmeny databázy bez úplného opätovného nasadenia:

npx rayfin up db apply

Ak ste zmenili len frontendový kód, znovu nasadte statické assety:

npx rayfin up staticapp deploy

Riešenie bežných problémov

Prihlásenie zlyhá alebo nasadenie vráti 401 alebo 403

Spustite znova, potom to skúste npx rayfin loginnpx rayfin upznova.

Musíte skontrolovať, čo CLI urobí

Pred nasadením zmien spustite npx rayfin up --dry-run.

Aplikácia sa nasadí, ale zmeníte len schému

Na nezávislé presadzovanie zmien schémy použite npx rayfin up db apply. Ak vykonáte deštruktívne zmeny, ako je zmena typu stĺpca alebo odstránenie stĺpca, tento príkaz zlyhá. Na vynútenie zmien môžete použiť príznak.--force Tento krok môže byť zlomovou zmenou.

Ďalšie kroky

  • Last updated on