Een Fabric-app maken met de Rayfin CLI

In deze zelfstudie leert u hoe u de Rayfin CLI gebruikt om een project te maken, het lokaal uit te voeren en te implementeren in Fabric. U gebruikt dezelfde CLI-werkstroom voor nieuwe apps en voor latere updates van uw schema of front-end.

In deze handleiding leert u:

  • Een Fabric Apps-project maken op basis van een sjabloon.
  • Start de app lokaal op.
  • Meld u aan bij Fabric vanuit de CLI.
  • Implementeer de app in een Fabric werkruimte.
  • Controleer de implementatiestatus.

Prerequisites

  • Toegang tot Fabric.
  • Een Fabric werkruimte met inzender-, lid- of beheerdersmachtigingen.
  • De workload Fabric Apps ingeschakeld in uw tenant.
  • Node.js en npm geïnstalleerd.

Maak een app met een AI-prompt

Gebruik de volgende prompt met GitHub Copilot of een andere coding agent om een Fabric-app te maken, verkennen, draaien, aanpassen en uitrolen:

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

De agent voert de commando's interactief uit en vraagt om eventuele benodigde project- of werkruimte-instellingen. Bekijk gegenereerde bestanden en commando-uitvoer vóór de uitrol. Als de Fabric Apps-workload nog niet is ingeschakeld, vraag dan een Fabric-beheerder om Fabric Apps (preview) in OneLake catalogus>Govern>Configurations>Workloads in te schakelen.

Maak een nieuwe app aan vanuit CLI

Als u een nieuwe app wilt maken op basis van een sjabloon, gebruikt u npm create:

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

Met deze opdracht maakt u een nieuwe projectmap met de app-sjabloon, de rayfin configuratie en de front-endbroncode.

Ga naar de projectmap:

cd my-app

Tip

Als u al een lege projectmap of bestaande broncode hebt, gebruikt npx rayfin init u in plaats van npm create.

npx rayfin init .

Bekijk het gegenereerde project

Na het genereren van de basisstructuur bevat het project de bestanden die je nodig hebt om te starten met ontwikkelen:

  • rayfin/rayfin.yml slaat app-services en implementatie-instellingen op.
  • rayfin/.env slaat omgevingswaarden op die worden gebruikt door de CLI.
  • rayfin/data/ bevat uw gegevensmodelbestanden.
  • Uw front-end-app bevindt zich in de hoofdprojectstructuur die is gemaakt door de geselecteerde sjabloon.

Zie De projectstructuur begrijpen voor een gedetailleerde uitsplitsing van bestanden per bestand.

De app lokaal uitvoeren

Start de lokale ontwikkelomgeving:

npx rayfin dev

Met deze opdracht start u de front-endontwikkelingsserver voor de scaffolded-app en implementeert u de back-end in Fabric. Als u wilt controleren of de app correct wordt gestart, opent u de lokale URL die wordt weergegeven in de terminal.

Implementeer de app in Fabric

Bouw meer functies in uw toepassing. Nadat u de wijzigingen hebt getest, implementeert u deze opnieuw in Fabric.

npx rayfin up

Als u een voorbeeld van de implementatie wilt bekijken zonder wijzigingen aan te brengen, voert u het volgende uit:

npx rayfin up --dry-run

De implementatie controleren

Controleer de huidige implementatiestatus:

npx rayfin up status

Gebruik JSON-uitvoer voor een machineleesbaar antwoord:

npx rayfin up status --json

Na een geslaagde implementatie drukt de CLI de gehoste app-URL en de Fabric portalkoppeling voor het geïmplementeerde item af.

Alleen database- of statische inhoud uitrollen

Als u alleen gegevensmodellen hebt gewijzigd, past u de databasewijzigingen toe zonder dat u de database volledig opnieuw hoeft te implementeren:

npx rayfin up db apply

Als u alleen front-endcode hebt gewijzigd, implementeert u de statische assets opnieuw:

npx rayfin up staticapp deploy

Functies toevoegen

Functies zijn TypeScript-functies die op de server binnen je Fabric-app draaien. Gebruik functies voor logica die niet in de browser mogen draaien, zoals werken met geheimen, toegang krijgen tot bevoorrechte gegevens en het aanroepen van downstream-diensten namens de ingelogde gebruiker.

npx rayfin functions init

GitHub Copilot kan de benodigde bestanden en componenten genereren en bijwerken. Je kunt de agent ook vragen de app te draaien, lokale functies te debuggen en de app te deployen. Je kunt bijvoorbeeld de volgende prompt gebruiken om een AI-pull request review assistant te bouwen met behulp van functies:

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.

Veelvoorkomende problemen oplossen

Inloggen mislukt of uitrol resulteert in fout 401 of 403

Voer het opnieuw uit npx rayfin login en probeer npx rayfin uphet opnieuw.

U moet controleren wat de CLI gaat doen

Voordat u wijzigingen implementeert, voert u de opdracht uit npx rayfin up --dry-run.

De app wordt geïmplementeerd, maar u wijzigt alleen het schema

Als u schemawijzigingen onafhankelijk wilt pushen, gebruikt u npx rayfin up db apply. Als u destructieve wijzigingen uitvoert, zoals het wijzigen van het type kolom of het verwijderen van een kolom, mislukt deze opdracht. Als u uw wijzigingen wilt afdwingen, kunt u de --force vlag gebruiken. Deze actie kan een belangrijke wijziging zijn.

Volgende stappen 

  • Laatst bijgewerkt om