チュートリアル: コード ファーストのJSS Next.jsアプリケーションをSitecoreに接続する

JSSアプリ初期化子を使用してJSSサンプルに基づいて作成されたアプリケーションには、アプリケーションで作成された構成パッチにサイト定義が含まれます。

JSSアプリケーションのルート フォルダで、構成パッチ /sitecore/config/<AppName>.configを含むファイルを開き、hostName属性がサーバーが応答する必要があるホスト ヘッダーと一致することを確認します。 Sitecoreインストールのデフォルト サイトとなるJSSアプリをデプロイする場合は、hostName属性を削除して、JSSアプリが任意のホストに応答するようにすることができます。

次に、サイト名とホスト名を設定するためのサイト設定例を示します。

<!-- other attributes removed for brevity -->
<site x:before="site[@name='website']"
      hostName="myapp.siteco.re" />

ローカルインスタンスを使用している場合は、hostsファイルエントリで目的のホスト名をローカルホストにマップする必要があります。

Windowsのhostsファイル エントリでホスト名をlocalhostにマップするには:

ホスト名エントリを追加したら、それをIISインスタンスにもバインディングとして追加します。

複数のJSSアプリケーションをデプロイする予定の場合は、SitecoreのIISで異なるホストとホスト名バインディングを設定して、正しいサイトを解決する必要があります。

接続を設定するには:

jss setupプロセスでは、JSSアプリケーションの接続文字列を含む /scjssconfig.jsonファイルが生成されます。

JSSアプリは、Sitecoreサーバーにデプロイされた構成パッチを使用してSitecoreに登録されます。サーバーのセットアップ時に、hostName属性を設定するときに、これらのパッチの1つをすでに編集しています。構成パッチをサーバー上で有効にするには、その前にデプロイする必要があります。構成は、自動的にデプロイ (推奨) または手動でデプロイできます。

自動デプロイでは、JSS CLIを使用してJSSアプリから直接構成パッチをデプロイします。

設定パッチを自動的にデプロイするには:

自動構成デプロイでは、Sitecore内でJSSアプリが構成され、そのサイトが作成され、公開せずにライブ モードが有効になります。開発者は、パッチ ファイルを慎重に確認して、すべての設定が環境に対して正しいことを確認する必要があります。たとえば、本番環境では、アプリケーションをライブモードで実行しないでください。

JSSアプリ設定を専任のSitecore開発者 (またはDevOps) がデプロイする場合、またはリモート インスタンスで作業している場合は、JSSアプリ設定を手動でデプロイする必要があります。JSSアプリケーションからsitecore/config/*.configパッチを取得し、zzzフォルダーなどの任意の場所にあるApp_Config/Includeフォルダーにデプロイします。デプロイする前に、構成パッチの内容を確認してください。

JSS for Iron Next.jsで構築されたアプリケーションは、Next.jsの特殊性により、React、Angular、Vue.jsのJSSで構築されたアプリケーションとは異なる方法でデプロイされます。基本的に、Next.jsサーバーがあるため、JSS Next.jsアプリはHTTPレンダリング エンジンを使用します。

JSS Next.jsアプリをSitecoreインストールにデプロイするには、次の手順に従います。