チュートリアル: 開始テンプレートの使用
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore は、ASP.NET および Sitecore コンテナーを使用した Sitecore ヘッドレス開発を試す Sitecore 開発者向けに開始テンプレートを提供します。このテンプレートを使用して、開発をすばやく始めたり、新しい顧客プロジェクトを開始したりすることができます。
このテンプレートは、ソリューション アーキテクチャ向けの Sitecore Helix 規則を実装していません。Sitecore ソリューションの構築を始めるときに、Sitecore Helix および Sitecore Helix の例で、モジュラー ソリューション アーキテクチャの実装に関するガイダンスを確認することをお勧めします。
テンプレートには次のものが含まれます。
-
Sitecore トポロジ (既定は XP0) の Docker 環境。テンプレートには XM1 トポロジと XP1 トポロジの設定も含まれています。
注記テンプレートには、サポートされているトポロジごとの
docker-compose
ファイルが含まれています。これらはrun\sitecore-<topology>
フォルダーにあります。たとえば、run\sitecore-xm1\docker-compose.yml
です。含まれているdocker-compose.yml
ファイルは、Sitecore コンテナー サポート パッケージの標準環境です。各トポロジのdocker-compose.override.yml
ファイルに、このソリューション用に作成されたカスタマイズが含まれています。 -
ASP.NET レンダリング ホスト。
-
1 ページのサンプル サイト用のシリアル化されたアイテム。詳細については、
src\Items.module.config
ファイルを参照してください。 -
Sitecore Content Management ロールに設定とコードをデプロイするための
Platform
と名前が付けられた MSBuild プロジェクト。詳細については、src\platform
フォルダーを参照してください。 -
ASP.NET レンダリング ホスト用の
RenderingHost
と名前が付けられた MSBuild プロジェクト。詳細については、src\rendering
フォルダーを参照してください。
開始テンプレートからソリューションを作成するには、いくつかのソフトウェア コンポーネントをインストールし、テンプレートをインストールする必要があります。
このチュートリアルでは、以下の方法について説明します。
-
前提条件のインストール
-
テンプレートのインストール
-
MyProject ソリューションの作成
-
MyProject ソリューションのテスト
-
[en] Deploy the application
前提条件のインストール
テンプレートをインストールしてソリューションを作成するには、次のソフトウェア コンポーネントをワークステーションにインストールする必要があります。
-
.NET Core 6.0 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://sitecore.myget.org/F/sc-packages/api/v3/index.json
dotnet
ツールは、インストールが成功したことを示す明らかなフィードバックを表示しません。ただし、インストール コマンドは、インストールされたすべてのテンプレートを一覧表示して終了します。インストールが成功した場合、一覧には sitecore.aspnet.gettingstarted
が含まれます。
MyProject ソリューションの作成
ソリューションには任意の名前を付けることができますが、この例ではソリューションに MyProject
と名前を付けます。
MyProject
ソリューションを作成するには:
-
管理者権限で PowerShell を開きます。
-
ポート 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
重要プロジェクト名またはフォルダー名には、ラテン文字を使用する必要があります。ラテン文字以外の文字を使用すると、Docker レジストリ名と URL の文字制限により、予期しない結果が生じる可能性があります。
-
MyProject/
フォルダーに移動します。 -
次のスクリプトを実行して、Sitecore コンテナー環境を準備します。
RequestResponse.\init.ps1 -InitEnv -LicenseXmlPath "<C:\path\to\license.xml><path to your license.xml file>" -AdminPassword "<your Sitecore administrator password>" -Topology <topology>
[en] You must provide an absolute path for the license file.
-Topology
パラメーターはオプションです。-Topology
パラメーターでサポートされている値はxp0
(既定)、xm1
、xp1
です。スクリプトにより、次のアイテムが準備されます。
-
*.myproject.localhost
用の valid/trusted ワイルドカード証明書。 -
myproject.localhost
用の hosts ファイル エントリ。 -
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 レイアウト サービスをホストする Sitecore インスタンスを含むmyproject_cm_1
コンテナーを指します。 -
https://www.myproject.localhost/
は、レンダリング ホストを含むmyproject_rendering_1
コンテナーを指します。
注記up.ps1
コマンドが失敗し、「実装されていません」というメッセージが表示された場合は、Docker for Windows の設定に移動し、実験的な Docker Compose V2 機能を無効にします。 -
-
スクリプトが Sitecore Identity Server をブラウザー タブで開くまで待ち、ログインしてデバイス認証を受け入れます。
-
スクリプトが Content Management とレンダリング ホストをブラウザー タブで開くまで待ちます。
アプリケーションには .gitignore
ファイル内の .env
ファイルへの参照が含まれていないため、開発者は初期化された環境変数を共有できます。.env
ファイルをソース管理にチェックインすると、他の開発者は、init.ps1
スクリプトを実行するだけで証明書や hosts
ファイル エントリを準備できます。
Sitecore ソリューション自体やそのデータが機密である場合、ソース管理から .env
ファイルを除外し、変数を一元的に設定する別の方法を検討してください。
MyProject ソリューションのテスト
ソリューションを作成したら、コンテンツ エディターを使用してソリューションの変更とパブリッシュを行い、Visual Studio を使用してコードの変更とパブリッシュを行うことができます。
ソリューションをテストするには:
-
開始テンプレートをパブリッシュ、実行、テストする手順に従います。
[en] Deploy the application
[en] You deploy a Sitecore ASP.NET application like any other ASP.NET application.
[en] To deploy the application:
-
[en] Follow the steps in the official Microsoft documentation.