Luo Fabric-sovellus Rayfin CLI:llä

Tämä opas näyttää, miten Rayfin CLI:tä käytetään projektin luomiseen, sen ajamiseen paikallisesti ja Microsoft Fabric -käyttöön. Käytät samaa CLI-työnkulkua uusissa sovelluksissa ja myöhemmissä päivityksissä skeemallesi tai käyttöliittymällesi.

Tässä opetusohjelmassa:

  • Luo Fabric Apps -projekti pohjasta.
  • Käynnistä sovellus paikallisesti.
  • Kirjaudu Microsoft Fabric -palveluun komentorivistöstä.
  • Ota sovellus käyttöön Fabric-työtilassa.
  • Varmista käyttöönoton tila.

Edellytykset

  • Pääsy Microsoft Fabric -palveluun.
  • Fabric-työtila, jossa sinulla on Contributor-, Member- tai Admin-oikeudet.
  • Fabric Apps -työkuorma on käytössä vuokralaisessasi.
  • Node.js ja NPM asennettuna.

Jos Fabric Appsin työkuorma ei ole vielä käytössä, pyydä Fabric-ylläpitäjää ottamaan käyttöön Fabric Apps (preview) Fabric admin-portaalissa.

Vaihe 1: Uuden projektin luominen

Uuden sovelluksen rakentamiseen mallipohjasta käytä npm create:

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

Tämä komento luo uuden projektikansion, jossa on sovelluspohja, rayfin konfiguraatio ja frontend-lähdekoodi.

Mene projektihakemistoon:

cd my-app

Vinkki

Jos sinulla on jo tyhjä projektikansio tai olemassa oleva lähdekoodi, käytä npx rayfin init sen sijaan npm create.

npx rayfin init .

Vaihe 2: Käy läpi luotu projekti

Tukirakenteen jälkeen projekti sisältää tiedostot, jotka sinun täytyy aloittaa kehittämisen:

  • rayfin/rayfin.yml Tallentaa sovelluspalvelut ja käyttöönoton asetukset.
  • rayfin/.env tallentaa CLI:n käyttämät ympäristöarvot.
  • rayfin/data/ sisältää tietomallitiedostosi.
  • Frontend-sovelluksesi sijaitsee valitun mallipohjan luomassa juuriprojektirakenteessa.

Yksityiskohtaisen tiedostokohtaisen erittelyn löydät kohdasta Ymmärrä projektin rakenne.

Vaihe 3: Aja sovellus paikallisesti

Aloita paikallinen kehitysympäristö:

npm run dev

Tämä komento käynnistää tukipohjaisen sovelluksen frontend-kehityspalvelimen ja ottaa backendin käyttöön Fabric-ohjelmaan. Varmistaaksesi, että sovellus käynnistyy oikein, avaa paikallinen URL, joka näkyy päätelaitteessa.

Vaihe 4: Ota sovellus käyttöön Fabric-palveluun

Lisää sovellukseesi lisää ominaisuuksia. Kun olet testannut muutokset, ota Fabric käyttöön uudelleen.

npx rayfin up

Jos haluat esikatsella käyttöönottoa ilman muutoksia, suorita:

npx rayfin up --dry-run

Vaihe 5: Varmista käyttöönotto

Tarkista nykyinen käyttöönottotila:

npx rayfin up status

Koneellisesti luettavaa vastausta varten käytä JSON-tulostetta:

npx rayfin up status --json

Onnistuneen käyttöönoton jälkeen CLI tulostaa isännöidyn sovelluksen URL-osoitteen ja Fabric-portaalilinkin käyttöönotetulle kohteelle.

Vaihe 6: Deloy-tietokanta tai vain staattinen sisältö

Jos muutit vain tietomalleja, sovella tietokannan muutokset ilman täyttä uudelleenkäyttöönottoa:

npx rayfin up db apply

Jos vaihdoit vain frontend-koodia, ota staattiset assetit uudelleen käyttöön:

npx rayfin up staticapp deploy

Yleisten ongelmien vianmääritys

Kirjautuminen epäonnistuu tai käyttöönotto palauttaa 401 tai 403

Käynnistä npx rayfin login uudelleen, sitten yritä npx rayfin upuudelleen.

Sinun täytyy tarkistaa, mitä CLI tekee

Ennen muutosten käyttöönottoa suorita npx rayfin up --dry-run.

Sovellus otetaan käyttöön, mutta muutat vain skeemaa

Skeeman muutosten itsenäiseen työntämiseen käytä npx rayfin up db apply. Jos teet tuhoisia muutoksia, kuten sarakkeen tyypin muuttamista tai sarakkeen poistamista, tämä komento epäonnistuu. Voit pakottaa muutokset käyttämällä lippua --force . Tämä teko voi olla murtava muutos.

Seuraavat vaiheet

  • Last updated on