다음을 통해 공유

워크로드 클라우드 모드 설정

  • 아티클

이 문서에서는 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: 워크로드 매니페스트에 표시되는 워크로드 ID입니다.
  • 리소스 ID: 값의 resourceId 끝에 선택적 문자열을 추가할 수 있습니다.

참고 항목

  • *.onmicrosoft 하위 도메인은 URL에서 허용되지 않습니다.
  • 선택적 문자열은 영숫자(영어) 또는 하이픈만 포함해야 하며 길이는 36자를 초과할 수 없습니다.

프런트 엔드 및 백 엔드 도메인

  • 프런트 엔드 및 백 엔드 URL은 최대 1개의 추가 세그먼트가 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. 매니페스트의 섹션에 CloudServiceConfiguration 워크로드의 백 엔드 URL을 추가하고 이름을 지정합니다 Workload.

  2. 매니페스트의 섹션에 CloudServiceConfiguration 워크로드의 프런트 엔드 URL을 추가하고 이름을 지정합니다 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은 프런트 엔드 URL에 추가된 을 가리킵니다 /close. 예들 들어 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. , set , redirectUri및 ResourceId (ID URI) 아래에 AADApp있습니다AppId.

XSD 파일 및 백 엔드 매니페스트 개요에 지정된 요구 사항을 확인합니다.

프런트 엔드 앱 구성

.env.test 파일에서 워크로드 백 엔드 URL(예: 로 설정)으로 beserver.datafactory.contoso.com설정합니다WORKLOAD_BE_URL.

예를 들어 다음과 같습니다.

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