Vytvořte aplikaci Fabric pomocí Rayfin CLI

V tomto kurzu se dozvíte, jak pomocí Rozhraní příkazového řádku Rayfin vytvořit projekt, spustit ho místně a nasadit ho do Fabric. Stejný pracovní postup rozhraní příkazového řádku použijete pro nové aplikace a pro pozdější aktualizace schématu nebo front-endu.

V tomto kurzu se naučíte:

  • Vytvořte projekt Fabric Apps ze šablony.
  • Spusťte aplikaci místně.
  • Přihlaste se k Fabric z rozhraní příkazového řádku.
  • Nasaďte aplikaci do pracovního prostoru Fabric.
  • Ověřte stav nasazení.

Předpoklady

  • Přístup k Fabric
  • Pracovní prostor Fabric, kde máte oprávnění přispěvatele, člena nebo správce.
  • Pracovní zatížení Fabric Apps povolené ve vašem tenantovi.
  • Node.js a npm nainstalované.

Vytvořte aplikaci s AI promptem

Použijte následující prompt s GitHub Copilot nebo jiným programátorem k vytvoření, prozkoumání, spustení, přizpůsobení a nasazení aplikace Fabric:

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

Agent spustí příkazy interaktivně a požádá o požadovaná nastavení projektu nebo pracovního prostoru. Před nasazením zkontrolujte vygenerované soubory a výstupy příkazů. Pokud ještě není úloha Fabric Apps povolená, požádejte správce Fabric, aby povolil Fabric Apps (preview) v katalogu OneLake>Govern>Configurations>Workloads.

Vytvořte novou aplikaci z CLI

Pokud chcete vygenerovat novou aplikaci ze šablony, použijte npm create:

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

Tento příkaz vytvoří novou složku projektu se šablonou aplikace, rayfin konfigurací a zdrojovým kódem front-endu.

Přejděte do adresáře projektu:

cd my-app

Tip

Pokud již máte prázdnou složku projektu nebo existující zdrojový kód, použijte npx rayfin init místo npm create.

npx rayfin init .

Zkontrolujte generovaný projekt

Po vygenerování kostry projektu projekt obsahuje soubory, které potřebujete k zahájení vývoje:

  • rayfin/rayfin.yml ukládá aplikační služby a nastavení nasazení.
  • rayfin/.env ukládá hodnoty prostředí používané rozhraním příkazového řádku.
  • rayfin/data/ obsahuje soubory datového modelu.
  • Vaše front-endová aplikace se nachází ve struktuře kořenového projektu vytvořené vybranou šablonou.

Podrobný rozpis souborů po souborech najdete v tématu Vysvětlení struktury projektu.

Místní spuštění aplikace

Spusťte místní vývojové prostředí:

npx rayfin dev

Tento příkaz spustí frontendový vývojový server pro vygenerovanou aplikaci a nasadí backend do prostředí Fabric. Pokud chcete ověřit, že se aplikace spustí správně, otevřete místní adresu URL zobrazenou v terminálu.

Nasadit aplikaci na Fabric

Sestavte do své aplikace další funkce. Po otestování změn je znovu nasaďte do Fabric.

npx rayfin up

Pokud chcete zobrazit náhled nasazení bez provedení změn, spusťte:

npx rayfin up --dry-run

Ověření nasazení

Zkontrolujte aktuální stav nasazení:

npx rayfin up status

Pro strojově čitelnou odpověď použijte výstup JSON:

npx rayfin up status --json

Po úspěšném nasazení rozhraní příkazového řádku vytiskne adresu URL hostované aplikace a odkaz na portál Fabric pro nasazenou položku.

Nasazujte pouze databázový nebo statický obsah

Pokud jste změnili pouze datové modely, použijte změny databáze bez úplného opětovného nasazení:

npx rayfin up db apply

Pokud jste změnili pouze front-endový kód, znovu nasaďte statické prostředky:

npx rayfin up staticapp deploy

Přidat funkce

Funkce jsou TypeScript funkce, které běží na serveru uvnitř vaší Fabric aplikace. Používejte logické funkce, které nesmí běžet v prohlížeči, například práci se tajemstvími, přístup k privilegovaným datům a volání služeb v oblasti dolů jménem přihlášeného uživatele.

npx rayfin functions init

GitHub Copilot dokáže generovat a aktualizovat potřebné soubory a komponenty. Můžete také požádat agenta, aby aplikaci spustil, ladil funkce lokálně a aplikaci nasadil. Například můžete použít následující výzvu k vytvoření AI asistenta pro přezkoumání pull requestů pomocí funkcí:

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.

Řešení běžných potíží

Přihlášení selže nebo nasazení vrátí 401 nebo 403

Spusťte npx rayfin login znovu a opakujte akci npx rayfin up.

Musíte zkontrolovat, co bude rozhraní příkazového řádku dělat.

Před nasazením změn spusťte npx rayfin up --dry-runpříkaz .

Aplikace se nasadí, ale změníte pouze schéma.

Chcete-li změny schématu prosazovat nezávisle, použijte npx rayfin up db apply. Pokud provedete destruktivní změny, jako je změna typu sloupce nebo odebrání sloupce, tento příkaz selže. Pokud chcete vynutit změny, můžete použít --force příznak. Tato akce může být zásadní změnou.

Další kroky

  • Poslední aktualizace v