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 Microsoft 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å Microsoft Fabric fra CLI.
  • Distribuer appen til et Fabric-arbeidsområde.
  • Verifiser deployeringsstatusen.

Forutsetninger

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

Hvis Fabric Apps-arbeidsmengden ikke er aktivert ennå, be en Fabric-administrator om å aktivere Fabric Apps (preview) i Fabric admin-portalen.

Trinn 1: Opprett et nytt prosjekt

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 .

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

Trinn 3: Kjør appen lokalt

Start det lokale utviklingsmiljøet:

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

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

Trinn 5: Verifiser utrullingen

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.

Trinn 6: Deloy-database eller kun 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

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

  • Last updated on