Поделиться через

Настройка облачного режима рабочей нагрузки

  • Статья

В этой статье описаны требования к развертыванию рабочей нагрузки, которая работает на удаленном сервере с доступом к Интернету в Microsoft Fabric.

Развертывание состоит из двух основных частей:

  • Код клиента рабочей нагрузки: интерфейсный код, внедренный в iFrame в пользовательском интерфейсе Microsoft Fabric.
  • Серверная часть рабочей нагрузки: серверный компонент, который обрабатывает рабочую нагрузку.

Развертывание обоих компонентов в качестве облачных служб. При необходимости можно разместить два компонента на отдельных серверах.

Чтобы работать с рабочей нагрузкой в облачном режиме, необходимо правильно настроить сведения о приложении и доменах.

Формат идентификатора приложения идентификатора Microsoft Entra

Значение приложения resourceId идентификатора Microsoft Entra должно иметь следующий формат:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>
  • Проверенный домен клиента ISV: точное соответствие проверенного домена в клиенте издателя без префиксов или поддоменов. Узнайте, какдобавить личный домен в Microsoft Entra.
  • Внешний сервер рабочей нагрузки: имя внешнего сервера, отображаемое в URL-адресе внешнего интерфейса (дополнительный сегмент в URL-адресе внешнего интерфейса поверх проверенного домена).
  • Серверная часть рабочей нагрузки: имя серверного сервера, отображаемое в URL-адресе серверной части (дополнительный сегмент в URL-адресе серверной части поверх проверенного домена).
  • Идентификация рабочей нагрузки. Идентификатор рабочей нагрузки, как он отображается в манифесте рабочей нагрузки.
  • Идентификатор ресурса: необязательная строка может быть добавлена в конец resourceId значения.

Примечание.

  • *.onmicrosoft Вложенные домены запрещены в URL-адресах.
  • Необязательная строка должна содержать буквенно-цифровые (английский) символы или дефисы только и не может превышать длину 36 символов.

Интерфейсные и внутренние домены

  • Внешние и внутренние URL-адреса должны быть поддоменами resourceId значения, не более одного дополнительного сегмента.
  • Домен узла URL-адреса ответа должен совпадать с доменом внешнего узла.

Примеры

  • Значение приложения resourceId идентификатора Microsoft Entra: 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-адрес перенаправления должен указывать на внешний URL-адрес, добавленный с /close. Например, feserver.datafactory.contoso.com/close.
  2. URI идентификатора приложения должен совпадать с проверенным доменом приложения.

Примечание.

Все остальные конфигурации приложений в идентификаторе Microsoft Entra совпадают с конфигурацией разработчика.

Настройка рабочей нагрузки (серверная часть)

  1. В примере серверной части откройте src/appsettings.json и настройте следующие параметры:

    • Для PublisherTenantId выберите идентификатор клиента издателя.
    • В поле ClientId введите идентификатор приложения (найдите в обзоре идентификатора Microsoft Entra ID).
    • Для ClientSecret введите секрет, созданный при настройке приложения идентификатора Microsoft Entra.
    • Для аудитории введите URI идентификатора, настроенный в приложении Идентификатора Microsoft Entra ID.

  2. Откройте src/Packages/manifest/WorkloadManifest.xml.

  3. В AADAppразделе , задайте AppIdи redirectUriResourceId (URI идентификатора).

Обратите внимание на требования, указанные в XSD-файле и обзоре внутреннего манифеста.

Настройка внешнего приложения

В файле .env.test задайте WORKLOAD_BE_URL URL-адрес серверной части рабочей нагрузки (например, задайте для него значение beserver.datafactory.contoso.com).

Приведем пример:

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