通过

设置工作负荷云模式

  • 项目

在本文中，了解在 Microsoft Fabric 中使用 Internet 访问远程服务器上运行的工作负荷的要求。

部署有两个主要部分：

  • 工作负荷客户端代码：在 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：工作负载清单中显示的工作负载 ID。
  • 资源 ID：可将可选字符串添加到 resourceId 值的末尾。

注意

  • URL 中不允许 *.onmicrosoft 子域。
  • 可选字符串只能包含字母数字（英语）字符或连字符，长度不能超过 36 个字符。

前端域和后端域

  • 前端和后端 URL 必须是 resourceId 值的子域，最多只能有 1 个额外的区段。
  • 回复 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 ID 中配置应用程序

若要在 Microsoft Entra 中配置应用程序，请执行以下操作：

  1. 重定向 URL 应指向附加 /close 的前端 URL。 例如，feserver.datafactory.contoso.com/close。
  2. 应用程序 ID URI 应与应用程序的已验证域相匹配。

注意

Microsoft Entra ID 中所有其他应用程序配置都与开发人员模式相同。

配置工作负荷（后端）

  1. 在后端示例中，开启 src/appsettings.json，并配置以下设置：

    • 对于 PublisherTenantId，请选择发布者的租户 ID。
    • 对于 ClientId，请输入应用程序 ID（可在 Microsoft Entra ID 概述中找到）。
    • 对于 ClientSecret，请输入在配置 Microsoft Entra ID 应用时创建的机密。
    • 对于受众，请输入在 Microsoft Entra ID 应用中配置的 ID URI。

  2. 打开 src/Packages/manifest/WorkloadManifest.xml。

  3. 在 AADApp 下,设置 AppId、redirectUri 和 ResourceId (ID URI)。

请注意 XSD 文件和后端清单概述中指定的要求。

配置前端应用

在 .env.test 文件中，将 WORKLOAD_BE_URL 设置为工作负荷后端 URL（例如，将其设置为 beserver.datafactory.contoso.com）。

下面是一个示例：

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