Erstellen Ihrer ersten Fabric-App

Fabric Apps helfen Ihnen, Back-End-Dienste schneller zu erstellen und zu versenden, indem Sie eine einsatzbereite Infrastruktur für Authentifizierung, Datenpersistenz und statisches Hosting bereitstellen. In dieser Schnellstartanleitung erfahren Sie, wie Sie Ihre erste App in Fabric erstellen.

Voraussetzungen

  • Ein Microsoft-Konto mit Zugriff auf die Fabric- oder Power BI Pro-Lizenz.
  • Ein Arbeitsbereich, in dem Sie Berechtigungen als Mitwirkender oder Administrator haben.
  • Neueste Node.js-Version

Von nichts zu einer laufenden App

Erstelle und führe eine Fabric-App mit vier Befehlen aus. Rayfin bereitet dein Backend auf Microsoft Fabric aus, und du betreibst dein Frontend lokal dagegen. Du betreibst das Backend nicht lokal.

npm create @microsoft/rayfin@latest my-app
cd my-app
npx rayfin up
npm run dev

Führen Sie npx rayfin up status aus, um die Backend-Bereitstellung zu bestätigen.

Lass einen Agenten die App erstellen

Kopiere die folgende Eingabeaufforderung in GitHub Copilot oder einen anderen Codierungsagenten, der Zugriff auf ein Terminal hat:

Set up a new Rayfin app for me, end to end.

Rayfin is a backend platform for TypeScript developers on Microsoft Fabric. Before writing
any code, read https://rayfin.ai/docs/reference/agent-rules.md. Every page on that site is
available as raw Markdown by appending .md to its URL.

Then do the work yourself rather than printing steps for me:
1. Scaffold a project with `npm create @microsoft/rayfin@latest my-app` and install dependencies.
2. Sign in with `npx rayfin login`.
3. Deploy with `npx rayfin up` and confirm it with `npx rayfin up status`.
4. Start the frontend with `npm run dev` and tell me the URL to open.

Überprüfen Sie die generierten Dateien und die Befehlsausgabe, bevor Sie die App ausrollen.

Erstellen Sie eine App aus dem Portal

Öffnen Sie das Portal für Ihre Lizenzoption und melden Sie sich an:

  • Für das Power BI Pro-Erlebnis öffnen Sie das Power BI-Portal mit einem Konto mit Power BI Pro-Lizenz.
  • Für eine kapazitätsgestützte App öffnen Sie das Fabric-Portal.

Auswählen eines Arbeitsbereichs

Wählen Sie einen Arbeitsbereich aus, in dem Sie Berechtigungen für Mitwirkende oder Administratoren haben. Verwenden Sie einen Pro-Arbeitsbereich für das Power BI Pro-Erlebnis oder einen Arbeitsbereich, der der Fabric-Kapazität zugewiesen ist, oder eine aktive Fabric-Testversion für eine kapazitätsgestützte App.

Wenn Sie keinen vorhandenen Arbeitsbereich haben, erstellen Sie einen:

  1. Wählen Sie "Arbeitsbereiche" in der linken Navigation aus.
  2. Klicken Sie auf Neuer Arbeitsbereich.
  3. Geben Sie einen Namen für den Arbeitsbereich ein.
  4. Wählen Sie den Workspace-Lizenzmodus für Ihre Bereitstellung aus: Pro für das Power BI Pro-Erlebnis oder die entsprechende Kapazitätsoption für eine kapazitätsgestützte App.

Die Pro-Option erfordert keine Zuweisung der Fabric-Kapazität. Überprüfen Sie die Power BI Pro-Limits, bevor Sie die App erstellen. Fahren Sie für beide Optionen mit den folgenden App-Erstellungsschritten fort.

Erstelle eine neue Fabric-App

  1. Wählen Sie in der Arbeitsbereichsansicht " Neues Element" aus.
  2. Suchen Sie in der Elementtypliste nach App , oder scrollen Sie, um sie zu finden.
  3. Wählen Sie das App-Element aus, um das Erstellungsdialogfeld zu öffnen.
  4. Geben Sie einen Namen für Ihre Fabric-App ein (z. B. my-rayfin-app).
  5. Wählen Sie "Erstellen" aus.

Öffnen, bearbeiten und bereiten Sie Ihre App bereit

Sie können lokal mit Rayfin CLI entwickeln.

  1. Öffnen Sie ein Terminal Ihrer Wahl.

  2. Verwenden Sie das im Portal angezeigte CLI-Befehlsskript, und führen Sie es in Ihrem Terminal aus, um die App lokal herunterzuladen.

    Beispiel

    npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
    
  3. Wechseln Sie zum Projektverzeichnis.

    cd <your project directory>
    
  4. Passen Sie Ihre App an, indem Sie den Code direkt oder mithilfe von GitHub Copilot bearbeiten.

  5. Testen Sie lokale Änderungen mit Ihrem Fabric-Back-End mit dem Befehl.

    npm run dev
    
  6. Veröffentlichen Sie Ihre Änderungen mit:

    npx rayfin up 
    

    Zum Bereitstellen in einem anderen Arbeitsbereich können Sie den --workspace Parameter angeben.

    npx rayfin up --workspace <workspacename>
    

    Um zwischen diesen beiden Arbeitsbereichen zu wechseln, führen Sie npx rayfin switch --workspace <workspace> aus.

Nächste Schritte