これらの手順に従う代わりに 、セットアップ ガイド を使用することをお勧めします。 詳細に関心がある場合や、いくつかの手順をスキップしようとする場合は、この記事でリポジトリを手動で構成する方法に関する情報を確認できます。
構成ファイルを作成する
リポジトリは、リポジトリ内の .env.{ENVIROMENT} ファイルから構成値を取り込みます。 そのためには、まず 、.env.template ファイルを同じディレクトリ内の .env.dev、 .env.test、 .env.prod にコピーし、値を設定する必要があります。 これらのファイル内の値は、マニフェストの作成に使用されます。 ローカル開発では、通常、.env.dev ファイルのみが必要です。
WorkloadName を決定し、.env.dev ファイルに入力します。
フロントエンドの Microsoft Entra アプリケーションを登録する
CreateDevAADApp.ps1 を使用して新しい Microsoft Entra アプリを作成するか、手順に従います。
- Microsoft Entra IDmin ポータルでアプリの登録に移動します。
- 新しいマルチテナント アプリケーションを作成します。
- 次の SPA リダイレクト URI をアプリケーション マニフェストに追加します。
- https://app.fabric.microsoft.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}
- https://app.powerbi.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}
- https://msit.fabric.microsoft.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}
- https://msit.powerbi.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}
セットアップ プロセスで {WORKLOAD_NAME} を選択します。 リポジトリのプロジェクト構造を見てみましょう。
{TENANT_ID} をお探しですか? 次の手順に従います。
- Microsoft Fabric を開き、右上隅にあるプロファイル画像を選択します。
- プルダウンメニューから概要を選択します。
- [概要] ダイアログで、テナント ID とテナント リージョンを確認します。
アプリが作成されたら、"Workload/.env.dev" ファイルを開き、ワークロード名を "WORKLOAD_NAME" に挿入し、フロントエンド アプリケーション クライアント ID を "FRONTEND_APPID" 構成プロパティに挿入します。
DevGateway
リポジトリには、ダウンロードする必要がある追加のソフトウェアが必要です。 このためには、 DevGateway をダウンロードし、 tools ディレクトリに解凍する必要があります。
DevGateway を起動するには、 workload-dev-mode.json という名前の構成ファイルを build/DevGateway/ ディレクトリで使用できる必要があります。 このファイルは、ワークロードを見つけて提供する方法を DevGateway に指示します。
サンプル構成:
{
"WorkspaceGuid": "your-workspace-guid-here",
"ManifestPackageFilePath": "path/to/Your/Repo/build/Manifest/[WorkloadName].[Version].nupkg",
"WorkloadEndpointURL": "http://127.0.0.1:5000/workload"
}
フィールドの説明:
-
WorkspaceGuid: ワークロードが使用可能な Fabric ワークスペースの GUID。 -
ManifestPackageFilePath: コンパイル済みのワークロード マニフェスト パッケージ (.nupkg ファイル) へのパス。 -
WorkloadEndpointURL: ワークロード バックエンドがホストされている URL (通常はローカル開発サーバー)。