Freigeben über

Einrichten des Workload-Cloudmodus

  • Artikel

In diesem Artikel lernen Sie die Anforderungen für die Bereitstellung einer Workload kennen, die auf einem Remoteserver mit Internetzugang in Microsoft Fabric ausgeführt wird.

Die Bereitstellung umfasst zwei Hauptteile:

  • Workload-Clientcode: Front-End-Code, der als iFrame in die Microsoft Fabric-Benutzeroberfläche eingebettet ist.
  • Workload-Back-End: Die serverseitige Komponente, die die Workload verarbeitet.

Stellen Sie beide Komponenten als Clouddienste bereit. Sie können die beiden Komponenten bei Bedarf auf separaten Servern hosten.

Wenn Sie mit Ihrer Workload im Cloudmodus arbeiten möchten, müssen Sie Ihre App-Informationen und Domänen richtig konfigurieren.

resourceId-Format der Microsoft Entra ID-App

Der resourceId-Wert der Microsoft Entra ID-App sollte im folgenden Format vorliegen:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>
  • Verifizierte Domäne des ISV-Mandanten: eine exakte Übereinstimmung der verifizierten Domäne im Mandanten des Herausgebers ohne Präfixe oder Unterdomänen. Erfahren Sie, wie Sie eine benutzerdefinierte Domäne zu Microsoft Entra ID hinzufügen.
  • Workload-Front-End-Server: der Front-End-Servername, wie er in der Front-End-URL angezeigt wird (das zusätzliche Segment in der Front-End-URL über der verifizierten Domäne)
  • Workload-Back-End-Server: der Back-End-Servername, wie er in der Back-End-URL angezeigt wird (das zusätzliche Segment in der Back-End-URL über der verifizierten Domäne)
  • Workload-ID: die Workload-ID, wie sie im Workload-Manifest angezeigt wird
  • Ressourcen-ID: eine optionale Zeichenfolge kann am Ende des resourceId-Werts hinzugefügt werden.

Hinweis

  • *.onmicrosoft-Unterdomänen sind in URLs nicht zulässig.
  • Die optionale Zeichenfolge darf nur alphanumerische (englische) Zeichen oder Bindestriche enthalten und maximal 36 Zeichen lang sein.

Front-End- und Back-End-Domänen

  • Front-End- und Back-End-URLs müssen Unterdomänen des resourceId-Werts mit maximal einem zusätzlichen Segment sein.
  • Die Hostdomäne der Antwort-URL sollte mit der Front–End-Hostdomäne übereinstimmen.

Beispiele

  • resourceId-Wert der Microsoft Entra ID-App: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
  • Front-End-Domäne: https://feserver.datafactory.contoso.com
  • Back-End-Domäne: https://beserver.datafactory.contoso.com
  • Umleitungs-URI: https://feserver.datafactory.contoso.com/close

Konfigurieren der Endpunkte der Workload

So konfigurieren Sie die Workload-Endpunkte:

  1. Fügen Sie die Back-End-URL der Workload dem Abschnitt CloudServiceConfiguration im Manifest hinzu, und geben Sie ihr den Namen Workload.

  2. Fügen Sie die Front-End-URL der Workload dem Abschnitt CloudServiceConfiguration im Manifest hinzu, und geben Sie ihr den Namen Frontend.

Hier sehen Sie ein Beispiel:

<CloudServiceConfiguration>
    <Cloud>Public</Cloud>
    ...
    <Endpoints>
        <ServiceEndpoint>
        <Name>Workload</Name>
        <Url>https://beserver.datafactory.contoso.com/workload</Url>
        </ServiceEndpoint>
        <ServiceEndpoint>
        <Name>Frontend</Name>
        <Url>https://feserver.datafactory.contoso.com</Url>
        </ServiceEndpoint>
    </Endpoints>
</CloudServiceConfiguration>

Ihre Anwendung in Microsoft Entra ID konfigurieren

So konfigurieren Sie Ihre Anwendung in Microsoft Entra ID:

  1. Die Umleitungs-URL muss auf die Front-End-URL verweisen, an die /close angefügt ist. Beispiel: feserver.datafactory.contoso.com/close.
  2. Der Anwendungs-ID-URI muss mit der verifizierten Domäne der Anwendung übereinstimmen.

Hinweis

Alle anderen Anwendungskonfigurationen in Microsoft Entra ID entsprechen denen im Entwicklermodus.

Konfigurieren Ihrer Workload (Back-End)

  1. Öffnen Sie im Back-End-Beispiel src/appsettings.json, und konfigurieren Sie die folgenden Einstellungen:

    • Wählen Sie für PublisherTenantIddie Mandanten-ID des Herausgebers aus.
    • Geben Sie für ClientId Ihre Anwendungs-ID ein (die in der Microsoft Entra ID-Übersicht zu finden ist).
    • Geben Sie für ClientSecretdas Geheimnis ein, das Sie beim Konfigurieren der Microsoft Entra ID-App erstellt haben.
    • Geben Sie für Audience den ID-URI ein, den Sie in der Microsoft Entra ID-App konfiguriert haben.

  2. Öffnen Sie src/Packages/manifest/WorkloadManifest.xml.

  3. Legen Sie unter AADApp die Werte für AppId, redirectUri und ResourceId (den ID-URI) fest.

Beachten Sie die Anforderungen, die in der XSD-Datei und in der Übersicht über das Back-End-Manifest angegeben sind.

Konfigurieren der Front-End-App

Legen Sie in der Datei .env.test das Element WORKLOAD_BE_URL auf Ihre Workload-Back-End-URL fest (z. B. auf beserver.datafactory.contoso.com).

Hier sehen Sie ein Beispiel:

WORKLOAD_NAME=Fabric.WorkloadSample
WORKLOAD_BE_URL=beserver.datafactory.contoso.com