Sdílet prostřednictvím

Nastavení cloudového režimu úloh

  • Článek

V tomto článku se seznámíte s požadavky na nasazení úlohy, která funguje na vzdáleném serveru s přístupem k internetu v Microsoft Fabric.

Nasazení má dvě hlavní části:

  • Kód klienta úlohy: Front-endový kód, který je vložený jako prvek iFrame v uživatelském rozhraní Microsoft Fabric.
  • Back-end úlohy: Back-endová komponenta na straně serveru, která zpracovává vaši úlohu.

Nasaďte obě komponenty jako cloudové služby. V případě potřeby můžete tyto dvě komponenty hostovat na samostatných serverech.

Pokud chcete pracovat s úlohou v cloudovém režimu, musíte správně nakonfigurovat informace o aplikaci a domény.

Formát ID aplikace Microsoft Entra ID

Hodnota aplikace resourceId Microsoft Entra ID by měla být v následujícím formátu:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>
  • Ověřená doména tenanta nezávislých výrobců softwaru: Přesná shoda ověřené domény v tenantovi vydavatele bez předpon nebo subdomén. Zjistěte, jak přidatvlastní doménu do Microsoft Entra.
  • Front-endový server úlohy: Název front-endového serveru, jak se zobrazuje v adrese URL front-endu (extra segment v adrese URL front-endu nad ověřenou doménou).
  • Back-endový server úlohy: Název back-endového serveru, jak se zobrazuje v adrese URL back-endu (extra segment v adrese URL back-endu nad ověřenou doménou).
  • ID úloh: ID úlohy, jak se zobrazuje v manifestu úlohy.
  • ID prostředku: Na konec resourceId hodnoty lze přidat volitelný řetězec.

Poznámka:

  • *.onmicrosoft subdomény nejsou povoleny v adresách URL.
  • Volitelný řetězec musí obsahovat pouze alfanumerické znaky nebo spojovníky a nesmí překročit délku 36 znaků.

Front-endové a back-endové domény

  • Front-endové a back-endové resourceId adresy URL musí být subdomény hodnoty s maximálně jedním dalším segmentem.
  • Hostitelská doména adresy URL odpovědi by měla být stejná jako doména hostitele front-endu.

Příklady

  • Hodnota aplikace resourceId Microsoft Entra ID: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
  • Front-endová doména: https://feserver.datafactory.contoso.com
  • Back-endová doména: https://beserver.datafactory.contoso.com
  • Identifikátor URI přesměrování: https://feserver.datafactory.contoso.com/close

Konfigurace koncových bodů úlohy

Konfigurace koncových bodů úlohy:

  1. Přidejte adresu URL back-endu úlohy do CloudServiceConfiguration oddílu v manifestu a pojmenujte ji Workload.

  2. Přidejte adresu URL front-endu úlohy do CloudServiceConfiguration oddílu v manifestu a pojmenujte ji Frontend.

Tady je příklad:

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

Konfigurace aplikace v Microsoft Entra ID

Konfigurace aplikace v Microsoft Entra:

  1. Adresa URL přesměrování by měla odkazovat na adresu URL front-endu připojenou pomocí /close. Například feserver.datafactory.contoso.com/close.
  2. Identifikátor URI ID aplikace by se měl shodovat s ověřenou doménou vaší aplikace.

Poznámka:

Všechny ostatní konfigurace aplikací v MICROSOFT Entra ID jsou stejné jako v vývojářském režimu.

Konfigurace úlohy (back-end)

  1. V ukázce back-endu otevřete src/appsettings.json a nakonfigurujte následující nastavení:

    • Jako PublisherTenantId vyberte ID tenanta vydavatele.
    • Jako ClientId zadejte ID vaší aplikace (které najdete v přehledu ID Microsoft Entra).
    • V případě ClientSecret zadejte tajný klíč, který jste vytvořili při konfiguraci aplikace Microsoft Entra ID.
    • Jako cílovou skupinu zadejte identifikátor URI ID, který jste nakonfigurovali v aplikaci Microsoft Entra ID.

  2. Otevřete soubor src/Packages/manifest/WorkloadManifest.xml.

  3. V části AADApp, set AppId, redirectUria ResourceId (IDENTIFIKÁTOR URI ID).

Všimněte si požadavků zadaných v souboru XSD a přehledu manifestu back-endu.

Konfigurace front-endové aplikace

V souboru .env.test nastavte WORKLOAD_BE_URL na adresu URL back-endu vaší úlohy (například ji nastavte na beserver.datafactory.contoso.com).

Tady je příklad:

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