Tworzenie aplikacji Fabric za pomocą interfejsu wiersza polecenia Rayfin

W tym samouczku pokazano, jak za pomocą interfejsu wiersza polecenia Rayfin utworzyć projekt, uruchomić go lokalnie i wdrożyć go w Fabric. Używasz tego samego przepływu pracy CLI w przypadku nowych aplikacji oraz późniejszych aktualizacji schematu lub frontendu.

W tym samouczku nauczysz się następujących rzeczy:

  • Utwórz projekt Fabric Apps na podstawie szablonu.
  • Uruchom aplikację lokalnie.
  • Zaloguj się do Fabric z poziomu interfejsu wiersza polecenia.
  • Wdróż aplikację w obszarze roboczym Fabric.
  • Sprawdź stan wdrożenia.

Wymagania wstępne

  • Dostęp do usługi Fabric.
  • Obszar roboczy Fabric, w którym masz uprawnienia Współautor, Członek lub Administrator.
  • Funkcja Fabric Apps włączona w Twojej dzierżawie.
  • zainstalowane Node.js i narzędzie npm.

Stwórz aplikację z promptem AI

Użyj poniższego promptu z GitHub Copilot lub innym agentem programistycznym, aby stworzyć, eksplorować, uruchomić, dostosować i wdrożyć aplikację Fabric:

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

Agent uruchamia polecenia interaktywnie i prosi o wymagane ustawienia projektu lub przestrzeni roboczej. Przejrzyj wygenerowane pliki i wynik poleceń przed wdrożeniem. Jeśli obciążenie Fabric Apps nie jest jeszcze włączone, poproś administratora Fabric o włączenie Fabric Apps (podgląd) w katalogu OneLake>Govern>Configurations>Workloads.

Utwórz nową aplikację z CLI

Aby utworzyć szkielet nowej aplikacji z szablonu, użyj polecenia npm create:

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

To polecenie tworzy nowy folder projektu z szablonem aplikacji, rayfin konfiguracją i kodem źródłowym frontonu.

Przejdź do katalogu projektu:

cd my-app

Wskazówka

Jeśli masz już pusty folder projektu lub istniejący kod źródłowy, użyj polecenia npx rayfin init zamiast npm create.

npx rayfin init .

Przejrzyj wygenerowany projekt

Po utworzeniu szkieletu projekt zawiera pliki potrzebne do rozpoczęcia tworzenia:

  • rayfin/rayfin.yml przechowuje usługi aplikacji i ustawienia wdrażania.
  • rayfin/.env przechowuje wartości środowiska używane przez interfejs wiersza polecenia.
  • rayfin/data/ zawiera pliki modelu danych.
  • Aplikacja frontonu znajduje się w głównej strukturze projektu utworzonej przez wybrany szablon.

Aby uzyskać szczegółowy podział plików po plikach, zobacz Omówienie struktury projektu.

Uruchamianie aplikacji lokalnie

Uruchom lokalne środowisko programistyczne:

npx rayfin dev

To polecenie uruchamia serwer deweloperski frontendu dla wygenerowanej aplikacji i wdraża backend na platformę Fabric. Aby potwierdzić, że aplikacja jest uruchamiana poprawnie, otwórz lokalny adres URL wyświetlany w terminalu.

Wdrożenie aplikacji na Fabric

Tworzenie większej liczby funkcji w aplikacji. Po przetestowaniu zmian ponownie wdróż je w Fabric.

npx rayfin up

Aby wyświetlić podgląd wdrożenia bez wprowadzania zmian, uruchom polecenie:

npx rayfin up --dry-run

Weryfikowanie wdrożenia

Sprawdź bieżący stan wdrożenia:

npx rayfin up status

W przypadku odpowiedzi z możliwością odczytu maszynowego użyj danych wyjściowych JSON:

npx rayfin up status --json

Po pomyślnym wdrożeniu interfejs wiersza polecenia wyświetli adres URL hostowanej aplikacji i link do portalu Fabric dla wdrożonego elementu.

Wdrażaj tylko bazy danych lub treści statyczne

Jeśli zmieniono tylko modele danych, zastosuj zmiany bazy danych bez pełnego ponownego wdrożenia:

npx rayfin up db apply

Jeśli zmieniono tylko kod frontonu, ponownie wdróż zasoby statyczne:

npx rayfin up staticapp deploy

Dodaj funkcje

Funkcje to funkcje TypeScript, które działają na serwerze w Twojej aplikacji Fabric. Używaj funkcji logicznych, które nie mogą działać w przeglądarce, takich jak praca z sekretami, dostęp do danych uprzywilejowanych oraz wywoływanie usług w imieniu zalogowanego użytkownika.

npx rayfin functions init

GitHub Copilot może generować i aktualizować wymagane pliki oraz komponenty. Możesz też poprosić agenta o uruchomienie aplikacji, debugowanie funkcji lokalnie i wdrożenie aplikacji. Na przykład możesz użyć następującego polecenia, aby utworzyć asystenta AI do przeglądu pull requestów, wykorzystując funkcje:

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.

Rozwiązywanie typowych problemów

Logowanie kończy się niepowodzeniem lub wdrożenie zwraca błąd 401 lub 403

Uruchom ponownie npx rayfin login, a następnie spróbuj ponownie npx rayfin up.

Musisz sprawdzić, co zrobi CLI.

Przed wdrożeniem zmian uruchom polecenie npx rayfin up --dry-run.

Aplikacja jest wdrażana, ale zmienia się tylko schemat

Aby niezależnie wdrożyć zmiany w schemacie, użyj polecenia npx rayfin up db apply. Jeśli wykonujesz destrukcyjne zmiany, takie jak zmiana typu kolumny lub usunięcie kolumny, to polecenie zakończy się niepowodzeniem. Aby wymusić zmiany, możesz użyć flagi --force . Ta akcja może być zmianą powodującą niezgodność.

Następne kroki

  • Ostatnia aktualizacja o