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.

Ha a Fabric Alkalmazások számítási feladat még nincs engedélyezve, kérje meg egy Fabric rendszergazdát, hogy kapcsolja be a Fabric Alkalmazások (előzetes verzió) a Fabric felügyeleti portálon.

1. lépés: Új projekt létrehozása

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 .

2. lépés: A létrehozott 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.

3. lépés: Az alkalmazás helyi futtatása

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

npm run 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.

4. lépés: Az alkalmazás üzembe helyezése Fabric

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

5. lépés: Az üzembe helyezés 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.

6. lépés: Csak az adatbázis vagy a statikus tartalom üzembe helyezé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

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