Nasaďte aplikaci Fabric do prostředí Fabric

Nasaďte Fabric aplikaci do Fabric přihlášením, spuštěním toku nasazení rozhraní příkazového řádku a kontrolou toho, co npx rayfin up pro vaši aplikaci konfiguruje. Tento článek vás provede konceptem toho, co se stane během nasazování.

Předpoklady

  • Projekt Fabric Apps s konfiguračním souborem rayfin/rayfin.yml. Pokud ještě projekt nemáte, přečtěte si článek Vytvoření prvního projektu Fabric Apps.
  • Účet Microsoft Entra ID s přístupem k pracovnímu prostoru Fabric.

Nasazení aplikace

V kořenovém adresáři projektu spusťte následující příkaz:

npx rayfin up

Pokud nejste přihlášení, rozhraní příkazového řádku automaticky spustí interaktivní tok přihlašování.

Co nasazení dělá

Příkaz rayfin up provede tyto kroky v pořadí:

  1. Vytvoří položku Fabric Aplikace ve vašem pracovním prostoru Fabric (nebo znovu použije existující položku při dalších nasazeních).
  2. Načte publikovatelný klíč ze vzdálené služby.
  3. Synchronizuje nastavení běhového prostředí z vaší rayfin.yml do vzdálené služby, včetně konfigurace autentizace a příznaků služby.
  4. Použije schéma databáze vygenerované z dekorátorů datového modelu TypeScript.
  5. Sestaví a nasadí statický obsah, pokud je v rayfin.yml povolená možnost staticHosting — spustí příkaz sestavení, zabalí výstupní složku do archivu ZIP a nahraje jej.
  6. Uloží podrobnosti o nasazení do souborů rayfin.yml a .env.fabric-* pro následná nasazení.

Po nasazení CLI vypíše:

  • Adresa URL pro hostování, kde je vaše aplikace aktivní
  • Odkaz na portál Fabric pro správu nasazení
  • Identifikátor nasazení pro referenční účely

Konfigurace ověřování

U nasazených aplikací je podporováno pouze ověřování zprostředkované službou Fabric (Entra SSO). Ověřování e-mailem a heslem je dostupné během místního vývoje, ale po nasazení do Fabric nefunguje.

Před spuštěním příkazu rayfin.yml se ujistěte, že váš rayfin up má povolené ověřování Fabric:

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

Nasazení ve verzi Preview bez změn

Pomocí --dry-run zjistíte, co by CLI udělalo, aniž by vytvořilo nebo upravilo jakékoli zdroje:

npx rayfin up --dry-run

Použití změn databáze

Po aktualizaci datových modelů odešlete změny schématu do vzdálené databáze bez opětovného nasazení celého zásobníku:

npx rayfin up db apply

Pokud změna schématu zahrnuje potenciálně destruktivní operace (vyřazení sloupců, přejmenování tabulek), rozhraní příkazového řádku vás upozorní a odmítne pokračovat. Použijte --force k obejití bezpečnostní kontroly:

npx rayfin up db apply --force

Caution

Použití --force může způsobit ztrátu dat. Projděte si uvedené operace pečlivě a před pokračováním potvrďte, že přijímáte důsledky.

Opětovné nasazení statického obsahu

Pokud jste změnili pouze front-endový kód, nasaďte statický obsah nezávisle na sobě pro rychlejší cyklus iterace:

npx rayfin up staticapp deploy

Tento příkaz spustí nakonfigurovaný buildCommandpříkaz , zabalí výstup a nahraje ho do vzdálené služby.

Pokud chcete přeskočit krok sestavení a nasadit existující výstup:

npx rayfin up staticapp deploy --skip-build

Kontrola stavu nasazení

Zobrazení aktuálního stavu nasazení Fabric:

npx rayfin up status

Přidání --json pro strojově čitelný výstup:

npx rayfin up status --json

Aktualizace existujících nasazení

Po prvním nasazení rayfin.yml uloží podrobnosti o nasazení (rayfinItemIdfabricWorkspaceIda koncový bod položky). Opětovné spuštění npx rayfin up aktualizuje stejné nasazení místo vytvoření nového.

U cílových aktualizací použijte dílčí příkazy:

Command Co aktualizuje
npx rayfin up Vše: nastavení, databáze a statický obsah.
npx rayfin up db apply Pouze schéma databáze.
npx rayfin up staticapp deploy Pouze statický obsah.

Řešení problémů při nasazování

Nasazení selže s chybou 401 nebo 403

Platnost relace možná vypršela. Spusťte npx rayfin login, abyste se znovu ověřili, a poté akci npx rayfin up opakujte.

Použití sestav s destruktivními změnami v databázi

Rayfin CLI blokuje změny schématu, které by mohly způsobit ztrátu dat. Zkontrolujte uvedené operace a npx rayfin up db apply --force použijte teprve poté, co potvrdíte, že souhlasíte se ztrátou dat.

Statické nasazení překračuje limit velikosti

Komprimovaný archiv nesmí překročit 100 MB. Optimalizujte výstup sestavení tak, že vyloučíte zdrojové mapy a velké vývojové prostředky nebo přesunete binární soubory do úložiště Fabric Apps.

Správa aplikace na portálu Fabric

Po nasazení můžete aplikaci Fabric spravovat přímo na portálu Fabric.

Zobrazení vlastností položky

Otevřete aplikaci Fabric na portálu Fabric a podívejte se na:

  • Adresa URL aplikace – veřejná adresa URL , kde je hostovaný statický obsah.
  • Adresa URL back-endu aplikace – základní adresa URL pro všechny back-endové služby.

Správa podřízených služeb

Vyberte aplikaci Fabric, aby se zobrazily její dceřiné služby:

  • SQL Database – Otevře editor dotazů Fabric SQL. Nad svými daty můžete spouštět dotazy pro čtení dat. Změny schématu provedené přímo na portálu Fabric budou při dalším nasazení rayfin up přepsány.
  • Ověřování – Umožňuje zobrazit a spravovat ověřené uživatele v tabulce Users v podřízené databázi SQL.

Oprávnění aplikací

Aby mohli všichni přispěvatelé aplikace Fabric nasadit Fabric aplikaci, potřebují k položce oprávnění minimálně Edit.

Související obsah

  • Last updated on