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 Microsoft 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å Microsoft Fabric fra CLI.
  • Udrul appen til et Fabric-arbejdsområde.
  • Bekræft udrulningsstatus.

Forudsætninger

  • Adgang til Microsoft 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.

Hvis Fabric Apps-arbejdsbelastningen endnu ikke er aktiveret, så bed en Fabric administrator om at slå Fabric Apps (preview) til i Fabric admin-portalen.

Trin 1: Oprette et nyt projekt

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 .

Trin 2: 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.

Trin 3: Kør appen lokalt

Start det lokale udviklingsmiljø:

npm run 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.

Trin 4: 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

Trin 5: Verificér udrulningen

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.

Trin 6: Deloy-database eller statisk indhold kun

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

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

  • Last updated on