Luo Fabric-sovellus Rayfin CLI:llä

Tämä opetusohjelma näyttää, miten Rayfin CLI:tä käytetään projektin luomiseen, sen ajamiseen paikallisesti ja 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 Fabric-palveluun CLI:stä.
  • Ota sovellus käyttöön Fabric-työtilassa.
  • Varmista käyttöönoton tila.

Edellytykset

  • Access to Fabric.
  • 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.

Luo sovellus, jossa on tekoälykehote

Käytä seuraavaa kehotetta GitHub Copilot tai muun koodausagentin kanssa luodaksesi, tutkiaksesi, ajaaksesi, räätälöidäksesi ja ottaaksesi käyttöön Fabric-sovelluksen:

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

1. Run: npx -y @microsoft/create-rayfin@latest --project-name rayfin-app-ws --template blankapp
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

Scaffold-komento antaa projektin nimen ja mallipohjan ei-interaktiiviseen suoritukseen. Agentti voi kysyä jäljellä olevia työtila- tai käyttöönottoasetuksia. Tarkista generoidut tiedostot ja komentotulokset ennen käyttöönottoa.

Luo uusi sovellus CLI:stä

Uuden sovelluksen rakentamiseen mallipohjasta käytä npm create:

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

Oletuspohja blankapp ratkeaa Universal Appiksi. Se luo uuden NPM-työtilan, jossa on taustakonfiguraatio , rayfin/etupääkoodi , packages/frontend/ajonaikaiset datamäärittelyt , packages/data/ja jaetut sopimukset .packages/shared/ Data on poistettu käytöstä, kunnes hyväksyt sen.

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 .

Tarkastele luotua projektia

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.
  • packages/frontend/ sisältää käyttöliittymän ja frontend-rakenteen.
  • packages/data/ sisältää ajonaikaiset entiteettiluokat ja skeeman rekisteröinnin.
  • packages/shared/ sisältää asiakaskohtaisia tietue- ja skeemasopimuksia.

Ota käyttöön pysyvä sovellusdata tarvittaessa:

npm run pack:add -- data-modeling

Tämä ominaisuus mahdollistaa datan ja lisää aloitusdataa sekä jaettuja määritelmiä. Tarkista services.data.path ja services.staticHosting.path sisään rayfin/rayfin.yml ennen tiedostojen lisäämistä. Muut mallipohjat voivat käyttää litteää juurta src/ ja rayfin/data/ asettelua; nämä asettelut ovat vaihtoehtoja, eivät oletusasettelua Universal App -asettelu.

Komentokeskus pitää aktiiviset käyttöönoton arvot ja rayfin/.env kirjaa käyttöönotot .rayfin/.deployments.json Julkiset RAYFIN_PUBLIC_* arvot kartoitetaan frontendin generoituihin .env.local; käytetään npx rayfin env --framework vite niiden uudelleengenerointiin ilman käyttöönottoa.

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

Suorita sovellus paikallisesti

Aloita paikallinen kehitysympäristö:

npx rayfin 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.

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

Käyttöönoton tarkistaminen

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.

Ota käyttöön vain tietokanta tai 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

Lisää funktioita

Funktiot ovat TypeScript-funktioita, jotka toimivat palvelimella Fabric-sovelluksessasi. Käytä logiikan funktioita, jotka eivät saa toimia selaimessa, kuten salaisuuksien käsittelyä, etuoikeutettujen tietojen käyttöä ja ulkoisten palveluiden kutsumista sovelluksen identiteetillä.

npx rayfin functions init

Alustuslaite käyttää services.functions.path asetuksia, tunnistaa työtilan sijainnin kuten packages/functions, tai säilyttää olemassa olevan tasaisen rayfin/functions paketin. Valitsin --path <relative-path> sijainnin nimenomaan.

Käytössä olevat funktiot vaativat services.functions.auth.type: application. Ulkoiset puhelut ctx.Tokens.* käyttävät sovelluksen identiteettiä ja sen oikeuksia, eivät käyttäjän ulkoisten resurssien käyttöoikeuksia. Nykyisissä Fabric-sovelluksissa tuo identiteetti on sovelluksen esineen omistaja. Anna sille pääsy jokaiseen resurssiin. Sen sijaan käyttää ctx.getDataClient() kutsun Rayfin-tokenia ja säilyttää soittajan datakäytännöt.

GitHub Copilot voi tuottaa ja päivittää tarvittavat tiedostot ja komponentit. Voit myös pyytää agenttia ajamaan sovelluksen, debugaamaan funktioita paikallisesti ja ottamaan sovelluksen käyttöön. Esimerkiksi voit käyttää seuraavaa kehotetta rakentaaksesi tekoälyn pull request review assistantin funktioiden avulla:

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 application
authentication to connect to Azure AI Foundry and Azure DevOps. Grant the
app identity the required resource permissions, and preserve the caller's
Rayfin data policies when using ctx.getDataClient().

Katso Käytä funktioita ja yhdistä funktiot ulkoisiin resursseihin identiteetin ja käyttöönoton yksityiskohtia varten.

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

  • Viimeksi päivitetty