Freigeben über

Workload-Manifest im Extensibility Toolkit

Das Arbeitslastmanifest (WorkloadManifest.xml) ist die Konfiguration auf Arbeitslast-Ebene für Ihre Arbeitslast. Es teilt Fabric mit, wer Ihre Arbeitslast ist und wie Sie Ihr Front-End ansteuern können, damit der Host es sicher initialisieren kann. Es ergänzt, ersetzt aber nicht die Produkt- und Artikeldefinitionen:

  • Produktmetadaten (für Ermittlung und Veröffentlichung) befinden sich in Product.json.
  • Elementtypen und deren Verhalten befinden sich in den Elementmanifesten und JSON-Dateien.

Was das Workloadmanifest definiert

  • Workload-Identität: WorkloadName ([Organisation].[ WorkloadId]) und Version (semantische Version)
  • Hostingmodell: HostingType (Verwenden FERemote)
  • Frontend-Microsoft Entra-App: AADFEApp>AppId
  • Frontend-Endpunkte: ServiceEndpoint Einträge mit Name (z. B. Frontend), Url (localhost in der Entwicklung; die Produktionsdomäne muss eine Unterdomäne Ihrer überprüften Entra-Domäne sein) und IsEndpointResolutionService. Siehe allgemeine Veröffentlichungsanforderungen für Domäneneinschränkungen.
  • Optionale Sandbox-Entspannung: EnableSandboxRelaxation nur, wenn spezielle iFrame-Funktionen erforderlich sind (z. B. Initiieren von Dateidownloads)

Bewährte Methoden

  • Halten Sie die Versionen in Ihrer App und Ihrem Manifest konsistent
  • Deklarieren der erforderlichen Mindestberechtigungen (Prinzip der geringsten Berechtigungen)
  • Überprüfen des Manifests als Teil von CI

Struktur

Wichtige Elemente im Manifest und was sie bedeuten:

  • Stammelement mit einer Schemaversion (z. B SchemaVersion="2.0.0". ).
  • Workload knoten mit Attributen wie:
    • WorkloadName — eindeutiger Bezeichner im Formular [Organization].[WorkloadId] (z. B Org.MyWorkload. ). Wenn Sie nicht beabsichtigen, für andere Mandanten zu veröffentlichen, können Sie Org.[WorkloadId] verwenden. Registrieren Sie zum Publizieren über Mandanten hinweg einen vollständigen WorkloadName bei Fabric.
    • HostingType — gibt das Hosting von Arbeitsauslastungen an; verwenden FERemote.
  • Version node – semantische Version Ihres Workloadpakets.
  • RemoteServiceConfiguration > CloudServiceConfiguration enthaltend:
    • Cloud (z. B. Public).
    • AADFEApp > AppId — enthält die Front-End-Microsoft Entra-Anwendungs-ID.
    • EnableSandboxRelaxation — setzen Sie es auf true, wenn Sie spezielle iFrame-Funktionen benötigen (z. B. das Initiieren von Dateidownloads). Behalten Sie false standardmäßig zur Sicherheit bei.
    • Endpoints > ServiceEndpoint Einträge mit:
      • Name (z. B. Frontend).
      • Url – wo das Frontend gehostet wird. Verwenden Sie https://localhost:port für die Entwicklung. In der Produktionsumgebung muss die Domäne eine Unterdomäne Ihrer überprüften Entra-Domäne sein. Siehe Allgemeine Veröffentlichungsanforderungen für vollständige Informationen zu Domäneneinschränkungen.
      • IsEndpointResolutionService.

Erstellen von Ausgabe- und Platzhaltern

Füllen Sie im Starter-Kit die Platzhalter jedes Mal auf, wenn das Manifest basierend auf der Konfiguration in der Umgebungsdatei erstellt wird. Das endgültige endgültige Manifest wird im build/Manifest Verzeichnis erstellt. Wenn Sie Platzhalter verwenden und aus den Umgebungen auffüllen, können Sie verschiedene Umgebungen erstellen, ohne die Dateien oder skripts zu ändern. Die Buildausgabe wird von:

  • DevGateway: Registrieren Sie Ihre lokale Entwicklungsinstanz bei Fabric, damit Ihre App während der Entwicklung im Fabric-Portal geladen werden kann.
  • DevServer: Was die Informationen für die Fabric bereitstellt
  • Verwaltungsportal: Laden Sie das Manifestpaket für Test und Produktion im Rahmen der Veröffentlichung über das Fabric Admin Portal hoch. Weitere Informationen finden Sie unter Veröffentlichen Ihrer Workload.

Learn more

Verwandte Inhalte

  • Last updated on