チュートリアル: Next.jsのSitecoreコンテナーテンプレートを使用した開発環境のセットアップ

Version: 22.x

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Next.jsのSitecoreコンテナーテンプレートを使用すると、フルスタックのSitecoreファーストのJSS Next.jsプロジェクトを作成できます。

このチュートリアルでは、Next.jsのSitecoreコンテナーテンプレートを使用して開発環境を設定する手順について説明します。

テンプレートをインストールしてSitecoreのフルスタックソリューションとNext.jsのJSSを作成する前に、ワークステーションに次のソフトウェアコンポーネントが必要です。

有効なSitecoreライセンスファイル。
Windows PowerShell 5.1です。現時点では、PowerShell 7はサポートされていません。
Node.jsの現在の長期サポート (LTS) バージョン。
.NET Core 3.1 SDK ( dotnet --versionコマンドでインストールされているバージョンを確認してください)。
.NET Framework 4.8 SDK ( .NET Frameworkのバージョンを確認するためのMicrosoftの手順を参照)。
Visual Studio 2019です。
Docker for Windowsで、Windows Containersが有効になっています。
Sitecoreコンテナを使用するために必要なコンポーネント。

メモ

このテンプレートは、Sitecore XPとJSSの現在のリリースの開発環境を構成します。ライセンスされたSitecore XPバージョンで使用するJSSのバージョンを確認するには、Sitecore互換性の表を参照してください。

このチュートリアルでは、次の方法について説明します。

テンプレートをインストールします。
プロジェクトソリューションを作成します。
検索インデックスを再構築します。

テンプレートをインストールする

ソリューションを作成する前に、.NET sitecore.nextjs.gettingstartedテンプレートをファイルシステムにダウンロードしてインストールする必要があります。

テンプレートをインストールするには:

管理者権限でPowerShellを開きます。
次のコマンドを実行します。
RequestResponse
```
   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を開きます。
Internet Information Serverがポート443で実行されているかどうかを確認します。
RequestResponse
```
Get-Process -Id (Get-NetTCPConnection -LocalPort 443).OwningProcess
```
その場合は、停止する必要があります。
RequestResponse
```
iisreset /stop
```
Apache Solrまたはその他のサービスがポート8984で実行されているかどうかを確認します。
RequestResponse
```
Get-Process -Id (Get-NetTCPConnection -LocalPort 8984).OwningProcess
```
その場合は、停止する必要があります。
RequestResponse
```
Stop-Service -Name "<the name of your service>"
```
または、Non-Sucking Service Managerで開始した場合は、次のコマンドで停止します。
RequestResponse
```
nssm stop "<the name of your service>"
```
ソリューションフォルダーに移動し、MyProjectソリューションとプロジェクトを作成します。
RequestResponse
```
dotnet new sitecore.nextjs.gettingstarted -n MyProject
```
MyProjectフォルダに移動します。
Sitecoreコンテナ環境を準備するには、プロジェクトのルートディレクトリからスクリプトinit.ps1を実行します。
RequestResponse
```
.\init.ps1 -InitEnv -LicenseXmlPath "<C:\path\to\license.xml>" -AdminPassword "<desired password>"
```
Sitecore Dockerイメージをダウンロードし、コンテナとJSSアプリケーションをインストールして設定するには、次のスクリプトを実行します。
RequestResponse
```
.\up.ps1
```
プロンプトが表示されたら、ブラウザーでSitecoreにログインし、デバイスの認証を受け入れます。
スタートアップスクリプトがレンダリングされたサイトとSitecoreローンチパッドのブラウザータブを開くのを待ちます。

検索インデックスの再構築

スクリプト \docker\clean.ps1を実行した場合は、検索インデックスを再構築する必要があります。

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、