Del via

Konfigurere skymodus for arbeidsbelastning

  • Artikkel

I denne artikkelen lærer du kravene for å distribuere en arbeidsbelastning som opererer på en ekstern server med Internett-tilgang i Microsoft Fabric.

Distribusjonen har to hoveddeler:

  • Arbeidsbelastningsklientkode: Frontend-kode som er innebygd som en iFrame i Brukergrensesnittet for Microsoft Fabric.
  • Arbeidsbelastningsstøtte: Komponenten på serversiden som behandler arbeidsbelastningen din.

Distribuer begge komponentene som skytjenester. Du kan være vert for de to komponentene på separate servere om nødvendig.

Hvis du vil arbeide med arbeidsbelastningen i skymodus, må du konfigurere appinformasjonen og domenene på riktig måte.

Microsoft Entra ID-app resourceId-format

Microsoft Entra ID-appverdien resourceId må være i følgende format:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>
  • ISVs leierbekreftede domene: Et nøyaktig samsvar med det bekreftede domenet i utgiverens leier uten prefikser eller underdomener. Lær hvordan du legger tilet egendefinert domene i Microsoft Entra.
  • Arbeidsbelastningsforekomstserver: Det frontede servernavnet slik det vises i url-adressen for frontend (det ekstra segmentet i url-adressen for frontend øverst i det bekreftede domenet).
  • Server for server for arbeidsbelastning: Servernavnet for bakserveren slik det vises i url-adressen for bakserveren (det ekstra segmentet i url-adressen for bakserveren øverst i det bekreftede domenet).
  • Arbeidsbelastnings-ID: Arbeidsbelastnings-ID-en slik den vises i arbeidsbelastningsmanifestet.
  • Ressurs-ID: En valgfri streng kan legges til på slutten av resourceId verdien.

Merk

  • *.onmicrosoft underdomener er ikke tillatt i URL-adresser.
  • Den valgfrie strengen må inneholde alfanumeriske (engelsk) tegn eller bindestreker og kan ikke overskride en lengde på 36 tegn.

Domener for frontend og serverdel

  • Url-adresser for frontend og serverdel må være underdomener resourceId for verdien, med maksimalt ett ekstra segment.
  • Vertsdomenet for url-adressen for svar skal være det samme som vertsdomenet for frontend.

Eksempler

  • Microsoft Entra ID-appverdi resourceId : https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
  • Frontend-domene: https://feserver.datafactory.contoso.com
  • Serverdeldomene: https://beserver.datafactory.contoso.com
  • Omadresserings-URI: https://feserver.datafactory.contoso.com/close

Konfigurer arbeidsbelastningens sluttpunkter

Slik konfigurerer du arbeidsbelastningens sluttpunkter:

  1. Legg til url-adressen for arbeidsbelastningens serverdel i inndelingen CloudServiceConfiguration i manifestet, og gi den Workloadet navn.

  2. Legg til url-adressen for arbeidsbelastningens frontend i inndelingen CloudServiceConfiguration i manifestet, og gi den et Frontendnavn.

Her er et eksempel:

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

Konfigurere programmet i Microsoft Entra ID

Slik konfigurerer du programmet i Microsoft Entra:

  1. Url-adressen for omadressering skal peke til url-adressen for fronten som er lagt til med /close. Eksempel: feserver.datafactory.contoso.com/close.
  2. Program-ID-URI-en skal samsvare med det bekreftede domenet i programmet.

Merk

Alle andre programkonfigurasjoner i Microsoft Entra ID er de samme som i utviklermodus.

Konfigurer arbeidsbelastningen (serverdel)

  1. Åpne src/appsettings.json i serverdeleksempelet, og konfigurer følgende innstillinger:

    • Velg leier-ID-en for utgiveren for PublisherTenantId.
    • For ClientId skriver du inn program-ID-en (funnet i oversikten over Microsoft Entra-ID).
    • For ClientSecret skriver du inn hemmeligheten du opprettet da du konfigurerte Microsoft Entra ID-appen.
    • Skriv inn ID URI-en du konfigurerte i Microsoft Entra ID-appen for Målgruppe.

  2. Åpne src/Pakker/manifest/WorkloadManifest.xml.

  3. Under AADApp, angi AppId, redirectUriog ResourceId (ID URI).

Legg merke til kravene som er angitt i XSD-filen og oversikten over serverdelmanifestet.

Konfigurere frontend-appen

I .env.test-filen, satt WORKLOAD_BE_URL til url-adressen for arbeidsbelastningen (for eksempel angi den til beserver.datafactory.contoso.com).

Her er et eksempel:

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