Distribuera en Fabric-app till Fabric

Distribuera en Fabric-app till Fabric genom att logga in, köra distributionsflödet i CLI:t och granska vad npx rayfin up konfigurerar för appen. Den här artikeln går igenom begreppet vad som händer under distributionen.

Förutsättningar

  • Ett Fabric Apps-projekt med en rayfin/rayfin.yml konfigurationsfil. Om du inte har ett projekt än kan du läsa Skapa ditt första Fabric Apps-projekt.
  • Ett Microsoft Entra ID konto med åtkomst till en Fabric arbetsyta.

Driftsätt din applikation

Kör följande kommando från projektroten:

npx rayfin up

Om du inte är inloggad startar CLI automatiskt ett interaktivt inloggningsflöde.

Vad distributionen innebär

Kommandot rayfin up utför följande steg i ordning:

  1. Skapar ett Fabric Apps-objekt i din Fabric-arbetsyta (eller återanvänder det befintliga på efterföljande distributioner).
  2. Hämtar den publiceringsbara nyckeln från fjärrtjänsten.
  3. Synkroniserar körningsinställningar från din rayfin.yml till fjärrtjänsten, inklusive autentiseringskonfiguration och tjänstflaggor.
  4. Tillämpar databasschemat som genererats från dina TypeScript-datamodelldekoratörer.
  5. Skapar och distribuerar statiskt innehåll om staticHosting är aktiverat i rayfin.yml – kör byggkommandot, paketerar utdatamappen i en ZIP-fil och laddar upp den.
  6. Bevarar distributionsinformation till rayfin.yml och .env.fabric-* filer för efterföljande distributioner.

Efter distributionen skriver CLI ut:

  • Värd-URL:en där din app är live
  • En Fabric portallänk för att hantera distributionen
  • Distributions-ID:t som referens

Konfigurera autentisering

Endast Fabric-förmedlad autentisering (Entra SSO) stöds för distribuerade program. E-post- och lösenordsautentisering är tillgängligt under lokal utveckling, men fungerar inte när du har distribuerat till Fabric.

Kontrollera att din rayfin.yml har Fabric autentisering aktiverad innan du kör rayfin up:

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

Förhandsgranska distribution utan ändringar

Använd --dry-run för att se vad CLI skulle göra utan att skapa eller ändra några resurser:

npx rayfin up --dry-run

Tillämpa databasändringar

När du har uppdaterat dina datamodeller skickar du schemaändringar till fjärrdatabasen utan att distribuera om hela stacken:

npx rayfin up db apply

Om schemaändringen innebär potentiellt destruktiva åtgärder (att släppa kolumner, byta namn på tabeller) varnar CLI dig och vägrar att fortsätta. Använd --force för att åsidosätta säkerhetskontrollen:

npx rayfin up db apply --force

Caution

Användning --force kan orsaka dataförlust. Granska åtgärderna i listan noggrant och bekräfta att du accepterar konsekvenserna innan du fortsätter.

Distribuera statiskt innehåll på nytt

När du bara har ändrat frontend-koden, driftsätt det statiska innehållet separat för en snabbare itereringscykel:

npx rayfin up staticapp deploy

Det här kommandot kör din konfigurerade buildCommand, paketerar resultatet och laddar upp det till fjärrtjänsten.

Så här hoppar du över byggsteget och distribuerar befintliga utdata:

npx rayfin up staticapp deploy --skip-build

Kontrollera distributionsstatus

Visa den aktuella statusen för din Fabric-driftsättning:

npx rayfin up status

Lägg till --json för maskinläsbara utdata:

npx rayfin up status --json

Uppdatera befintliga distributioner

Efter den första distributionen rayfin.yml lagrar du distributionsinformationen (rayfinItemId, fabricWorkspaceIdoch objektslutpunkten). Om du kör npx rayfin up igen uppdateras samma distribution i stället för att skapa en ny.

För riktade uppdateringar använder du underkommandona:

Command Vad den uppdaterar
npx rayfin up Allt: inställningar, databas och statiskt innehåll.
npx rayfin up db apply Endast databasschema.
npx rayfin up staticapp deploy Endast statiskt innehåll.

Felsök problem med distribution

Driftsättning misslyckas med felkod 401 eller 403

Sessionen kan ha upphört att gälla. Kör npx rayfin login för att autentisera igen och försök npx rayfin upsedan igen.

Databastillämpning rapporterar destruktiva ändringar

Rayfin CLI blockerar schemaändringar som kan orsaka dataförlust. Granska de angivna åtgärderna och använd npx rayfin up db apply --force endast när du har bekräftat att du accepterar dataförlusten.

Statisk distribution överskrider storleksgränsen

Det komprimerade arkivet får inte överstiga 100 MB. Optimera byggresultatet genom att exkludera källkartor och stora utvecklingstillgångar, eller flytta binära filer till Fabric Apps-lagring.

Hantera din app i Fabric-portalen

Efter distributionen kan du hantera din Fabric app direkt i Fabric-portalen.

Visa objektegenskaper

Öppna Fabric-appen i Fabric-portalen för att se:

  • App-URL – den offentliga URL:en där ditt statiska innehåll finns.
  • Appens serverdels-URL – bas-URL:en för alla serverdelstjänster.

Hantera undertjänster

Välj appen Fabric för att se dess underliggande tjänster:

  • SQL Database – öppnar Fabric SQL-frågeredigeraren. Du kan köra läsfrågor mot dina data. Schemaändringar som görs direkt i Fabric-portalen skrivs över vid nästa rayfin up distribution.
  • Autentisering – Visa och hantera autentiserade användare i tabellen Användare i den underordnade SQL Database.

Programbehörigheter

För alla medverkande i Fabric-appen gäller att de måste ha minst behörigheten Edit på objektet för att kunna distribuera en Fabric-app.

Relaterat innehåll

  • Last updated on