Opret en Fabric-app med Rayfin CLI

Denne vejledning viser dig, hvordan du bruger Rayfin CLI til at oprette et projekt, køre det lokalt og deployere det til Fabric. Du bruger den samme CLI-arbejdsgang til nye apps og til senere opdateringer af dit skema eller frontend.

I dette selvstudium skal du:

  • Opret et Fabric Apps-projekt ud fra en skabelon.
  • Start appen lokalt.
  • Log ind på Fabric fra CLI.
  • Udrul appen til et Fabric-arbejdsområde.
  • Bekræft udrulningsstatus.

Forudsætninger

  • Adgang til Fabric.
  • Et Fabric-arbejdsområde, hvor du har tilladelser til bidragsyger, medlem eller administrator.
  • Fabric Apps-arbejdsbelastningen er aktiveret i din lejer.
  • Node.js og NPM installeret.

Opret en app med en AI-prompt

Brug følgende prompt med GitHub Copilot eller en anden kodningsagent til at oprette, udforske, køre, tilpasse og udrulle 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ører kommandoerne interaktivt og beder om eventuelle nødvendige projekt- eller arbejdsområdeindstillinger. Gennemgå genererede filer og kommandouddata før udrulning. Hvis Fabric Apps-arbejdsbelastningen endnu ikke er aktiveret, kan du bede en Fabric-administrator om at aktivere Fabric Apps (preview) i OneLake-kataloget>Govern>Configurations>Workloads.

Opret en ny app fra CLI

For at støtte en ny app ud fra en skabelon, brug npm create:

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

Denne kommando opretter en ny projektmappe med app-skabelonen, konfigurationen rayfin og frontend-kildekoden.

Gå til projektmappen:

cd my-app

Tip

Hvis du allerede har en tom projektmappe eller eksisterende kildekode, brug npx rayfin init i stedet for npm create.

npx rayfin init .

Gennemgå det genererede projekt

Efter stilladset indeholder projektet de filer, du skal begynde at udvikle:

  • rayfin/rayfin.yml gemmer app-tjenester og udrulningsindstillinger.
  • rayfin/.env gemmer miljøværdier, der bruges af CLI'en.
  • rayfin/data/ indeholder dine datamodelfiler.
  • Din frontend-app ligger i root-projektstrukturen, som den valgte skabelon opretter.

For en detaljeret fil-for-fil opdeling, se Forstå projektstrukturen.

Kør appen lokalt

Start det lokale udviklingsmiljø:

npx rayfin dev

Denne kommando starter frontend-udviklingsserveren for den stilladsbaserede app og deployerer backend til Fabric. For at bekræfte, at appen starter korrekt, åbn den lokale URL, der vises i terminalen.

Udrul appen til Fabric

Indbyg flere funktioner i din applikation. Efter du har testet dine ændringer, deploy til Fabric igen.

npx rayfin up

For at forhåndsvise udrulningen uden at foretage ændringer, kør:

npx rayfin up --dry-run

Kontrollér installationen

Tjek den nuværende udrulningstilstand:

npx rayfin up status

For et maskinlæsbart svar, brug JSON-output:

npx rayfin up status --json

Efter en vellykket udrulning udskriver CLI'en URL'en til den hostede app og Fabric-portallinket til det deployerede objekt.

Udrul kun database- eller statisk indhold

Hvis du kun har ændret datamodeller, skal du anvende databaseændringerne uden en fuld redeploy:

npx rayfin up db apply

Hvis du kun har ændret frontend-koden, så genudrul de statiske assets:

npx rayfin up staticapp deploy

Tilføj funktioner

Funktioner er TypeScript-funktioner, der kører på serveren inde i din Fabric-app. Brug funktioner til logik, der ikke må køre i browseren, såsom at arbejde med hemmeligheder, tilgå privilegerede data og kalde nedstrømstjenester på vegne af den indloggede bruger.

npx rayfin functions init

GitHub Copilot kan generere og opdatere de nødvendige filer og komponenter. Du kan også bede agenten om at køre appen, fejlfinde funktioner lokalt og deploye appen. For eksempel kan du bruge følgende prompt til at bygge en AI-pull request-gennemgangsassistent ved hjælp af 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.

Fejlfinding af almindelige problemer

Login-fejl eller udrulning returnerer 401 eller 403

Kør npx rayfin login igen, og prøv npx rayfin upså igen.

Du skal inspicere, hvad CLI vil gøre

Før du implementerer ændringer, kør npx rayfin up --dry-run.

Appen deployer, men du ændrer kun skemaet

For at skubbe skemaændringer uafhængigt brug npx rayfin up db apply. Hvis du udfører destruktive ændringer som at ændre typen af en kolonne eller fjerne en kolonne, fejler denne kommando. For at tvinge dine ændringer kan du bruge flaget --force . Denne handling kan være en ødelæggende ændring.

Næste trin

  • Sidst opdateret den