Skapa en Fabric app med Rayfin CLI

Den här självstudien visar hur du använder Rayfin CLI för att skapa ett projekt, köra det lokalt och distribuera det till Microsoft Fabric. Du använder samma CLI-arbetsflöde för nya appar och för senare uppdateringar av schemat eller klientdelen.

I den här handledningen kommer du att:

  • Skapa ett Fabric Apps-projekt från en mall.
  • Starta appen lokalt.
  • Logga in på Microsoft Fabric från CLI.
  • Distribuera appen till en Fabric arbetsyta.
  • Kontrollera statusen för driftsättningen.

Förutsättningar

  • Åtkomst till Microsoft Fabric.
  • En Fabric arbetsyta där du har behörighet som deltagare, medlem eller administratör.
  • Arbetsbelastningen Fabric Apps aktiverad i din klientorganisation.
  • Node.js och npm installerat.

Om arbetsbelastningen för Fabric Apps ännu inte har aktiverats ber du en Fabric-administratör att slå på Fabric Apps (förhandsversion) i Fabric-administratörsportalen.

Steg 1: Skapa ett nytt projekt

Om du vill skapa en ny app från en mall använder du npm create:

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

Det här kommandot skapar en ny projektmapp med appmallen, konfigurationen rayfin och klientdelens källkod.

Gå till projektkatalogen:

cd my-app

Tips/Råd

Om du redan har en tom projektmapp eller befintlig källkod använder du npx rayfin init i stället för npm create.

npx rayfin init .

Steg 2: Granska det genererade projektet

När projektet har skapats innehåller det de filer du behöver för att börja utveckla:

  • rayfin/rayfin.yml lagrar apptjänster och distributionsinställningar.
  • rayfin/.env lagrar miljövärden som används av CLI.
  • rayfin/data/ innehåller dina datamodellfiler.
  • Frontendappen ligger i projektets rotstruktur som skapats av den valda mallen.

En detaljerad fil-för-fil-uppdelning finns i Förstå projektstrukturen.

Steg 3: Kör appen lokalt

Starta den lokala utvecklingsmiljön:

npm run dev

Det här kommandot startar frontend-utvecklingsservern för den genererade appen och distribuerar backenden till Fabric. Bekräfta att appen startar korrekt genom att öppna den lokala URL:en som visas i terminalen.

Steg 4: Distribuera appen till Fabric

Skapa fler funktioner i ditt program. När du har testat ändringarna distribuerar du till Fabric igen.

npx rayfin up

Om du vill förhandsgranska distributionen utan att göra ändringar kör du:

npx rayfin up --dry-run

Steg 5: Verifiera distributionen

Kontrollera den aktuella driftsättningsstatusen:

npx rayfin up status

För ett maskinläsbart svar använder du JSON-utdata:

npx rayfin up status --json

Efter en lyckad distribution skriver CLI ut den värdbaserade app-URL:en och länken Fabric portal för det distribuerade objektet.

Steg 6: Distribuera endast databas eller statiskt innehåll

Om du bara har ändrat datamodeller tillämpar du databasändringarna utan en fullständig omdistribuering:

npx rayfin up db apply

Om du bara har ändrat frontend-koden, driftsätt om de statiska resurserna:

npx rayfin up staticapp deploy

Felsökning av vanliga problem

Inloggningen misslyckas eller distributionen returnerar 401 eller 403

Kör npx rayfin login igen och försök npx rayfin upsedan igen .

Du måste kontrollera vad CLI kommer att göra

Innan du distribuerar ändringar kör du npx rayfin up --dry-run.

Appen distribueras, men du ändrar endast schemat

Om du vill skicka schemaändringar oberoende av varandra använder du npx rayfin up db apply. Om du utför destruktiva ändringar som att ändra typen av en kolumn eller ta bort en kolumn misslyckas det här kommandot. Om du vill tvinga igenom dina ändringar kan du använda flaggan --force. Den här åtgärden kan innebära en ändring som bryter bakåtkompatibilitet.

Nästa steg

  • Last updated on