Udostępnij przez

Manifest obciążenia w zestawie narzędzi do rozszerzeń

Manifest obciążenia (WorkloadManifest.xml) to konfiguracja na poziomie obciążenia. Informuje ona Fabric, czym jest obciążenie i jak dotrzeć do interfejsu użytkownika, aby host mógł bezpiecznie go zainicjować. Uzupełnia, ale nie zastępuje definicji produktu i elementu:

  • Metadane produktu (na potrzeby odnajdywania i publikowania) są przechowywane w Product.json.
  • Typy elementów i ich zachowania działają w manifestach elementów i plikach JSON.

Co definiuje manifest obciążenia

  • Tożsamość obciążenia: WorkloadName ([Organizacja].[ WorkloadId]) i Version (wersja semantyczna)
  • Model hostingu: HostingType (użyj )FERemote
  • Aplikacja front-end Microsoft Entra: AADFEApp>AppId
  • Punkty końcowe front-endu: ServiceEndpoint wpisy z Name (na przykład Frontend), Url (localhost w środowisku deweloperskim; domena produkcyjna musi być subdomeną zweryfikowanej domeny Entra) i IsEndpointResolutionService. Zobacz Ogólne wymagania dotyczące publikowania dla ograniczeń domeny.
  • Opcjonalne złagodzenie piaskownicy: EnableSandboxRelaxation tylko wtedy, gdy wymagane są specjalne możliwości elementu iFrame (na przykład inicjowanie pobierania plików)

Najlepsze rozwiązania

  • Zachowaj spójność wersji w aplikacji i manifeście
  • Deklarowanie wymaganych minimalnych uprawnień (zasada najniższych uprawnień)
  • Weryfikowanie manifestu w ramach ciągłej integracji

Struktura

Kluczowe elementy manifestu i ich znaczenie:

  • Element główny z wersją schematu (na przykład SchemaVersion="2.0.0").
  • Workload węzeł z atrybutami, takimi jak:
    • WorkloadName — unikatowy identyfikator w formularzu [Organization].[WorkloadId] (na przykład Org.MyWorkload). Jeśli nie zamierzasz publikować w innych dzierżawach, możesz użyć elementu Org.[WorkloadId]. Aby publikować w różnych dzierżawach, zarejestruj pełną nazwę obciążenia w usłudze Fabric.
    • HostingType — wskazuje hosting pracy; użyj FERemote.
  • Version node — semantyczna wersja pakietu zadania.
  • RemoteServiceConfiguration > CloudServiceConfiguration Zawierające:
    • Cloud (na przykład Public).
    • AADFEApp > AppId — zawiera identyfikator aplikacji Microsoft Entra warstwy przedniej.
    • EnableSandboxRelaxation — ustaw go na true, jeśli potrzebujesz specjalnych funkcji iFrame (na przykład inicjowania pobierania plików). Zachowaj false domyślnie ze względów bezpieczeństwa.
    • Endpoints > ServiceEndpoint wpisy z:
      • Name (na przykład Frontend).
      • Url — gdzie fronton jest hostowany. Użyj https://localhost:port do rozwoju. W środowisku produkcyjnym domena musi być poddomeną zweryfikowanej domeny Entra. Zobacz Ogólne wymagania dotyczące publikowania , aby uzyskać pełne ograniczenia domeny.
      • IsEndpointResolutionService.

Kompilowanie danych wyjściowych i symboli zastępczych

W Starter-Kit automatycznie wypełnia miejsca zastępcze za każdym razem, gdy manifest jest tworzony na podstawie konfiguracji w pliku środowiska. Ostateczny sfinalizowany manifest jest tworzony w katalogu build/Manifest. Używanie symboli zastępczych i wypełnianie ich ze środowisk umożliwia tworzenie różnych środowisk bez zmieniania plików lub skryptów. Dane wyjściowe kompilacji są używane przez:

  • DevGateway: Zarejestruj lokalne wystąpienie rozwojowe w usłudze Fabric, aby aplikacja mogła ładować się wewnątrz portalu Fabric podczas rozwoju.
  • DevServer: który dostarcza informacje do sieci szkieletowej
  • Portal administracyjny: w przypadku testowania i produkcji przekaż pakiet manifestu za pośrednictwem Fabric Admin Portal w ramach publikowania. Zobacz Opublikuj swoje zadania.

Dowiedz się więcej

Treści powiązane

  • Last updated on