Erstellen einer Fabric-App mit der Rayfin CLI

In diesem Lernprogramm erfahren Sie, wie Sie mit der Rayfin CLI ein Projekt erstellen, lokal ausführen und in Fabric bereitstellen. Sie verwenden den gleichen CLI-Workflow für neue Apps und für spätere Aktualisierungen ihres Schemas oder Frontends.

In diesem Tutorial lernen Sie:

  • Erstellen Sie ein Fabric Apps-Projekt aus einer Vorlage.
  • Starten Sie die App lokal.
  • Melden Sie sich bei Fabric von der CLI an.
  • Stellen Sie die App in einem Fabric Arbeitsbereich bereit.
  • Überprüfen Sie den Bereitstellungsstatus.

Voraussetzungen

  • Zugriff auf Fabric.
  • Ein Fabric Arbeitsbereich, in dem Sie über Berechtigungen "Mitwirkender", "Mitglied" oder "Administrator" verfügen.
  • Die in Ihrem Mandanten aktivierte Fabric-App-Workload.
  • Node.js und npm installiert.

Erstellen Sie eine App mit einem KI-Prompt

Verwenden Sie die folgende Eingabeaufforderung mit GitHub Copilot oder einem anderen Coding-Agenten, um eine Fabric-App zu erstellen, zu erkunden, auszuführen, anzupassen und bereitzustellen:

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

Der Agent führt die Befehle interaktiv aus und fragt nach erforderlichen Projekt- oder Arbeitsbereichseinstellungen. Überprüfen Sie generierte Dateien und Befehlsausgaben vor der Bereitstellung. Wenn die Fabric Apps-Workload noch nicht aktiviert ist, bitten Sie einen Fabric-Administrator, Fabric Apps (Vorschau) im OneLake-Katalog>Govern>Configurations>Workloads zu aktivieren.

Erstellen Sie eine neue App über CLI

Um ein Gerüst für eine neue App aus einer Vorlage zu erstellen, verwenden Sie Folgendes npm create:

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

Mit diesem Befehl wird ein neuer Projektordner mit der App-Vorlage, der rayfin Konfiguration und dem Frontend-Quellcode erstellt.

Wechseln Sie zum Projektverzeichnis:

cd my-app

Tipp

Wenn Sie bereits über einen leeren Projektordner oder vorhandenen Quellcode verfügen, verwenden Sie npx rayfin init anstelle von npm create.

npx rayfin init .

Überprüfen Sie das generierte Projekt

Nach dem Erstellen des Gerüsts enthält das Projekt die Dateien, die Sie zum Entwickeln benötigen:

  • rayfin/rayfin.yml speichert App-Dienste und Bereitstellungseinstellungen.
  • rayfin/.env speichert Umgebungswerte, die von der CLI verwendet werden.
  • rayfin/data/ enthält Ihre Datenmodelldateien.
  • Ihre Frontend-App befindet sich in der Stammprojektstruktur, die von der ausgewählten Vorlage erstellt wurde.

Eine detaillierte Datei-nach-Datei-Aufschlüsselung finden Sie unter "Grundlegendes zur Projektstruktur".

Lokales Ausführen der App

Starten Sie die lokale Entwicklungsumgebung:

npx rayfin dev

Dieser Befehl startet den Frontend-Entwicklungsserver für die Gerüst-App und stellt das Back-End für Fabric bereit. Um zu bestätigen, dass die App ordnungsgemäß gestartet wird, öffnen Sie die lokale URL, die im Terminal angezeigt wird.

Deploye die App auf Fabric

Erstellen Sie weitere Features in Ihrer Anwendung. Nachdem Sie die Änderungen getestet haben, stellen Sie sie erneut in Fabric bereit.

npx rayfin up

Um eine Vorschau der Bereitstellung anzuzeigen, ohne Änderungen vorzunehmen, führen Sie Folgendes aus:

npx rayfin up --dry-run

Überprüfen Sie die Bereitstellung

Überprüfen Sie den aktuellen Bereitstellungsstatus:

npx rayfin up status

Verwenden Sie für eine maschinenlesbare Antwort DIE JSON-Ausgabe:

npx rayfin up status --json

Nach einer erfolgreichen Bereitstellung druckt die CLI die url der gehosteten App und den Fabric Portallink für das bereitgestellte Element.

Nur Datenbank- oder statische Inhalte bereitstellen

Wenn Sie nur Datenmodelle geändert haben, wenden Sie die Datenbankänderungen ohne vollständige erneute Bereitstellung an:

npx rayfin up db apply

Wenn Sie nur den Frontend-Code geändert haben, stellen Sie die statischen Ressourcen erneut bereit:

npx rayfin up staticapp deploy

Funktionen hinzufügen

Funktionen sind TypeScript-Funktionen, die auf dem Server innerhalb Ihrer Fabric-App laufen. Verwenden Sie Funktionen für Logik, die im Browser nicht ausgeführt werden dürfen, wie das Arbeiten mit Geheimnissen, den Zugriff auf privilegierte Daten und das Aufrufen von nachgelagerten Diensten im Namen des angemeldeten Benutzers.

npx rayfin functions init

GitHub Copilot kann die erforderlichen Dateien und Komponenten generieren und aktualisieren. Du kannst den Agenten auch bitten, die App auszuführen, die Funktionen lokal zu debuggen und die App zu deployen. Zum Beispiel können Sie die folgende Eingabeaufforderung verwenden, um mithilfe von Funktionen einen KI-Pull-Request-Review-Assistenten zu erstellen:

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.

Häufige Probleme beheben

Die Anmeldung schlägt fehl, oder die Bereitstellung gibt 401 oder 403 zurück.

Führen Sie npx rayfin login den Vorgang erneut aus, und versuchen Sie es npx rayfin updann erneut.

Sie müssen prüfen, was die CLI tun wird

Führen Sie npx rayfin up --dry-run vor der Bereitstellung von Änderungen aus.

Die App wird bereitgestellt, aber Sie ändern nur das Schema

Verwenden Sie npx rayfin up db apply, um Schemaänderungen unabhängig zu übernehmen. Wenn Sie destruktive Änderungen wie das Ändern des Typs einer Spalte oder das Entfernen einer Spalte ausführen, schlägt dieser Befehl fehl. Um Ihre Änderungen zu erzwingen, können Sie die --force Kennzeichnung verwenden. Diese Aktion kann eine bahnbrechende Änderung sein.

Nächste Schritte

  • Last updated on