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

Aktivieren Fabric App in Mandantenadministratoreinstellungen

Ein Fabric-Mandantenadministrator muss die App-Workload von Fabric aktivieren, bevor Benutzer Rayfin-Elemente erstellen können. Wenn Sie kein Mandantenadministrator sind, wenden Sie sich an den Fabric Administrator Ihrer Organisation, um diesen Schritt abzuschließen.

  1. Melden Sie sich beim Fabric-Verwaltungsportal an.
  2. Navigieren Sie zu Mandanteneinstellungen.
  3. Schalten Sie unter Fabric Apps (Vorschau) die Einstellung auf Enabled um.
  4. Wählen Sie aus, ob sie für die gesamte Organisation oder bestimmte Sicherheitsgruppen aktiviert werden soll.
  5. Wählen Sie Anwenden.

Änderungen können einige Minuten dauern, bis sie verteilt werden. Nachdem die Einstellung aktiviert wurde, können Benutzer im zulässigen Bereich Fabric Apps in ihren Arbeitsbereichen erstellen.

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 Fabric in Ihrem Browser, und melden Sie sich mit Ihrem Microsoft-Konto an.

Auswählen eines Arbeitsbereichs

Wählen Sie nach der Anmeldung im linken Navigationsbereich einen Arbeitsbereich aus. Wenn Sie nicht über einen vorhandenen Arbeitsbereich verfügen, 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, und wählen Sie die Fabric-Kapazität aus.

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.

    Example

    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