Fabric-alkalmazás létrehozása a Rayfin parancssori felületével

Ez az oktatóanyag bemutatja, hogyan hozhat létre egy projektet a Rayfin parancssori felületével, hogyan futtathatja helyileg, és hogyan helyezheti üzembe a Fabric. Ugyanazt a parancssori felületi munkafolyamatot használja az új alkalmazásokhoz és a séma vagy előtér későbbi frissítéséhez.

Ebben az útmutatóban Ön:

  • Fabric Apps-projekt létrehozása sablonból.
  • Indítsa el az alkalmazást helyileg.
  • Jelentkezzen be a Fabricbe a CLI-ből.
  • Helyezze üzembe az alkalmazást egy Fabric munkaterületen.
  • Ellenőrizze az üzembe helyezés állapotát.

Prerequisites

  • Hozzáférés a Fabric.
  • Egy Fabric munkaterület, ahol közreműködői, tagi vagy rendszergazdai engedélyekkel rendelkezik.
  • A bérlőben engedélyezett Fabric alkalmazások számítási feladatai.
  • Node.js és npm telepítve.

Hozzon létre egy alkalmazást AI prompttal

Használja az alábbi promptot a GitHub Copilot-szal vagy más kódoló ügynökkel egy Fabric alkalmazás létrehozásához, felfedezéséhez, futtatásához, testreszabásához és telepítéséhez:

Set up a new Fabric App project called "rayfin-app-ws".

1. Run: npm create @microsoft/rayfin@latest
2. Open the scaffolded project directory.
3. Explore the project structure and understand the Rayfin app framework.
4. Run: npm run dev
5. Make changes to the app based on my instructions.
6. When ready, deploy with: npx rayfin up

Az ügynök interaktívan futtatja a parancsokat, és kéri a szükséges projekt- vagy munkaterületi beállításokat. Nézze át a generált fájlokat és a parancs kimenetét a telepítés előtt. Ha a Fabric Apps számítási feladata még nincs engedélyezve, kérje meg a Fabric-rendszergazdát, hogy kapcsolja be a Fabric Apps (előzetes verzió) elemet a OneLake-katalógus>Irányítás>Konfigurációk> területen.

Új alkalmazás létrehozása a CLI-ből

Ha sablonból szeretne új alkalmazást létrehozni, használja a következőt npm create:

npm create @microsoft/rayfin@latest -- my-app --workspace <workspacename>

Ez a parancs létrehoz egy új projektmappát az alkalmazássablonnal, a rayfin konfigurációval és az előtérbeli forráskóddal.

Nyissa meg a projektkönyvtárat:

cd my-app

Jótanács

Ha már rendelkezik üres projektmappával vagy meglévő forráskóddal, használja npx rayfin init a helyett.npm create

npx rayfin init .

A generált projekt áttekintése

Az állványozás után a projekt tartalmazza a fejlesztés megkezdéséhez szükséges fájlokat:

  • rayfin/rayfin.yml tárolja az alkalmazásszolgáltatásokat és az üzembehelyezési beállításokat.
  • rayfin/.env a parancssori felület által használt környezeti értékeket tárolja.
  • rayfin/data/ tartalmazza az adatmodell fájljait.
  • Az előtérbeli alkalmazás a kiválasztott sablon által létrehozott gyökérprojekt-struktúrában él.

A fájlok fájlonkénti részletes lebontását a projektstruktúra ismertetése című témakörben találja.

Az alkalmazás helyi futtatása

Indítsa el a helyi fejlesztési környezetet:

npx rayfin dev

Ez a parancs elindítja a frontend fejlesztési kiszolgálóját a generált alkalmazáshoz, és üzembe helyezi a háttéralkalmazást a Fabricben. Az alkalmazás helyes indításának ellenőrzéséhez nyissa meg a terminálban látható helyi URL-címet.

Telepítsd az alkalmazást Fabric-be

További funkciók létrehozása az alkalmazásba. A módosítások tesztelése után telepítse újra a Fabric.

npx rayfin up

Ha módosítás nélkül szeretné megtekinteni az üzembe helyezést, futtassa a következőt:

npx rayfin up --dry-run

Az alkalmazás telepítésének ellenőrzése

Ellenőrizze az aktuális üzembehelyezési állapotot:

npx rayfin up status

Géppel olvasható válasz esetén használja a JSON-kimenetet:

npx rayfin up status --json

A sikeres üzembe helyezés után a parancssori felület kinyomtatja az üzembe helyezett elem üzemeltetett alkalmazás URL-címét és Fabric portál hivatkozását.

Csak adatbázis vagy statikus tartalom telepítése

Ha csak az adatmodelleket módosította, alkalmazza az adatbázis módosításait teljes újratelepítés nélkül:

npx rayfin up db apply

Ha csak az előtérbeli kódot módosította, helyezze újra üzembe a statikus objektumokat:

npx rayfin up staticapp deploy

Funkciók hozzáadása

A függvények olyan TypeScript függvények, amelyek a Fabric alkalmazáson belüli szerveren futnak. Használj olyan logikai funkciókat, amelyek nem futhatnak a böngészőben, például titkokkal való munkavégzést, jogosultságos adatok elérését és a bejelentkezett felhasználó nevében lefelé irányuló szolgáltatások hívását.

npx rayfin functions init

A GitHub Copilot képes generálni és frissíteni a szükséges fájlokat és komponenseket. Megkérheted az ügynököt is, hogy futtasson az alkalmazás, helyben debugozza a funkciókat, és telepítse az alkalmazást. Például a következő prompttal építhetsz AI pull request review assistant-t függvények segítségével:

Build an app that lets me view all pull requests for the repository
<repoURL>, chat with my Azure AI Foundry agent <agentName> to review
pull requests, and post review comments. Use functions with delegated
authentication to connect to Azure AI Foundry and Azure DevOps.

Gyakori problémák elhárítása

A bejelentkezés sikertelen, vagy az üzembe helyezés a 401-et vagy a 403-at adja vissza

Futtassa újra a(z) npx rayfin login elemet, majd próbálja meg újra a(z) npx rayfin up elemet.

Meg kell vizsgálnia, hogy a parancssori felület mit fog tenni

A módosítások üzembe helyezése előtt futtassa a következőt npx rayfin up --dry-run:

Az alkalmazás települ, de Ön csak a sémát módosítja

A sémamódosítások egymástól függetlenül történő leküldéséhez használja a következőt npx rayfin up db apply: . Ha olyan romboló módosításokat hajt végre, mint például egy oszlop típusának módosítása vagy egy oszlop eltávolítása, ez a parancs meghiúsul. A módosítások kényszerítéséhez használhatja a jelölőt --force . Ez a művelet kompatibilitástörő változás lehet.

Következő lépések

  • Last updated on