Distribuer en Fabric-app til Fabric

Distribuer en Fabric app til Fabric ved å logge inn, kjøre CLI-distribusjonsflyten og gjennomgå hva npx rayfin up konfigurerer for appen din. Denne artikkelen går gjennom konseptet for hva som skjer under utplassering.

Forutsetninger

  • Et Fabric Apps-prosjekt med en rayfin/rayfin.yml konfigurasjonsfil. Hvis du ikke har et prosjekt ennå, se Create your first Fabric Apps project.
  • En Microsoft Entra ID-konto med tilgang til et Fabric-arbeidsområde.

Distribuer applikasjonen din

Kjør følgende kommando fra prosjektroten din:

npx rayfin up

Hvis du ikke er logget inn, starter CLI-en automatisk en interaktiv innloggingsflyt.

Hva utplasseringen gjør

Kommandoen rayfin up utfører disse stegene i rekkefølge:

  1. Oppretter et Fabric Apps-element i Fabric-arbeidsområdet ditt (eller gjenbruker det eksisterende ved påfølgende distribusjoner).
  2. Henter den publiserbare nøkkelen fra den eksterne tjenesten.
  3. Synkroniserer runtime-innstillinger fra din rayfin.yml til den eksterne tjenesten, inkludert autentiseringskonfigurasjon og tjenesteflagg.
  4. Anvender databaseskjemaet generert fra dine TypeScript-datamodell-dekoratører.
  5. Bygger og distribuerer statisk innhold hvis staticHosting det er aktivert i rayfin.yml—kjører byggekommandoen din, pakker utdatamappen i en ZIP, og laster den opp.
  6. Lagrer distribusjonsdetaljer og rayfin.yml.env.fabric-* filer for påfølgende distribusjoner.

Etter utplassering skriver CLI-en ut:

  • Hosting-URL-en der appen din er aktiv
  • En Fabric-portal-lenke for å administrere utrullingen
  • Distribusjons-ID-en som referanse

Konfigurer godkjenning

Kun Fabric meglet autentisering (Entra SSO) støttes på distribuerte applikasjoner. E-post- og passordautentisering er tilgjengelig under lokal utvikling, men fungerer ikke etter distribusjon til Fabric.

Sørg for at rayfin.yml har Fabric autentisering aktivert før du kjører rayfin up:

services:
  auth:
    enabled: true
    fabric:
      enabled: true

Forhåndsvisningsdistribusjon uten endringer

Bruk --dry-run for å se hva CLI-en vil gjøre uten å opprette eller endre noen ressurser:

npx rayfin up --dry-run

Bruk databaseendringer

Etter å ha oppdatert datamodellene dine, send skjemaendringer til den eksterne databasen uten å deployere hele stakken på nytt:

npx rayfin up db apply

Hvis skjemaendringen innebærer potensielt destruktive operasjoner (å fjerne kolonner, omdøpe tabeller), advarer CLI-en deg og nekter å fortsette. Bruk --force for å overstyre sikkerhetssjekken:

npx rayfin up db apply --force

Forsiktig!

--force Bruk kan føre til datatap. Gå nøye gjennom de oppførte operasjonene og bekreft at du aksepterer konsekvensene før du går videre.

Redistribuer statisk innhold

Når du bare endret frontend-kode, distribuer statisk innhold uavhengig for en raskere iterasjonssyklus:

npx rayfin up staticapp deploy

Denne kommandoen kjører din konfigurerte buildCommand, pakker utdataen og laster den opp til den eksterne tjenesten.

For å hoppe over byggesteget og distribuere eksisterende output:

npx rayfin up staticapp deploy --skip-build

Sjekk utrullingsstatus

Se den nåværende tilstanden for din Fabric-utplassering:

npx rayfin up status

Legg til --json for maskinlesbar utdata:

npx rayfin up status --json

Oppdater eksisterende distribusjoner

Etter første distribusjon rayfin.yml lagrer distribusjonsdetaljene (rayfinItemId, fabricWorkspaceId, og gjenstandsendepunktet). Å kjøre npx rayfin up på nytt oppdaterer samme distribusjon i stedet for å opprette en ny.

For målrettede oppdateringer, bruk underkommandoene:

Kommando Hva den oppdaterer
npx rayfin up Alt: innstillinger, database og statisk innhold.
npx rayfin up db apply Kun databaseskjema.
npx rayfin up staticapp deploy Kun statisk innhold.

Feilsøking av utrullingsproblemer

Utrulling feiler med 401- eller 403-feil

Økten din kan ha utløpt. Kjør npx rayfin login for å autentisere på nytt, og prøv npx rayfin uppå nytt.

Databaseapplikasjon rapporterer destruktive endringer

Rayfin CLI blokkerer skjemaendringer som kan føre til datatap. Gå gjennom de oppførte operasjonene og bruk npx rayfin up db apply --force dem kun etter at du har bekreftet at du aksepterer datatapet.

Statisk utrulling overstiger størrelsesgrensen

Det komprimerte arkivet må ikke overstige 100 MB. Optimaliser byggeutdataene dine ved å utelate kildekart og store utviklingsressurser, eller flytt binære filer til Fabric Apps-lagring.

Administrer appen din i Fabric-portalen

Etter utrulling kan du administrere Fabric-appen din direkte i Fabric-portalen.

Se gjenstandsegenskaper

Åpne Fabric-appen i Fabric-portalen for å se:

  • App-URL — Den offentlige URL-en hvor ditt statiske innhold er hostet.
  • App backend-URL — Grunn-URL-en for alle backend-tjenester.

Administrere barnetjenester

Velg Fabric-appen for å se dens barnetjenester:

  • SQL Database — Åpner den Fabric SQL-spørringseditoren. Du kan kjøre leseforespørsler mot dataene dine. Skjemaendringer som gjøres direkte i Fabric-portalen overskrives ved neste rayfin up deploy.
  • Autentisering — Se og administrer autentiserte brukere i Users-tabellen i den underordnede SQL-databasen.

Apptillatelser

For alle bidragsytere til Fabric-appen, for å distribuere en Fabric-app, trenger de minst Edit tillatelse på objektet.

Relatert innhold

  • Last updated on