Udrul en Fabric-app til Fabric

Udrul en Fabric-app til Fabric ved at logge ind, køre CLI-udrulningsflowet og gennemgå, hvad npx rayfin up konfigurerer for din app. Denne artikel gennemgår konceptet for, hvad der sker under udsendelse.

Forudsætninger

  • Et Fabric Apps-projekt med en rayfin/rayfin.yml konfigurationsfil. Hvis du endnu ikke har et projekt, så se Opret dit første Fabric Apps-projekt.
  • En Microsoft Entra ID-konto med adgang til et Fabric-arbejdsområde.

Udrul din applikation

Kør følgende kommando fra din projektrod:

npx rayfin up

Hvis du ikke er logget ind, starter CLI'en automatisk et interaktivt loginflow.

Hvad udrullingen gør

Kommandoen rayfin up udfører disse trin i rækkefølge:

  1. Opretter et Fabric Apps-element i dit Fabric-arbejdsområde (eller genbruger det eksisterende ved efterfølgende deploys).
  2. Henter den publicerbare nøgle fra fjernservicen.
  3. Synkroniserer runtime-indstillinger fra din rayfin.yml til fjerntjenesten, inklusive autentificeringskonfiguration og serviceflag.
  4. Anvender databaseskemaet genereret fra dine TypeScript-datamodel-dekoratorer.
  5. Bygger og deployerer statisk indhold, hvis staticHosting er aktiveret i rayfin.yml—kører din build-kommando, pakker output-mappen i en ZIP og uploader den.
  6. Opbevarer udrulningsdetaljer og rayfin.yml.env.fabric-* filer for efterfølgende udrulninger.

Efter udrulning udskriver CLI:

  • Hosting-URL'en, hvor din app er live
  • Et Fabric-portallink til at styre udrulningen
  • Udrulnings-ID'et til reference

Konfigurer godkendelse

Kun Fabric mæglet autentificering (Entra SSO) understøttes på deployerede applikationer. E-mail- og adgangskodegodkendelse er tilgængelig under lokal udvikling, men virker ikke efter udrulning til Fabric.

Sørg for, at din rayfin.yml har Fabric autentificering aktiveret, før du kører rayfin up:

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

Forhåndsvisning af implementering uden ændringer

Brug --dry-run den til at se, hvad CLI'en ville gøre uden at oprette eller ændre nogen ressourcer:

npx rayfin up --dry-run

Påbevar databaseændringer

Efter opdatering af dine datamodeller, skub skemaændringer til den fjernbaserede database uden at genudrulle hele stacken:

npx rayfin up db apply

Hvis skemaændringen involverer potentielt destruktive operationer (at fjerne kolonner, omdøbe tabeller), advarer CLI'en dig og nægter at fortsætte. Brug --force til at tilsidesætte sikkerhedstjekket:

npx rayfin up db apply --force

Advarsel!

--force Brug kan forårsage datatab. Gennemgå de listede operationer grundigt og bekræft, at du accepterer konsekvenserne, før du fortsætter.

Redeploy statisk indhold

Når du kun har ændret frontend-kode, så genudrul statisk indhold uafhængigt for en hurtigere iterationscyklus:

npx rayfin up staticapp deploy

Denne kommando kører din konfigurerede buildCommand, pakker outputtet og uploader det til fjernservicen.

For at springe build-trinnet over og deploye eksisterende output:

npx rayfin up staticapp deploy --skip-build

Tjek udrulningsstatus

Se den aktuelle tilstand af din Fabric-udsendelse:

npx rayfin up status

Tilføj --json for maskinlæsbart output:

npx rayfin up status --json

Opdater eksisterende udrulninger

Efter den første udrulning rayfin.yml gemmer den udrulningsdetaljerne (rayfinItemId, fabricWorkspaceId, og genstandens endepunkt). At køre npx rayfin up igen opdaterer den samme udrulning i stedet for at oprette en ny.

For målrettede opdateringer bruger du underkommandoerne:

Kommando Hvad opdaterer den
npx rayfin up Alt: indstillinger, database og statisk indhold.
npx rayfin up db apply Kun databaseskema.
npx rayfin up staticapp deploy Kun statisk indhold.

Fejlfinding af udrulningsproblemer

Udrulning fejler med 401- eller 403-fejl

Din session kan være udløbet. Kør npx rayfin login for at genautentificere, og prøv npx rayfin upså igen.

Databaseanvendelse rapporterer destruktive ændringer

Rayfin CLI blokerer skemaændringer, der kan forårsage datatab. Gennemgå de listede operationer og brug npx rayfin up db apply --force dem kun, efter du har bekræftet, at du accepterer datatabet.

Statisk udrulning overstiger størrelsesgrænsen

Det komprimerede arkiv må ikke overstige 100 MB. Optimer dit build-output ved at udelukke kildekort og store udviklingsassets, eller flyt binære filer til Fabric Apps-lager.

Administrer din app i Fabric-portalen

Efter udrulning kan du administrere din Fabric-app direkte i Fabric-portalen.

Se genstandsegenskaber

Åbn Fabric-appen i Fabric-portalen for at se:

  • App URL — Den offentlige URL, hvor dit statiske indhold hostes.
  • App backend URL — Basis-URL'en for alle backend-tjenester.

Administrere børnetjenester

Vælg Fabric-appen for at se dens børnetjenester:

  • SQL Database — Åbner den Fabric SQL-forespørgselseditor. Du kan køre læste forespørgsler mod dine data. Skemaændringer, der foretages direkte i Fabric-portalen, overskrives ved næste rayfin up deploy.
  • Autentificering — Se og administrer autentificerede brugere i Users-tabellen i den underordnede SQL-database.

Apptilladelser

For alle bidragydere til Fabric-appen skal de for at implementere en Fabric-app mindst Edit tilladelse til genstanden.

Relateret indhold

  • Last updated on