次の方法で共有

開発者ポータルをセルフホストするための代替アプローチ

適用対象: Developer | Basic | Basic v2 | Standard | Standard v2 | Premium | Premium v2

開発者ポータルをセルフホストするときに、次のようないくつかの代替アプローチを検討することができます。

  • デザイナーとパブリッシャーの運用環境用のビルドを使用します。
  • Azure Function App を使用して開発者ポータルを発行します。
  • ページの読み込み時間を短縮するために、開発者ポータルのファイルをコンテンツ配信ネットワークで前面に移動します。

この記事では、これらの各アプローチについて説明します。

まだ設定していない場合は、開発者ポータルの最新リリース用に ローカル環境 を設定します。

運用環境用のビルド

コラボレーションの目的で開発者ポータルの開発環境をオンラインでホストする場合は、デザイナーと発行元の実稼働ビルドを使用します。 実稼働ビルドでは、ファイルがバンドルされ、ソース マップが除外されます。

次のコマンドを実行して、./dist/designer ディレクトリ内にバンドルを作成します。

npm run build-designer

結果はシングル ページ アプリケーションであるため、Azure Blob Storage の静的な Web サイトなどの静的な Web ホストにデプロイすることもできます。

同様に、コンパイル済みの最適化されたパブリッシャーを ./dist/publisher フォルダーに配置します。

npm run build-publisher

Function App を使用して開発者ポータルを発行する

ローカルで実行する代わりに、クラウドで発行手順を実行します。

Azure Function App で発行を実装するには、次の前提条件を満たす必要があります。

  • Azure Function の作成. 関数は JavaScript 言語関数である必要があります。
  • Azure Functions Core Tools をインストールする: 
    npm install -g azure-function-core-tools

手順 1: 出力ストレージを構成する

コンテンツをローカル フォルダーではなくホスティング Web サイトに直接アップロードする。 この場所は、出力ストレージの $web コンテナーです。 ./src/config.publish.json ファイルでこの変更を構成します。

{
   ...
   "outputBlobStorageContainer": "$web",
   "outputBlobStorageConnectionString": "DefaultEndpointsProtocol=...",
   ...
}

手順 2: Function App をビルドしてデプロイする

./examples フォルダーには、HTTP トリガー関数のサンプルがあります。 これをビルドして ./dist/function に配置するには、次のコマンドを実行します。

npm run build-function

次に、Azure CLI にサインインしてそれをデプロイします。

az login
cd ./dist/function
func azure functionapp publish <function app name>

デプロイした後は、HTTP 呼び出しで呼び出すことができます。

curl -X POST https://<function app name>.azurewebsites.net/api/publish

ホスティングとコンテンツ配信ネットワーク

開発者ポータルをセルフホストする場合は、Azure ストレージ アカウントを使用して Web サイトをホストすることをお勧めします。 ただし、ホスティング プロバイダーのサービスを含め、どのようなソリューションでもファイルを発行することができます。

また、コンテンツ配信ネットワークでファイルを前面に移動して、ページの読み込み時間を短縮することもできます。 Azure Content Delivery Network を使用することをお勧めします。

関連コンテンツ

開発者ポータルの詳細については、次を参照してください。

  • Last updated on