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 Microsoft 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 Microsoft Fabric von der CLI an.
  • Stellen Sie die App in einem Fabric Arbeitsbereich bereit.
  • Überprüfen Sie den Bereitstellungsstatus.

Voraussetzungen

  • Zugriff auf Microsoft 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.

Wenn die Fabric Apps-Workload noch nicht aktiviert ist, bitten Sie einen Fabric Administrator, Fabric Apps (Vorschau) im Fabric Admin-Portal zu aktivieren.

Schritt 1: Erstellen eines neuen Projekts

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 .

Schritt 2: Überprüfen des generierten Projekts

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".

Schritt 3: Lokales Ausführen der App

Starten Sie die lokale Entwicklungsumgebung:

npm run 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.

Schritt 4: Bereitstellen der App für 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

Schritt 5: Überprüfen der 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.

Schritt 6: Nur die 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

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