Wdróż aplikację Fabric w Fabric

Wdróż aplikację Fabric na platformie Fabric, logując się, uruchamiając proces wdrażania w interfejsie CLI i sprawdzając, co npx rayfin up konfiguruje dla Twojej aplikacji. W tym artykule przedstawiono koncepcję tego, co się dzieje podczas wdrażania.

Wymagania wstępne

  • Projekt Fabric Apps z plikiem konfiguracji rayfin/rayfin.yml. Jeśli nie masz jeszcze projektu, zobacz Tworzenie pierwszego projektu Fabric Apps.
  • Konto Microsoft Entra ID z dostępem do obszaru roboczego Fabric.

Wdrażanie aplikacji

Uruchom następujące polecenie z poziomu katalogu głównego projektu:

npx rayfin up

Jeśli nie jesteś zalogowany, CLI automatycznie uruchamia interaktywny proces logowania.

Co robi wdrożenie

Polecenie rayfin up wykonuje następujące kroki w następującej kolejności:

  1. Tworzy element Fabric Apps w obszarze roboczym Fabric (lub ponownie używa istniejącego elementu w kolejnych wdrożeniach).
  2. Pobiera klucz do opublikowania z usługi zdalnej.
  3. Synchronizuje ustawienia środowiska uruchomieniowego z rayfin.yml do usługi zdalnej, w tym konfigurację uwierzytelniania i flagi usługi.
  4. Zastosowuje schemat bazy danych wygenerowany na podstawie dekoratorów modelu danych TypeScript.
  5. Kompiluje i wdraża treści statyczne, jeśli staticHosting jest włączone w rayfin.yml — uruchamia polecenie kompilacji, pakuje folder wyjściowy do pliku ZIP i przesyła go.
  6. Zapisuje szczegóły wdrożenia w plikach rayfin.yml i .env.fabric-* przy kolejnych wdrożeniach.

Po wdrożeniu CLI wyświetla:

  • Adres URL hostingu, pod którym działa Aplikacja
  • Link do portalu Fabric do zarządzania wdrożeniem
  • Identyfikator wdrożenia do celów referencyjnych

Konfiguruj uwierzytelnianie

Tylko uwierzytelnianie Fabric pośredniczone przez brokera (Entra SSO) jest obsługiwane w aplikacjach wdrożonych. Uwierzytelnianie za pomocą poczty e-mail i hasła jest dostępne podczas programowania lokalnego, ale nie działa po wdrożeniu w Fabric.

Upewnij się, że rayfin.yml ma włączone uwierzytelnianie Fabric przed uruchomieniem rayfin up:

services:
  auth:
    enabled: true
    fabric:
      enabled: true

Wdrażanie w wersji zapoznawczej bez zmian

Użyj --dry-run, aby zobaczyć, co zrobiłby interfejs CLI bez tworzenia ani modyfikowania żadnych zasobów:

npx rayfin up --dry-run

Stosowanie zmian bazy danych

Po zaktualizowaniu modeli danych wdróż zmiany schematu do zdalnej bazy danych bez ponownego wdrażania całego stosu:

npx rayfin up db apply

Jeśli zmiana schematu obejmuje potencjalnie destrukcyjne operacje (porzucanie kolumn, zmienianie nazw tabel), interfejs wiersza polecenia ostrzega cię i odmawia kontynuowania. Użyj --force polecenia , aby zastąpić kontrolę bezpieczeństwa:

npx rayfin up db apply --force

Caution

Użycie --force może spowodować utratę danych. Dokładnie przejrzyj wymienione operacje i potwierdź, że akceptujesz konsekwencje przed kontynuowaniem.

Ponowne wdrażanie zawartości statycznej

Po zmianie kodu frontonu ponownie wdróż zawartość statyczną niezależnie, aby przyspieszyć cykl iteracji:

npx rayfin up staticapp deploy

To polecenie uruchamia skonfigurowane buildCommand, pakuje dane wyjściowe i przesyła je do usługi zdalnej.

Aby pominąć krok kompilacji i wdrożyć istniejące dane wyjściowe:

npx rayfin up staticapp deploy --skip-build

Sprawdzanie stanu wdrożenia

Wyświetl bieżący stan wdrożenia Fabric:

npx rayfin up status

Dodaj --json dla danych wyjściowych z możliwością odczytu maszyny:

npx rayfin up status --json

Aktualizowanie istniejących wdrożeń

Po pierwszym wdrożeniu rayfin.yml przechowuje szczegóły wdrożenia (rayfinItemId, fabricWorkspaceId i punkt końcowy elementu). Uruchomienie npx rayfin up ponownie aktualizuje to samo wdrożenie zamiast tworzyć nowe.

W przypadku aktualizacji docelowych użyj podpolecenia:

Polecenie Co aktualizuje
npx rayfin up Wszystko: ustawienia, baza danych i zawartość statyczna.
npx rayfin up db apply Tylko schemat bazy danych.
npx rayfin up staticapp deploy Tylko zawartość statyczna.

Rozwiązywanie problemów dotyczących wdrożenia

Wdrożenie kończy się niepowodzeniem z powodu błędu 401 lub 403

Twoja sesja mogła wygasnąć. Uruchom polecenie npx rayfin login , aby ponownie uwierzytelnić, a następnie ponów próbę npx rayfin up.

Zastosowanie bazy danych zgłasza destrukcyjne zmiany

Interfejs wiersza polecenia Rayfin blokuje zmiany schematu, które mogą spowodować utratę danych. Przejrzyj wymienione operacje i użyj npx rayfin up db apply --force dopiero po potwierdzeniu, że akceptujesz utratę danych.

Wdrożenie statyczne przekracza limit rozmiaru

Skompresowane archiwum nie może przekraczać 100 MB. Zoptymalizuj dane wyjściowe kompilacji, wykluczając mapy źródłowe i duże zasoby programistyczne, lub przenieś pliki binarne do magazynu Fabric Apps.

Zarządzanie aplikacją w portalu Fabric

Po wdrożeniu możesz zarządzać aplikacją Fabric bezpośrednio w portalu Fabric.

Wyświetlanie właściwości elementu

Otwórz aplikację Fabric w portalu Fabric, aby zobaczyć:

  • Adres URL aplikacji — publiczny adres URL, w którym hostowana jest zawartość statyczna.
  • Adres URL zaplecza aplikacji — podstawowy adres URL dla wszystkich usług zaplecza.

Zarządzaj usługami podrzędnymi

Wybierz aplikację Fabric, aby wyświetlić jej usługi podrzędne:

  • SQL Database — otwiera edytor zapytań Fabric SQL. Zapytania odczytu można uruchamiać względem danych. Zmiany schematu wprowadzone bezpośrednio w portalu Fabric są zastępowane podczas następnego wdrożenia rayfin up.
  • Uwierzytelnianie — wyświetlanie uwierzytelnionych użytkowników i zarządzanie nimi w tabeli Users w podrzędnej bazie danych SQL Database.

Uprawnienia aplikacji

Każdy współtwórca aplikacji Fabric, aby móc wdrożyć aplikację Fabric, potrzebuje co najmniej uprawnienia Edit do tego elementu.

Treści powiązane

  • Last updated on