Vytvorte Fabric aplikáciu s Rayfin CLI

Tento tutoriál vám ukáže, ako použiť Rayfin CLI na vytvorenie projektu, jeho lokálne spustenie a nasadenie do Fabric. Rovnaký CLI workflow používate pre nové aplikácie a neskoršie aktualizácie schémy alebo frontendu.

V tomto kurze:

  • Vytvorte projekt Fabric Apps zo šablóny.
  • Spusti aplikáciu lokálne.
  • Prihláste sa do Fabric cez CLI.
  • Nainštalujte aplikáciu do pracovného priestoru Fabric.
  • Overte stav nasadenia.

Predpoklady

  • Prístup k Fabric.
  • Fabric pracovný priestor, kde máte oprávnenia prispievateľa, člena alebo administrátora.
  • Záťaž Fabric Apps je zapnutá vo vašom tenante.
  • Node.js a NPM nainštalované.

Vytvorte aplikáciu s AI promptom

Použite nasledujúci prompt s GitHub Copilot alebo iným kódovacím agentom na vytvorenie, preskúmanie, spustenie, prispôsobenie a nasadenie aplikácie Fabric:

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

Príkaz scaffold poskytuje názov projektu a šablónu pre neinteraktívne vykonávanie. Agent môže požiadať o zostávajúce nastavenia pracovného priestoru alebo nasadenia. Pred nasadením si skontrolujte vygenerované súbory a výstup príkazov.

Vytvoriť novú aplikáciu z CLI

Na vytvorenie novej aplikácie zo šablóny použite npm create:

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

Predvolená blankapp šablóna sa vyrieši na Universal App. Vytvára nový npm pracovný priestor s backend konfiguráciou v , rayfin/frontend kód v packages/frontend/, runtime dátové definície v , packages/data/a zdieľané kontrakty v packages/shared/. Dáta sú deaktivované, kým sa neprihlásite.

Prejdite do adresára projektov:

cd my-app

Tip

Ak už máte prázdny projektový priečinok alebo existujúci zdrojový kód, použite npx rayfin init namiesto .npm create

npx rayfin init .

Skontrolujte vygenerovaný projekt

Po scaffoldingu projekt obsahuje súbory, ktoré potrebujete začať vyvíjať:

  • rayfin/rayfin.yml Ukladajú aplikačné služby a nastavenia nasadenia.
  • rayfin/.env ukladá environmentálne hodnoty používané CLI.
  • packages/frontend/ obsahuje používateľské rozhranie a frontendovú verziu.
  • packages/data/ obsahuje runtime entity triedy a registráciu schémy.
  • packages/shared/ obsahuje zmluvy o záznamoch a schémach prístupných klientom.

Povolte zachované dáta aplikácie, keď je to potrebné:

npm run pack:add -- data-modeling

Táto schopnosť umožňuje Data a pridáva počiatočné dáta a zdieľané definície. Pred pridaním súborov skontrolujte a services.staticHosting.path prihláste services.data.path sarayfin/rayfin.yml. Iné šablóny môžu používať plochý koreň src/ a rayfin/data/ rozloženie; tieto rozloženia sú alternatívami, nie predvoleným rozložením Universal App.

CLI uchováva aktívne hodnoty nasadenia v a rayfin/.env zaznamenáva nasadenia v rayfin/.deployments.json. Verejné RAYFIN_PUBLIC_* hodnoty sú mapované do generovaného .env.localfrontendu ; používajú npx rayfin env --framework vite sa na jeho regeneráciu bez nasadenia.

Pre podrobný rozbor jednotlivých súborov pozri Pochopenie štruktúry projektu.

Lokálne spustenie aplikácie

Začnite prostredie miestneho rozvoja:

npx rayfin dev

Tento príkaz spustí frontendový vývojový server pre scaffolded aplikáciu a nasadí backend do Fabric. Aby ste si overili, že aplikácia správne štartuje, otvorte lokálnu URL adresu zobrazenú v termináli.

Nasadiť aplikáciu na Fabric

Zabudujte do svojej aplikácie viac funkcií. Po otestovaní zmien opäť nasad do Fabric.

npx rayfin up

Ak chcete zobraziť nasadenie bez zmien, spustite to:

npx rayfin up --dry-run

Overte nasadenie

Skontrolujte aktuálny stav nasadenia:

npx rayfin up status

Pre strojovo čitateľnú odpoveď použite výstup JSON:

npx rayfin up status --json

Po úspešnom nasadení CLI vytlačí URL hostovanej aplikácie a odkaz na Fabric portál pre nasadenú položku.

Nasadzujte iba databázový alebo statický obsah

Ak ste zmenili len dátové modely, aplikujte zmeny databázy bez úplného opätovného nasadenia:

npx rayfin up db apply

Ak ste zmenili len frontendový kód, znovu nasadte statické assety:

npx rayfin up staticapp deploy

Funkcie pridávania

Funkcie sú TypeScript funkcie, ktoré bežia na serveri vo vašej Fabric aplikácii. Používajte logické funkcie, ktoré nesmú bežať v prehliadači, ako je práca s tajomstvami, prístup k privilegovaným dátam a volanie externých služieb s identitou aplikácie.

npx rayfin functions init

Inicializátor pri konfigurácii detekuje services.functions.path polohu pracovného priestoru, napríklad packages/functions, alebo zachováva existujúci plochý rayfin/functions balík. Používajte --path <relative-path> konkrétny výber miesta.

Povolené funkcie vyžadujú services.functions.auth.type: application. Externé volania cez ctx.Tokens.* používajú identitu aplikácie a jej oprávnenia, nie externé oprávnenia používateľa na externé zdroje. V súčasných Fabric aplikáciách je tou identitou vlastník položky v aplikácii. Umožniť mu prístup ku každému zdroju. Naopak, používa ctx.getDataClient() Rayfin token volania a zachováva dátové politiky volajúceho.

GitHub Copilot dokáže generovať a aktualizovať potrebné súbory a komponenty. Môžete tiež požiadať agenta, aby spustil aplikáciu, lokálne ladil funkcie a aplikáciu nasadil. Napríklad môžete použiť nasledujúci prompt na vytvorenie AI asistenta na prehodnotenie pull requestov pomocou funkcií:

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().

Podrobnosti o identite a nasadení nájdete v sekciách Použiť funkcie a Pripojiť funkcie k externým zdrojom .

Riešenie bežných problémov

Prihlásenie zlyhá alebo nasadenie vráti 401 alebo 403

Spustite znova, potom to skúste npx rayfin loginnpx rayfin upznova.

Musíte skontrolovať, čo CLI urobí

Pred nasadením zmien spustite npx rayfin up --dry-run.

Aplikácia sa nasadí, ale zmeníte len schému

Na nezávislé presadzovanie zmien schémy použite npx rayfin up db apply. Ak vykonáte deštruktívne zmeny, ako je zmena typu stĺpca alebo odstránenie stĺpca, tento príkaz zlyhá. Na vynútenie zmien môžete použiť príznak.--force Tento krok môže byť zlomovou zmenou.

Ďalšie kroky

  • Naposledy aktualizované: