DevGateway は、ローカル ワークロード インスタンスを Fabric に登録するために開発中に実行する小さなヘルパーです。 これは、フロントエンドがホストされている場所 (localhost 上の DevServer) と、マニフェストに基づいて使用可能な項目を Fabric サービスに通知します。 DevGateway を実行すると、Fabric は iFrame に UI を読み込み、ローカルの DevServer を呼び出して製品と項目のメタデータを読み取ることができます。テナントにパッケージを発行する必要はありません。
DevGateway の機能
- 現在サインインしている開発者の特定のワークスペースにローカル ワークロード インスタンスを登録します。
- マニフェストを使用して、ワークロード ID とエントリ ポイントについて Fabric に通知します。
- ファブリック ホストの呼び出しをローカル環境にルーティングして、反復処理中にプラットフォームがフロントエンドを読み込んで項目を検出できるようにします。
- 実際にフロントエンドをホストし、マニフェスト エンドポイントを公開する DevServer と連携して動作します。
注
DevGateway は、Web アプリやマニフェスト自体を提供しません。 代わりに、あなたのローカルインスタンスが登録され、Fabric はあなたの DevServer とマニフェストを指します。
開発におけるマニフェストの活用方法
ワークロードは、開発と運用の両方でマニフェスト駆動型です。 開発中:
- DevGateway では、ローカル構成を使用して、(ワークロード マニフェストで定義されている) ワークロードの ID とエントリ ポイントをアドバタイズします。
- その後、Fabric は DevServer を呼び出して、ローカル エンドポイント (テンプレートの ルートなど) を介して製品マニフェストと
/manifestsをフェッチし、サービスがナビゲーション、タイル、作成エクスペリエンスをレンダリングできるようにします。
これは発行時に何が起こるかを反映しますが、高速な反復のためにすべてがローカルのままです。
一般的な開発フロー
- DevServer を起動して、localhost でフロントエンドをホストします。
- DevGateway を起動し、ターゲット ワークスペースの管理者であるユーザーでサインインします。
- Fabric ワークスペースを開き、ワークロード エントリ ポイントを使用します。Fabric は UI を iFrame に読み込み、マニフェストを介して項目を検出します。
- UI ファイルとマニフェスト ファイルを編集し、更新して変更をすぐに確認します。
詳細なセットアップと開始手順については、作業の開始 チュートリアル を参照してください。
構成入力
テンプレートに応じて、DevGateway は次を含むローカル構成を読み取ります。
- 登録対象のワークスペース
- ローカルのフロントエンドのエンドポイント（DevServerのURL）
- 開発中に使用されるマニフェスト ファイル/アセットへのパスまたは参照
リポジトリのセットアップ/ビルド スクリプトでは、DevGateway と DevServer の同期が維持されるように、この構成が自動的に生成または更新されます。
トラブルシューティングのヒント
- UI が Fabric で開かない場合は、DevGateway と DevServer の両方を開始し、必要なアクセス許可を持つワークスペースにサインインしていることを確認します。
- Fabric が項目を検出できない場合は、DevServer のマニフェスト エンドポイントが有効な JSON を返し、DevGateway がサービスを正しい localhost URL にポイントすることを確認します。
- アイコンまたは文字列が見つからない場合は、マニフェスト内の資産パスと、DevServer がそれらを提供していることを確認します。