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

ウォークスルー

Version:

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

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

!重要以前にアプリを統合していた場合、それは旧版のASP.NETコアレンダリングSDK(バージョン22以前)を使用しています。このSDKは更新を受け取っていないため、最新のバージョンへのアップグレードをお勧めします。

Sitecoreは、ASP .NET Sitecore SitecoreコンテナでHeadless Developmentを試したいSitecore開発者向けにGetting Startedテンプレートを提供していますHeadless Developmentを試すために。これを使えば、迅速に始めることも、新しい顧客プロジェクトを立ち上げるのにも役立ちます。

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

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

Docker環境でSitecoreトポロジー(デフォルトはXP0)を用いています。テンプレートにはXM1およびXP1トポロジーの設定も含まれています。

!注テンプレートにはサポートされているすべてのトポロジーに対応したdocker-composeファイルが含まれています。それらはrun\sitecore- フォルダ内で見つけることができます。例えば、run\sitecore-xm1\docker-compose.yml。付属のdocker-compose.ymlファイルは、Sitecore Container Support Packageの標準環境です。各トポロジーのdocker-compose.override.ymlファイルには、このソリューションのためにカスタマイズされた要素が含まれています。
ASP.NETレンダリングホストです。
1ページのサンプルサイト用のシリアル化されたアイテム。詳細はsrc\Items.module.configファイルをご覧ください。
Platformという名前のMSBuildプロジェクトで、Sitecore Content Managementロールへの設定とコードをデプロイします。詳細はsrc\platformフォルダをご覧ください。
ASP.NETレンダリングホスト用のMSBuildプロジェクトRenderingHostです。詳細はsrc\renderingフォルダをご覧ください。

Getting Startedテンプレートからソリューションを作成する前に、いくつかのソフトウェアコンポーネントをインストールし、テンプレートをインストールする必要があります。

このウォークスルーでは、以下の方法を説明します:

前提条件をインストール
テンプレートをインストールする
MyProjectソリューションの作成
MyProjectのソリューションをテストしてください
アプリケーションの展開

前提条件をインストール

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

.NET Core 6.0 SDK (インストールされているバージョンを dotnet --version コマンドで確認してください)
.NET Framework 4.8 SDK ( .NET Frameworkバージョンを確認するためのMicrosoft手順を参照)
Visual Studio 2022
Docker for Windows (Windows コンテナとCompose V2有効)
PowerShell 5.1 (インストール済みのバージョンを $PSVersionTable.PSVersion コマンドで確認してください。PowerShell 7はサポートされていません。)

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

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

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

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

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

dotnet new --install 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 "<NAME_OF_YOUR_SERVICE>"
- または、Non-Sucking Service Managerで起動している場合は、次のコマンドで停止してください:
  
  nssm stop "<NAME_OF_YOUR_SERVICE>"
ソリューションフォルダに行き、MyProjectソリューションとプロジェクトを作成してください:

dotnet new sitecore.aspnet.gettingstarted -n MyProject

!重要プロジェクト名やフォルダ名には必ずラテン文字を使用しなければなりません。Dockerのレジストリ名やURLの文字制限により、非ラテン文字を使うと予期せぬ結果が出ることがあります。
MyProject/フォルダに行ってください。
以下のスクリプトを実行してSitecoreコンテナ環境を準備します:

.\init.ps1 -InitEnv -LicenseXmlPath "<PATH_TO_YOUR_license.xml_FILE>" -AdminPassword "<YOUR_DESIRED_SITECORE_PASSWORD>" -Topology

ライセンスファイルの絶対パスを提供します。例: C:\license.xml

次のステップでここで指定したパスワードを使ってSitecore Identity Serverにログインします。

-Topologyパラメータは任意です。-Topologyパラメータのサポート値は、xp0(デフォルト)、xm1、xp1です。

スクリプトは以下の項目を準備します:
- 有効で信頼できるワイルドカード証明書 *.myproject.localhost。
- ホストは myproject.localhostのエントリをファイルします。
- 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とレンダリングホストのブラウザタブを開くのを待ちます。

アプリケーションは.gitignoreファイルに.envファイルの参照を含めていないため、開発者が初期化された環境変数を共有できます。.envファイルをソースコントロールにチェックインすると、他の開発者はinit.ps1スクリプトを実行するだけで証明書を作成し、ファイルエントリをhostsできます。

もしSitecoreソリューションやそのデータが機密性が高い場合は、.envファイルをソース管理から除外し、変数を中央で設定する他の手段を提供することをおすすめします。

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

ソリューションを作成した後は、コンテンツエディターで修正・公開し、Visual Studioでコードを修正・公開できます。

解を試すために:

Getting Startedテンプレートの公開、実行、テストの手順に従ってください。

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

アプリケーションの展開

Sitecore ASP.NETアプリケーションは他のASP.NETアプリケーションと同様に展開します。

アプリケーションを展開するには:

公式のMicrosoftドキュメントの手順に従ってください。

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