Nasadenie aplikácie Fabric do Fabric

Nasadte Fabric aplikáciu na Fabric prihlásením, spustením CLI nasadzovacieho procesu a preštudovaním, čo npx rayfin up konfiguruje pre vašu aplikáciu. Tento článok prechádza konceptom toho, čo sa deje počas nasadenia.

Predpoklady

  • Projekt Fabric Apps s konfiguračným súborom rayfin/rayfin.yml. Ak ešte nemáte projekt, pozrite si Create your first Fabric Apps project.
  • Účet Microsoft Entra ID s prístupom k pracovnému priestoru Fabric.

Nasadte svoju aplikáciu

Spustite nasledujúci príkaz z koreňa vášho projektu:

npx rayfin up

Ak nie ste prihlásení, CLI automaticky spustí interaktívny proces prihlásenia.

Čo nasadenie robí

Príkaz rayfin up vykonáva tieto kroky v poradí:

  1. Vytvorí položku Fabric Apps vo vašom pracovnom priestore Fabric (alebo použije existujúcu položku pri ďalších nasadeniach).
  2. Získa publikovateľný kľúč zo vzdialenej služby.
  3. Synchronizuje nastavenia behu z vášho rayfin.yml do vzdialenej služby, vrátane konfigurácie autentifikácie a príznakov služby.
  4. Aplikuje databázovú schému generovanú vašimi dekorátormi dátových modelov TypeScript.
  5. Zostaví a nasadí statický obsah, ak staticHosting je povolený v rayfin.yml—spustí váš príkaz build, zabalí výstupný priečinok do ZIP súboru a nahra ho.
  6. Uchováva údaje o nasadení a rayfin.yml.env.fabric-* súbory pre ďalšie nasadenia.

Po nasadení CLI vytlačí:

  • Hostingová URL, kde je vaša aplikácia aktívna
  • Portálové prepojenie Fabric na správu nasadenia
  • ID nasadenia pre referenciu

Konfigurácia overovania

V nasadených aplikáciách je podporovaná iba Fabric sprostredkovaná autentifikácia (Entra SSO). Overenie e-mailom a heslom je dostupné počas lokálneho vývoja, ale po nasadení do Fabric už nefunguje.

Pred spustením rayfin up sa uistite, že váš Fabricrayfin.yml má zapnutú autentifikáciu:

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

Náhľadové nasadenie bez zmien

Použite na --dry-run sledovanie, čo by CLI robilo bez vytvárania alebo úpravy akýchkoľvek zdrojov:

npx rayfin up --dry-run

Aplikovať zmeny v databáze

Po aktualizácii dátových modelov vložte zmeny schémy do vzdialenej databázy bez opätovného nasadenia celého stacku:

npx rayfin up db apply

Ak zmena schémy zahŕňa potenciálne deštruktívne operácie (vynechávanie stĺpcov, premenovanie tabuliek), CLI vás varuje a odmieta pokračovať. Použitie --force na obídenie bezpečnostnej kontroly:

npx rayfin up db apply --force

Výstraha

Používanie --force môže spôsobiť stratu dát. Dôkladne si preštudujte uvedené operácie a potvrďte sa, že akceptujete dôsledky predtým, než budete pokračovať.

Znovu nasadiť statický obsah

Keď ste menili len frontendový kód, samostatne znovu nasadzujte statický obsah pre rýchlejší iteráciový cyklus:

npx rayfin up staticapp deploy

Tento príkaz spustí vašu konfiguráciu buildCommand, zabalí výstup a nahraje ho do vzdialenej služby.

Aby ste preskočili krok zostavenia a nasadili existujúci výstup:

npx rayfin up staticapp deploy --skip-build

Skontrolujte stav nasadenia

Pozrite si aktuálny stav vášho nasadenia Fabric:

npx rayfin up status

Pridajte pre --json strojovo čitateľný výstup:

npx rayfin up status --json

Aktualizujte existujúce nasadenia

Po prvom nasadení sa rayfin.yml ukladajú detaily nasadenia (rayfinItemId, fabricWorkspaceId, a koncový bod položky). Opätovné spustenie npx rayfin up obnoví rovnaké nasadenie namiesto vytvorenia nového.

Pre cielené aktualizácie použite podpríkazy:

Príkaz Čo aktualizuje
npx rayfin up Všetko: nastavenia, databázu a statický obsah.
npx rayfin up db apply Iba databázová schéma.
npx rayfin up staticapp deploy Len statický obsah.

Riešenie problémov s nasadením

Nasadenie zlyháva s chybou 401 alebo 403

Vaša relácia mohla vypršať. Spustite na opätovnú autentifikáciu, potom to skúste npx rayfin loginnpx rayfin upznova.

Databázové aplikácie hlásia deštruktívne zmeny

Rayfin CLI blokuje zmeny schémy, ktoré by mohli spôsobiť stratu dát. Skontrolujte uvedené operácie a používajte npx rayfin up db apply --force až po potvrdení, že stratu dát akceptujete.

Statické nasadenie prekračuje limit veľkosti

Komprimovaný archív nesmie presiahnuť 100 MB. Optimalizujte výstup zostavenia tým, že vylúčite zdrojové mapy a veľké vývojové assety, alebo presuňte binárne súbory do úložiska Fabric Apps.

Spravujte svoju aplikáciu v portáli Fabric

Po nasadení môžete spravovať svoju Fabric aplikáciu priamo v portáli Fabric.

Zobraziť vlastnosti predmetu

Otvorte aplikáciu Fabric v portáli Fabric a pozrite si:

  • URL aplikácie — Verejná URL, kde je váš statický obsah hostovaný.
  • Backend URL aplikácie — Základná URL pre všetky backendové služby.

Spravovať služby pre deti

Vyberte aplikáciu Fabric a pozrite si jej detské služby:

  • SQL Database — Otvára editor Fabric SQL dotazov. Môžeš spúšťať čítané dotazy na svojich dátach. Zmeny schémy vykonané priamo v Fabric portáli sa prepíšu pri ďalšom nasadení rayfin up.
  • Autentifikácia — Zobraziť a spravovať overených používateľov v tabuľke Používatelia v podriadenej SQL databáze.

Povolenia aplikácie

Pre všetkých prispievateľov Fabric aplikácie, aby mohli nasadiť Fabric aplikáciu, potrebujú minimálne povolenie Edit na položku.

Súvisiaci obsah

  • Last updated on