Lag en Fabric-app med Rayfin CLI

Denne veiledningen viser deg hvordan du bruker Rayfin CLI til å lage et prosjekt, kjøre det lokalt og distribuere det til Fabric. Du bruker samme CLI-arbeidsflyt for nye apper og for senere oppdateringer av skjemaet eller frontenden din.

I denne opplæringen:

  • Lag et Fabric Apps-prosjekt fra en mal.
  • Start appen lokalt.
  • Logg inn på Fabric fra CLI-en.
  • Distribuer appen til et Fabric-arbeidsområde.
  • Verifiser deployeringsstatusen.

Forutsetninger

  • Tilgang til Fabric.
  • Et Fabric-arbeidsområde hvor du har tillatelser som bidragsyter, medlem eller administrator.
  • Fabric Apps-arbeidsbelastningen er aktivert i leietakeren din.
  • Node.js og NPM installert.

Lag en app med en AI-prompt

Bruk følgende prompt med GitHub Copilot eller en annen kodeagent for å lage, utforske, kjøre, tilpasse og distribuere 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 kjører kommandoene interaktivt og ber om nødvendige prosjekt- eller arbeidsområdeinnstillinger. Gå gjennom genererte filer og kommandoutdata før utrulling. Hvis Fabric Apps-arbeidsbelastningen ennå ikke er aktivert, be en Fabric-administrator om å aktivere Fabric Apps (forhåndsvisning) i OneLake-katalogen>Govern>Configurations>Workloads.

Lag en ny app fra CLI

For å bygge opp en ny app fra en mal, bruk npm create:

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

Denne kommandoen oppretter en ny prosjektmappe med app-malen, konfigurasjonen rayfin og frontend-kildekoden.

Gå til prosjektkatalogen:

cd my-app

Tips

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

npx rayfin init .

Gå gjennom det genererte prosjektet

Etter stillaset inkluderer prosjektet filene du trenger for å begynne å utvikle:

  • rayfin/rayfin.yml Lagrer app-tjenester og distribusjonsinnstillinger.
  • rayfin/.env lagrer miljøverdier brukt av CLI.
  • rayfin/data/ inneholder dine datamodellfiler.
  • Frontend-appen din ligger i rotprosjektstrukturen som opprettes av den valgte malen.

For en detaljert fil-for-fil-gjennomgang, se Forstå prosjektstrukturen.

Kjør appen lokalt

Start det lokale utviklingsmiljøet:

npx rayfin dev

Denne kommandoen starter frontend-utviklingsserveren for den støttede appen og distribuerer backend til Fabric. For å bekrefte at appen starter riktig, åpne den lokale URL-en som vises i terminalen.

Distribuer appen til Fabric

Bygg inn flere funksjoner i applikasjonen din. Etter at du har testet endringene dine, distribuer til Fabric igjen.

npx rayfin up

For å forhåndsvise distribusjonen uten å gjøre endringer, kjør:

npx rayfin up --dry-run

Bekreft distribusjonen

Sjekk nåværende utplasseringsstatus:

npx rayfin up status

For et maskinlesbart svar, bruk JSON-utdata:

npx rayfin up status --json

Etter en vellykket distribusjon skriver CLI-en ut URL-en til den hostede appen og Fabric-portallenken for det distribuerte elementet.

Distribuer kun database- eller statisk innhold

Hvis du bare har endret datamodeller, bruk databaseendringene uten full redistribusjon:

npx rayfin up db apply

Hvis du bare endret frontend-kode, deployer du de statiske ressursene på nytt:

npx rayfin up staticapp deploy

Legg til funksjoner

Funksjoner er TypeScript-funksjoner som kjører på serveren inne i Fabric-appen din. Bruk funksjoner for logikk som ikke må kjøres i nettleseren, som å jobbe med hemmeligheter, få tilgang til privilegerte data og kalle nedstrømstjenester på vegne av den innloggede brukeren.

npx rayfin functions init

GitHub Copilot kan generere og oppdatere nødvendige filer og komponenter. Du kan også be agenten kjøre appen, feilsøke funksjoner lokalt og distribuere appen. For eksempel kan du bruke følgende prompt for å bygge en AI-pull request-gjennomgangsassistent ved å bruke funksjoner:

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.

Feilsøk vanlige problemer

Innloggingsfeil eller utrulling returnerer 401 eller 403

Kjør npx rayfin login igjen, og prøv npx rayfin upigjen.

Du må inspisere hva CLI vil gjøre

Før du distribuerer endringer, kjør npx rayfin up --dry-run.

Appen deployeres, men du endrer bare skjemaet

For å pushe skjemaendringer uavhengig, bruk npx rayfin up db apply. Hvis du utfører destruktive endringer som å endre typen på en kolonne eller fjerne en kolonne, feiler denne kommandoen. For å tvinge frem endringene dine, kan du bruke flagget --force . Denne handlingen kan være en avgjørende endring.

Neste trinn

  • Sist oppdatert