共用方式為

設定工作負載雲端模式

  • 發行項

在本文中，瞭解部署工作負載的需求，該工作負載可在 Microsoft Fabric 中使用因特網存取的遠端伺服器上運作。

部署有兩個主要部分：

  • 工作負載客戶端程序代碼：Microsoft Fabric UI 中內嵌為 iFrame 的前端程序代碼。
  • 工作負載後端：處理工作負載的後端伺服器端元件。

將這兩個元件部署為雲端服務。 如有需要，您可以在不同的伺服器上裝載這兩個元件。

若要在雲端模式中使用工作負載，您必須正確設定應用程式資訊和網域。

Microsoft Entra ID 應用程式 resourceId 格式

Microsoft Entra ID 應用程式 resourceId 值的格式應如下：

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>
  • ISV 的租用戶已驗證網域：與發行者租使用者中已驗證的網域完全相符，不含任何前置詞或子域。 瞭解如何將自定義網域新增至 Microsoft Entra。
  • 工作負載前端伺服器：前端伺服器名稱，其出現在前端URL中（已驗證網域頂端URL的額外區段）。
  • 工作負載後端伺服器：後端伺服器名稱出現在後端URL中（已驗證網域頂端後端URL的額外區段）。
  • 工作負載 ID：工作負載標識碼出現在工作負載指令清單中。
  • 資源標識碼：選擇性字串可以新增至值的結尾 resourceId 。

注意

  • URL 中不允許 *.onmicrosoft 子網域。
  • 選擇性字串必須僅包含英數位元 (英文) 字元或連字元，且長度不能超過 36 個字元。

前端和後端網域

  • 前端和後端 URL 必須是值的子域 resourceId ，且最多只能有一個額外的區段。
  • 回復 URL 主機網域應該與前端主機網域相同。

範例

  • Microsoft Entra ID 應用程式 resourceId 值： https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
  • 前端/網域︰https://feserver.datafactory.contoso.com
  • 後端網域︰https://beserver.datafactory.contoso.com
  • 重新導向 URI：https://feserver.datafactory.contoso.com/close

設定工作負載的端點

若要設定工作負載端點：

  1. 將工作負載的後端 URL 新增至 CloudServiceConfiguration 指令清單中的 區段，並將其命名為 Workload。

  2. 將工作負載的前端 URL 新增至 CloudServiceConfiguration 指令清單中的 區段，並將其命名為 Frontend。

以下是範例：

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

在 Microsoft Entra 識別碼中設定您的應用程式

若要在 Microsoft Entra 中設定您的應用程式：

  1. 重新導向 URL 應該指向附加的 /close前端 URL。 例如： feserver.datafactory.contoso.com/close 。
  2. 應用程式 ID URI 應符合您應用程式的驗證網域。

注意

Microsoft Entra ID 中所有其他應用程式組態都與開發人員模式相同。

設定您的工作負載 （後端）

  1. 在後端範例中，開啟 src/appsettings.json 並設定下列設定：

    • 針對 PublisherTenantId，選取發行者的租用戶標識碼。
    • 針對 ClientId，輸入您的應用程式識別碼（位於 Microsoft Entra ID 概觀中）。
    • 針對 ClientSecret，輸入您在設定 Microsoft Entra ID 應用程式時所建立的秘密。
    • 針對 [ 物件]，輸入您在 Microsoft Entra ID 應用程式中設定的識別碼 URI。

  2. 開啟 src/Packages/manifest/WorkloadManifest.xml。

  3. 在底下 AADApp，設定 AppId、 redirectUri和 ResourceId （標識碼 URI）。

請注意 XSD 檔案和後端指令清單概觀中指定的需求。

設定前端應用程式

在 .env.test 檔案中，將 設定WORKLOAD_BE_URL為工作負載後端URL（例如，將其設定為 beserver.datafactory.contoso.com）。

以下是範例：

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