Fabric-alkalmazás telepítése a Fabricbe

Helyezzen üzembe egy Fabric-alkalmazást a Fabricben úgy, hogy bejelentkezik, futtatja a CLI üzembehelyezési folyamatát, és áttekinti, hogy a npx rayfin up mit konfigurál az alkalmazáshoz. Ez a cikk bemutatja, mi történik a telepítés során.

Prerequisites

  • Fabric Apps-projekt egy rayfin/rayfin.yml konfigurációs fájllal. Ha még nincs projektje, tekintse meg A Fabric Apps-projekt létrehozása.
  • Egy Fabric munkaterülethez hozzáféréssel rendelkező Microsoft Entra ID fiók.

Az alkalmazás üzembe helyezése

Futtassa a következő parancsot a projekt gyökeréből:

npx rayfin up

Ha nincs bejelentkezve, a parancssori felület automatikusan elindít egy interaktív bejelentkezési folyamatot.

Az üzembe helyezés feladata

A rayfin up parancs a következő lépéseket hajtja végre a következő sorrendben:

  1. Létrehoz egy Fabric Apps-elemet a Fabric munkaterületen (vagy újra felhasználja a meglévőt a későbbi üzembe helyezések során).
  2. Lekéri a közzétehető kulcsot a távoli szolgáltatásból.
  3. Szinkronizálja a futtatókörnyezet beállításait a rayfin.yml távoli szolgáltatással, beleértve a hitelesítési konfigurációt és a szolgáltatásjelzőket.
  4. Alkalmazza a TypeScript-adatmodell-dekorátorokból létrehozott adatbázissémát.
  5. Létrehozza és telepíti a statikus tartalmat, ha a(z) staticHosting be van kapcsolva a(z) rayfin.yml helyen – futtatja a buildparancsot, ZIP-fájlba csomagolja a kimeneti mappát, majd feltölti azt.
  6. Az üzembe helyezés részleteit a rayfin.yml és .env.fabric-* fájlokba menti a későbbi üzembe helyezésekhez.

Az üzembe helyezés után a parancssori felület a következőt nyomtatja:

  • Az alkalmazás üzemeltetési URL-címe, ahol az alkalmazás él
  • Egy Fabric portálhivatkozás az üzembe helyezés kezeléséhez
  • A telepítési azonosító referenciaként

Hitelesítés konfigurálása

Az üzembe helyezett alkalmazásokban csak Fabric közvetítőalapú hitelesítés (Entra SSO) támogatott. Az e-mail- és jelszóhitelesítés a helyi fejlesztés során érhető el, de a Fabric való üzembe helyezés után nem működik.

A rayfin.yml futtatása előtt győződjön meg arról, hogy a rayfin up Fabric hitelesítése engedélyezve van:

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

Előzetes üzembe helyezés módosítások nélkül

A --dry-run használatával megnézheti, mit tenne a CLI erőforrások létrehozása vagy módosítása nélkül:

npx rayfin up --dry-run

Adatbázis-módosítások alkalmazása

Az adatmodellek frissítése után a sémamódosítások leküldése a távoli adatbázisba a teljes verem ismételt üzembe helyezése nélkül:

npx rayfin up db apply

Ha a séma módosítása potenciálisan romboló műveleteket (oszlopok elvetését, táblák átnevezését) von maga után, a parancssori felület figyelmezteti Önt, és nem hajlandó továbblépni. A biztonsági ellenőrzés felülbírálásához használja a(z) --force elemet:

npx rayfin up db apply --force

Caution

A használat --force adatvesztést okozhat. Tekintse át alaposan a felsorolt műveleteket, és győződjön meg arról, hogy elfogadja a következményeket a folytatás előtt.

Statikus tartalom ismételt üzembe helyezése

Ha csak az előtérbeli kódot módosította, a statikus tartalmakat egymástól függetlenül helyezze üzembe a gyorsabb iterációs ciklus érdekében:

npx rayfin up staticapp deploy

Ez a parancs futtatja a konfigurált buildCommand, a kimenetet csomagolja, és feltölti a távoli szolgáltatásba.

A buildelési lépés kihagyása és a meglévő kimenet üzembe helyezése:

npx rayfin up staticapp deploy --skip-build

Az üzembe helyezés állapotának ellenőrzése

Tekintse meg a Fabric üzembe helyezésének jelenlegi állapotát:

npx rayfin up status

Adja hozzá a(z) --json elemet a géppel olvasható kimenethez:

npx rayfin up status --json

Meglévő telepítések frissítése

Az első üzembe helyezés rayfin.yml után tárolja az üzembe helyezés részleteit (rayfinItemIdfabricWorkspaceIdés az elemvégpontot). A npx rayfin up újbóli futtatása ugyanazt a telepítést frissíti, ahelyett, hogy újat hozna létre.

A célzott frissítésekhez használja az alparancsokat:

Parancs A frissítési funkció
npx rayfin up Minden: beállítások, adatbázis és statikus tartalom.
npx rayfin up db apply Csak adatbázisséma.
npx rayfin up staticapp deploy Csak statikus tartalom.

Üzembe helyezési problémák elhárítása

Az üzembe helyezés 401- vagy 403-os hibával meghiúsul

Előfordulhat, hogy a munkamenet lejárt. Futtassa a npx rayfin login parancsot az újbóli hitelesítéshez, majd próbálja meg újra a npx rayfin up műveletet.

Az adatbázis-alkalmazási jelentés roncsoló módosításokat jelez

A Rayfin parancssori felület letiltja az adatvesztést okozó sémamódosításokat. Tekintse át a felsorolt műveleteket, és csak az adatvesztés elfogadásának megerősítése után használja npx rayfin up db apply --force .

A statikus üzembe helyezés meghaladja a méretkorlátot

A tömörített archívum nem haladhatja meg a 100 MB-ot. Optimalizálhatja a buildkimenetet a forrástérképek és a nagy fejlesztési objektumok kizárásával, vagy bináris fájlok áthelyezésével Fabric Apps-tárolóba.

Az alkalmazás kezelése a Fabric portálon

Az üzembe helyezés után a Fabric alkalmazást közvetlenül a Fabric portálon kezelheti.

Elemtulajdonságok megtekintése

Nyissa meg a Fabric alkalmazást a Fabric-portálon, hogy megtekinthesse a következőket:

  • Alkalmazás URL-címe – Az a nyilvános URL-cím, ahol a statikus tartalom található.
  • Alkalmazás háttérrendszerÉNEK URL-címe – Az összes háttérszolgáltatás alap URL-címe.

Gyermekszolgáltatások kezelése

Válassza ki a Fabric alkalmazást a gyermekszolgáltatások megtekintéséhez:

  • SQL Database – Megnyitja a Fabric SQL-lekérdezésszerkesztőt. Olvasási lekérdezéseket futtathat az adatokon. A közvetlenül a Fabric portálon végrehajtott sémamódosítások felülíródnak a következő rayfin up üzembe helyezéskor.
  • Hitelesítés – Hitelesített felhasználók megtekintése és kezelése a gyermek SQL Database Felhasználók táblájában.

Alkalmazásengedélyek

Az Fabric-alkalmazás bármely közreműködőjének egy Fabric alkalmazás üzembe helyezéséhez legalább Szerkesztési engedélyre van szükségük az elemhez.

Kapcsolódó tartalom

  • Last updated on