次の方法で共有

ワークロード クラウド モードを設定する

  • [アーティクル]

この記事では、Microsoft Fabric でインターネット アクセスを持つリモート サーバー上で動作するワークロードをデプロイするための要件を学習します。

このデプロイは、以下の 2 つの重要なパーツを持ちます。

  • ワークロード クライアント コード: Microsoft Fabric UI に iFrame として埋め込まれたフロントエンド コード。
  • ワークロード バックエンド: ワークロードを処理するバックエンドのサーバー側コンポーネント。

両方のコンポーネントをクラウド サービスとして配置します。 この 2 つのコンポーネントは、必要に応じて個別のサーバー上でホストできます。

クラウド モードでワークロードを処理するには、アプリ情報とドメインを正しく構成する必要があります。

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 値の後に追加できます。

Note

  • *.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. ワークロードのバックエンド 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 は、アプリケーションの検証済みドメインと一致していることが必要です。

Note

Microsoft Entra ID 内のその他のアプリケーション構成はすべて、開発者モードと同じです。

ワークロードを構成する (バックエンド)

  1. バックエンド サンプルで、src/appsettings.json を開き、以下の設定を構成します。

    • PublisherTenantId では、発行元のテナント ID を選択します。
    • ClientId には、アプリケーション ID を入力します (Microsoft Entra ID の概要で確認できます)。
    • ClientSecret には、Microsoft Entra ID アプリを構成したときに作成したシークレットを入力します。
    • Audience には、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