Konfigurowanie trybu chmury obciążenia

Artykuł
11/24/2024

W tym artykule przedstawiono wymagania dotyczące wdrażania obciążenia działającego na serwerze zdalnym z dostępem do Internetu w usłudze Microsoft Fabric.

Wdrożenie ma dwie główne części:

Kod klienta obciążenia: kod frontonu osadzony jako element iFrame w interfejsie użytkownika usługi Microsoft Fabric.
Zaplecze obciążenia: zaplecze, składnik po stronie serwera, który przetwarza obciążenie.

Wdróż oba składniki jako usługi w chmurze. W razie potrzeby można hostować dwa składniki na oddzielnych serwerach.

Aby pracować z obciążeniem w trybie chmury, należy poprawnie skonfigurować informacje o aplikacji i domeny.

Format resourceId aplikacji Microsoft Entra ID

Wartość aplikacji resourceId Microsoft Entra ID powinna mieć następujący format:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>

Domena zweryfikowana przez niezależnego dostawcę oprogramowania: dokładne dopasowanie zweryfikowanej domeny w dzierżawie wydawcy bez żadnych prefiksów ani domen podrzędnych. Dowiedz się, jakdodać domenę niestandardową do firmy Microsoft Entra.
Serwer frontonu obciążenia: nazwa serwera frontonu wyświetlana w adresie URL frontonu (dodatkowy segment w adresie URL frontonu w górnej części zweryfikowanej domeny).
Serwer zaplecza obciążenia: nazwa serwera zaplecza wyświetlana w adresie URL zaplecza (dodatkowy segment w adresie URL zaplecza w górnej części zweryfikowanej domeny).
Tożsamość obciążeń: identyfikator obciążenia wyświetlany w manifeście obciążenia.
Identyfikator zasobu: opcjonalny ciąg można dodać na końcu resourceId wartości.

Uwaga

*.onmicrosoft poddomeny nie są dozwolone w adresach URL.
Opcjonalny ciąg musi zawierać tylko znaki alfanumeryczne (angielski) lub łączniki i nie może przekraczać 36 znaków.

Domeny frontonu i zaplecza

Adresy URL frontonu i zaplecza muszą być poddomenami resourceId wartości z maksymalnie jednym dodatkowym segmentem.
Domena hosta adresu URL odpowiedzi powinna być taka sama jak domena hosta frontonu.

Przykłady

Wartość aplikacji resourceId Microsoft Entra ID: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
Domena frontonu: https://feserver.datafactory.contoso.com
Domena zaplecza: https://beserver.datafactory.contoso.com
Identyfikator URI przekierowania: https://feserver.datafactory.contoso.com/close

Konfigurowanie punktów końcowych obciążenia

Aby skonfigurować punkty końcowe obciążenia:

Dodaj adres URL zaplecza obciążenia do CloudServiceConfiguration sekcji w manifeście i nadaj mu Workloadnazwę .
Dodaj adres URL frontonu obciążenia do CloudServiceConfiguration sekcji w manifeście i nadaj mu Frontendnazwę .

Oto przykład:

<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>

Konfigurowanie aplikacji w usłudze Microsoft Entra ID

Aby skonfigurować aplikację w usłudze Microsoft Entra:

Adres URL przekierowania powinien wskazywać adres URL frontonu dołączony za pomocą /closepolecenia . Na przykład feserver.datafactory.contoso.com/close.
Identyfikator URI identyfikatora aplikacji powinien być zgodny z zweryfikowaną domeną aplikacji.

Uwaga

Wszystkie inne konfiguracje aplikacji w identyfikatorze Entra firmy Microsoft są takie same jak w trybie dewelopera.

Konfigurowanie obciążenia (zaplecza)

W przykładzie zaplecza otwórz plik src/appsettings.json i skonfiguruj następujące ustawienia:
- W polu PublisherTenantId wybierz identyfikator dzierżawy wydawcy.
- W polu ClientId wprowadź identyfikator aplikacji (znajdujący się w przeglądzie identyfikatora entra firmy Microsoft).
- W polu ClientSecret wprowadź wpis tajny utworzony podczas konfigurowania aplikacji Microsoft Entra ID.
- W polu Odbiorcy wprowadź identyfikator URI skonfigurowany w aplikacji Microsoft Entra ID.
Otwórz plik src/Packages/manifest/WorkloadManifest.xml.
W obszarze AADAppustaw AppIdwartości , redirectUrii ResourceId (identyfikator URI).

Zwróć uwagę na wymagania określone w pliku XSD i omówienie manifestu zaplecza.

Konfigurowanie aplikacji frontonu

W pliku .env.test ustaw WORKLOAD_BE_URL adres URL zaplecza obciążenia (na przykład ustaw go na beserver.datafactory.contoso.comwartość ).