チュートリアル : Getting Startedテンプレートの使用
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecoreは、ASP.NET コンテナとSitecoreコンテナでSitecoreヘッドレス開発を試してみたいSitecore開発者向けのGetting Startedテンプレートを提供しています。これを使用して、迅速に開始したり、新しい顧客プロジェクトを開始したりできます。
このテンプレートは、ソリューション アーキテクチャのSitecore Helix規則を実装していません。Sitecoreソリューションの構築を開始する際には、Sitecore HelixとSitecore Helixの例 を確認して、モジュラー ソリューション アーキテクチャの実装に関するガイダンスを確認することをお勧めします。
テンプレートには次のものが含まれます。
-
ASP.NETレンダリング ホストを備えたSitecore XP0トポロジのDocker環境。
メモ含まれているdocker-compose.ymlファイルは、Sitecore Container Support PackageのストックXP0環境です。このソリューションのすべての変更は、docker-compose.override.ymlファイルに含まれています。
-
1ページのサンプル サイトのシリアル化されたアイテム。詳細については、src\Items.module.configファイルを参照してください。
-
Sitecore Content Managementロールに設定とコードをデプロイするためのPlatformという名前のMSBuildプロジェクト。詳細については、src\platformフォルダを参照してください。
-
ASP.NETレンダリング ホストのRenderingHostという名前のMSBuildプロジェクト。詳細については、src\renderingフォルダを参照してください。
「はじめに」テンプレートからソリューションを作成するには、以下の手順を実行します。
前提条件をインストールする
テンプレートをインストールしてソリューションを作成する前に、ワークステーションに次のソフトウェア コンポーネントがインストールされていることを確認してください。
-
.NET Core 3.1 SDK ( dotnet --versionコマンドでインストールされているバージョンを確認してください)
-
.NET Framework 4.8 SDK ( .NET Frameworkのバージョンを確認するためのMicrosoftの手順を参照)
-
Docker for Windows ( Windowsコンテナが有効)
-
PowerShell 5.1 (PowerShell 7はサポートされていません)
システム要件の詳細については、Sitecoreコンテナのドキュメント を参照してください。
テンプレートをインストールする
テンプレートをダウンロードして、ファイルシステムにインストールします。その後、テンプレートに基づいてソリューションを作成できます。
テンプレートをインストールするには:
-
管理者権限でPowerShellを開きます。
-
次のコマンドを実行します。
RequestResponsedotnet new -i Sitecore.DevEx.Templates --nuget-source https://nuget.sitecore.com/resources/v3/index.json
dotnetツールでは、インストールが成功したという明確なフィードバックは提供されません。ただし、インストール・コマンドは、インストールされているすべてのテンプレートをリストして終了します。インストールが成功すると、リストにはsitecore.aspnet.gettingstarted.
MyProjectソリューションを作成する
ソリューションには任意の名前を付けることができますが、この例では、ソリューションにMyProjectという名前を付けます。
MyProjectソリューションを作成するには:
-
管理者権限でPowerShellを開きます。
-
Internet Information Serverがポート443で実行されているかどうかを確認します。
RequestResponseGet-Process -Id (Get-NetTCPConnection -LocalPort 443).OwningProcess
その場合は、停止する必要があります。
RequestResponseiisreset /stop
-
Apache Solrまたはその他のサービスがポート8984で実行されているかどうかを確認します。
RequestResponseGet-Process -Id (Get-NetTCPConnection -LocalPort 8984).OwningProcess
その場合は、停止する必要があります。
RequestResponseStop-Service -Name "<the name of your service>"
または、Non-Sucking Service Managerで開始した場合は、次のコマンドで停止します。
RequestResponsenssm stop "<the name of your service>"
-
ソリューション フォルダーに移動し、MyProjectソリューションとプロジェクトを作成します。
RequestResponsedotnet new sitecore.aspnet.gettingstarted -n MyProject
-
MyProject/フォルダに移動します。
-
提供されているinit.ps1スクリプトを使用して、Sitecoreコンテナ環境用に次のアイテムを準備します。
-
*.myproject.localhostの有効/信頼できるワイルドカード証明書。
-
のhostsファイルエントリmyproject.localhost.
-
Sitecoreインスタンスの .envファイル内の必要な環境変数の値。
大事な-
プロジェクト/フォルダ名にラテン文字以外の文字を使用すると、Dockerレジストリ名とURLの文字制限により、予期しない結果が生じる可能性があります。
-
これらの準備手順の詳細については、Sitecoreコンテナのドキュメント を参照してください。
Sitecoreコンテナ環境を準備するには:
RequestResponse.\init.ps1 -InitEnv -LicenseXmlPath "<C:\path\to\license.xml><path to your license.xml file>" -AdminPassword "<your Sitecore administrator password>"
ライセンスファイルの絶対パスを指定します。
初期設定では、この例では .gitignoreファイルに .envファイルへの参照は含まれていません。これは、開発者が初期化された環境変数を共有できるようにするためです。.envファイルをソース管理にチェックインすると、他の開発者はinit.ps1スクリプトを実行するだけで、証明書とホスト ファイル エントリを準備できます。
Sitecoreソリューションやそのデータが機密である場合は、.envファイルをソース管理から除外し、内部の情報を一元的に設定する別の手段を提供することをお勧めします。
-
-
Sitecore Dockerイメージをダウンロードし、コンテナーをインストールします。
RequestResponse.\up.ps1
テンプレートは、Windows hostsファイルに次のエントリを作成します。それぞれがSitecoreコンテナを指しています。
-
https://id.myproject.localhost/ は、Sitecore Identity ServerをホストしているSitecoreインスタンスを含むmyproject_id_1コンテナーを指しています。
-
https://cm.myproject.localhost/、Content Management、Content Delivery、Sitecore Layout ServiceをホストするSitecoreインスタンスを含むmyproject_cm_1コンテナーを指しています。
-
https://www.myproject.localhost/、レンダリング ホストを含むmyproject_rendering_1コンテナを指します。
-
-
スクリプトがSitecore Identity Serverのブラウザー タブを開くのを待ちます。次に、ログインしてデバイスの認証を受け入れます。
-
スクリプトがContent Managementとレンダリング ホストのブラウザ タブを開くのを待ちます。