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 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å Fabric från CLI.
  • Distribuera appen till en Fabric arbetsyta.
  • Kontrollera statusen för driftsättningen.

Förutsättningar

  • Åtkomst till 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.

Skapa en app med en AI-prompt

Använd följande prompt med GitHub Copilot eller någon annan kodagent för att skapa, utforska, köra, anpassa och distribuera en Fabric-app:

Set up a new Fabric App project called "rayfin-app-ws".

1. Run: npm create @microsoft/rayfin@latest
2. Open the scaffolded project directory.
3. Explore the project structure and understand the Rayfin app framework.
4. Run: npm run dev
5. Make changes to the app based on my instructions.
6. When ready, deploy with: npx rayfin up

Agenten kör kommandona interaktivt och frågar efter eventuella nödvändiga projekt- eller arbetsytinställningar Granska genererade filer och kommandoutdata innan utrullning. Om Fabric Apps-arbetsbelastningen ännu inte är aktiverad, be en Fabric-administratör att aktivera Fabric Apps (förhandsgranskning) i OneLake-katalogens>Govern>Configurations>Workloads.

Skapa en ny app från CLI

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 .

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.

Köra appen lokalt

Starta den lokala utvecklingsmiljön:

npx rayfin 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.

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

Verifiera driftsättningen

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.

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

Lägg till funktioner

Funktioner är TypeScript-funktioner som körs på servern i din Fabric-app. Använd funktioner för logik som inte får köras i webbläsaren, såsom att arbeta med hemligheter, få tillgång till privilegierad data och anropa nedströmstjänster för den inloggade användarens vägnar.

npx rayfin functions init

GitHub Copilot kan generera och uppdatera de nödvändiga filerna och komponenterna. Du kan också be agenten att köra appen, felsöka funktioner lokalt och distribuera appen. Till exempel kan du använda följande prompt för att bygga en AI-pull request-granskningsassistent genom att använda funktioner:

Build an app that lets me view all pull requests for the repository
<repoURL>, chat with my Azure AI Foundry agent <agentName> to review
pull requests, and post review comments. Use functions with delegated
authentication to connect to Azure AI Foundry and Azure DevOps.

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

  • Uppdaterades senast