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 Microsoft 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 usługi Microsoft Fabric za pomocą interfejsu wiersza polecenia.
  • Wdróż aplikację w obszarze roboczym Fabric.
  • Sprawdź stan wdrożenia.

Wymagania wstępne

  • Dostęp do Microsoft 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.

Jeśli obciążenie Fabric Apps nie jest jeszcze włączone, poproś administratora Fabric o włączenie Fabric Apps (wersja zapoznawcza) w portalu administracyjnym Fabric.

Krok 1. Tworzenie nowego projektu

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 .

Krok 2. Przeglądanie wygenerowanego projektu

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.

Krok 3. Uruchamianie aplikacji lokalnie

Uruchom lokalne środowisko programistyczne:

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

Krok 4. Wdrażanie aplikacji w 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

Krok 5. 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.

Krok 6: Wdróż bazę danych lub tylko zawartość statyczną

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

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

  • Last updated on