攻略.js用のSitecoreコンテナテンプレートを使った開発環境の設定
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Next.js用のSitecoreコンテナテンプレートを使えば、フルスタックのSitecoreファースト のJSS Next.jsプロジェクトを作成できます。
このウォークスルーでは、Next.js用のSitecoreコンテナテンプレートを使って開発環境を設定する手順を説明します。
テンプレートをインストールし、SitecoreとNext.js JSSのフルスタックソリューションを作成する前に、ワークステーションに以下のソフトウェアコンポーネントが必要です:
- 有効なSitecoreライセンスファイル。
- Windows PowerShell 5.1。PowerShell 7は現時点ではサポートされていません。
- 現在の長期サポート(LTS)バージョンの Node.jsです。
- Core 3.1 SDK.NET(インストールされたバージョンをdotnet --version
- .NET Framework 4.8 SDK (. NETフレームワークのバージョンを確認するためのMicrosoft手順を参照)。
- Visual Studio 2019。
- Docker Windows用で、 Windows Containers を有効にしています。
- Sitecoreコンテナを使用するために必要なコンポーネントについて。
- ギット
!注このテンプレートは、現在のSitecore XPおよびJSSのリリース向けに開発環境を設定します。ライセンスされたSitecore XPバージョンでどのJSSを使うべきか知りたい場合は、Sitecore互換性テーブルを参照してください。
このウォークスルーでは、以下の方法を説明します:
- テンプレートをインストールしてください。
- プロジェクトの解決策を作成します。
- 検索インデックスを再構築しましょう。
テンプレートをインストールする
解決策を作成する前に、.NET sitecore.nextjs.gettingstartedテンプレートをダウンロードしてファイルシステムにインストールする必要があります。
テンプレートをインストールするには:
-
管理者権限でPowerShellを開いてください。
-
次のコマンドを実行します:
dotnet new -i Sitecore.DevEx.Templates --nuget-source https://nuget.sitecore.com/resources/v3/index.json
!注dotnetツールはインストールが成功したことを示す明確なフィードバックを提供しません。しかし、インストールコマンドの最後にインストールされたすべてのテンプレートが一覧表示されます。インストールが成功した場合、リストにはsitecore.nextjs.gettingstartedが含まれています。
プロジェクトソリューションの作成
解名は自由にできますが、この例では解MyProject名を付けています。
!重要プロジェクトやフォルダ名に非ラテン文字を使用しないでください。Dockerレジストリ名やURLの文字数制限により、非ラテン文字を使用すると予期せぬ結果が生じる可能性があります。
MyProject解を作成するには:
-
管理者権限でPowerShellを開いてください。
-
インターネット情報サーバーがポート443で動いているか確認してください:
Get-Process -Id (Get-NetTCPConnection -LocalPort 443).OwningProcess
もしそうなら、必ず止めなければなりません:
iisreset /stop
-
Apache Solrや他のサービスがポート8984で動いているか確認してください:
Get-Process -Id (Get-NetTCPConnection -LocalPort 8984).OwningProcess
もしそうなら、必ず止めなければなりません:
Stop-Service -Name "
" あるいは、Non-Sucking Service Managerで起動している場合は、次のコマンドで終了してください。
nssm stop "
" -
ソリューションフォルダに行き、MyProjectのソリューションとプロジェクトを作成します:
dotnet new sitecore.nextjs.gettingstarted -n MyProject
!ヒントテンプレートが内部的に呼び出すjss createコマンドに渡されるパラメータは、--JSSCreateParamsパラメータを使ってjss createコマンドに渡すことでカスタマイズできます。例えば:
dotnet new sitecore.nextjs.gettingstarted -n MyProject --JSSCreateParams "--fetchWith GraphQL --prerender SSR"
-
MyProjectフォルダに行ってください。
-
Sitecoreコンテナ環境を準備するには、プロジェクトのルートディレクトリからスクリプトinit.ps1を実行します:
.\init.ps1 -InitEnv -LicenseXmlPath "<C:\path\to\license.xml>" -AdminPassword "
" -
Sitecore Dockerイメージをダウンロードし、コンテナおよびJSSアプリケーションのインストールおよび設定を行うには、以下のスクリプトを実行してください。
.\up.ps1
-
ブラウザで促されたら、Sitecoreにログインしてデバイスの承認を受け入れてください。
-
起動スクリプトがレンダリングされたサイトとSitecore Launchpadのブラウザタブを開くのを待ちます。
再構築検索インデックス
- スクリプト .\up.ps1 を初めて実行した後、あるいはスクリプト \docker\clean.ps1を実行する場合は、 検索インデックスを再構築する必要があります。