Sitecore ASP.NETレンダリングSDK(レガシー)

ウォークスルー

Version:

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

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

Sitecoreは、ASPやSitecoreコンテナでヘッドレス開発Sitecore試したいSitecore開発者向けの入門テンプレート.NET提供しています。これは、迅速に始めるためのものや、新しい顧客プロジェクトのキックスタートにも使えます。

このテンプレートはソリューションアーキテクチャの規範Sitecore Helix実装していません。Sitecoreソリューションの構築を始める際は、モジュール型ソリューションアーキテクチャの実装に関する指針としてSitecore HelixとSitecore Helix例をご確認することをお勧めします。

テンプレートには以下が含まれます:

Sitecore XP0トポロジーとASP.NETレンダリングホスト用のDocker環境。

!注付属のdocker-compose.ymlファイルは、Sitecoreコンテナサポートパッケージの標準XP0環境です。このソリューションのすべての変更はdocker-compose.override.ymlファイルに含まれています。
1ページのサンプルサイト用のシリアル化されたアイテム。詳細はsrc\Items.module.configファイルをご覧ください。
Platformという名前のMSBuildプロジェクトで、Sitecore Content Managementロールへの設定とコードをデプロイします。詳細はsrc\platformフォルダをご覧ください。
ASP.NETレンダリングホスト用のMSBuildプロジェクトRenderingHostです。詳細はsrc\renderingフォルダをご覧ください。

Getting Startedテンプレートから解答を作成するには、以下の手順を踏みます。

前提条件をインストール

テンプレートをインストールしてソリューションを作成する前に、以下のソフトウェアコンポーネントがワークステーションにインストールされていることを確認してください:

.NET Core 3.1 SDK (インストールされたバージョンを dotnet --version コマンドで確認してください)
.NET Framework 4.8 SDK ( .NET Frameworkバージョンを確認するためのMicrosoft手順を参照)
Visual Studio 2019
Windows用のDocker(Windowsコンテナを有効にした場合)
PowerShell 5.1 (PowerShell 7はサポートされていません)

システム要件の詳細については、Sitecoreコンテナのドキュメントをご覧ください。

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

テンプレートをダウンロードしてファイルシステムにインストールします。その後、テンプレートに基づいてソリューションを作成できます。

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

管理者権限でPowerShellを開いてください。
次のコマンドを実行します:

dotnet new -i Sitecore.DevEx.Templates --nuget-source https://nuget.sitecore.com/resources/v3/index.json

dotnetツールはインストールが成功したという明確なフィードバックを提供しません。しかし、インストールコマンドの最後にインストールされたすべてのテンプレートが一覧表示されます。インストールが成功した場合、リストにはsitecore.aspnet.gettingstartedが含まれています。

MyProjectソリューションの作成

解を好きなように呼んで構いませんが、この例では解をMyProjectと呼びます。

MyProject解を作成するには:

管理者権限でPowerShellを開いてください。
ポート443でInternet Information Serverが動いているか確認してください:

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.aspnet.gettingstarted -n MyProject
MyProject/フォルダに行ってください。
提供されたinit.ps1スクリプトを使って、Sitecoreコンテナ環境用の以下の項目を準備します。
- 有効で信頼できるワイルドカード証明書 *.myproject.localhost。
- ホストは myproject.localhostのエントリをファイルします。
- Sitecoreインスタンスの .env ファイル内の必要な環境変数の値。
!重要
- プロジェクトやフォルダ名に非ラテン文字を使うと、Dockerレジストリ名やURLの文字制限により予期せぬ結果が生じることがあります。
- これらの準備手順については、Sitecoreコンテナのドキュメントをご覧ください。
Sitecoreコンテナ環境の準備:

.\init.ps1 -InitEnv -LicenseXmlPath "<C:\path\to\license.xml>" -AdminPassword ""

ライセンスファイルの絶対的なパスを提供してください。

箱から出してみると、この例には.gitignoreファイル内の.envファイルへの参照が含まれていません。これは開発者が初期化された環境変数を共有できるようにするためです。.envファイルをソース管理にチェックインすると、他の開発者はinit.ps1スクリプトを実行するだけで証明書を作成し、ファイルエントリをホストできます。

Sitecoreソリューションやそのデータが機密性の高い場合は、.envファイルをソース管理から除外し、情報を中央で設定する別の手段を提供することを推奨します。
Sitecore Dockerイメージをダウンロードし、コンテナをインストールしてください:

.\up.ps1

テンプレートはWindows hostsファイル内に以下のエントリを作成します。それぞれがSitecoreコンテナを指しています:
- https://id.myproject.localhost/は、Identity ServerをホストするSitecoreインスタンスSitecoremyproject_id_1コンテナを指しています。
- https://cm.myproject.localhost/、Content Management、Content Delivery、SitecoreレイアウトサービスをホストするSitecoreインスタンスを備えたmyproject_cm_1コンテナを指しています。
- https://www.myproject.localhost/レンダリングホストがいるmyproject_rendering_1コンテナを指しています。
スクリプトがSitecore Identity Serverのブラウザタブを開くのを待ちます。その後ログインしてデバイス認証を受け入れます。
スクリプトがContent Managementとレンダリングホストのブラウザタブを開くのを待ちます。

MyProjectのソリューションをテストしてください

Getting Startedテンプレートのアイテムやプロジェクトの公開、実行、テスト方法をご覧ください。

!ヒントプロジェクト内のREADMEファイルと解決策を確認し、追加情報を確認してください。

この記事を改善するための提案がある場合は、お知らせください!