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

チュートリアル : Getting Startedテンプレートの使用

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

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

大事な

前に アプリを統合した場合は、従来の ASP.NET Core Rendering SDKバージョン22以前を使用しています。このSDKは更新を受け取っていないため、新しい の最新バージョンにアップグレードすることをお勧めします。

Sitecoreは、ASP.NET およびSitecoreコンテナでSitecoreヘッドレス開発を試してみたいSitecore開発者向けのGetting Startedテンプレートを提供します。これを使用して、すぐに開始したり、新しい顧客プロジェクトを開始したりできます。

このテンプレートは、ソリューション アーキテクチャの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 Container Support Packageの標準環境です。各トポロジのdocker-compose.override.ymlファイルには、このソリューション用に行われたカスタマイズが含まれています。

  • ASP.NETレンダリング ホスト。

  • 1ページのサンプル サイトのシリアル化されたアイテム。詳細については、src\Items.module.configファイルを参照してください。

  • Sitecore Content Managementロールに設定とコードをデプロイするためのPlatformという名前のMSBuildプロジェクト。詳細については、src\platformフォルダを参照してください。

  • ASP.NETレンダリング ホストのRenderingHostという名前のMSBuildプロジェクト。詳細については、src\renderingフォルダを参照してください。

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

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

  • 前提条件をインストールする

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

  • MyProjectソリューションを作成する

  • MyProjectソリューションをテストする

  • アプリケーションをデプロイする

前提条件をインストールする

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

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

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

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

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

  1. 管理者権限でPowerShellを開きます。

  2. 次のコマンドを実行します。

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

dotnetツールでは、インストールが成功したという明確なフィードバックは提供されません。ただし、インストール・コマンドは、インストールされているすべてのテンプレートをリストして終了します。インストールが成功すると、リストにはsitecore.aspnet.gettingstarted.

MyProjectソリューションを作成する

ソリューションには任意の名前を付けることができますが、この例では、ソリューションにMyProjectという名前を付けます。

MyProjectソリューションを作成するには:

  1. 管理者権限でPowerShellを開きます。

  2. Internet Information Serverがポート443で実行されているかどうかを確認します。

    Get-Process -Id (Get-NetTCPConnection -LocalPort 443).OwningProcess

    • その場合は、停止する必要があります。

      iisreset /stop

  3. 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>"

  4. ソリューション フォルダーに移動し、MyProjectソリューションとプロジェクトを作成します。

    dotnet new sitecore.aspnet.gettingstarted -n MyProject
    大事な

    プロジェクト/フォルダ名にはラテン文字を使用する必要があります。ラテン文字以外の文字を使用すると、Dockerレジストリ名とURLの文字数制限により、予期しない結果が生じる可能性があります。

  5. MyProject/フォルダに移動します。

  6. 次のスクリプトを実行して、Sitecoreコンテナー環境を準備します。

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

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

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

    -Topologyパラメーターはオプションです。-Topologyパラメーターでサポートされている値は、xp0 (デフォルト)、xm1、およびxp1です。

    このスクリプトでは、次の項目が用意されています。

    • *.myproject.localhostの有効/信頼できるワイルドカード証明書。

    • のhostsファイルエントリmyproject.localhost.

    • Sitecoreインスタンスの .envファイル内の必要な環境変数の値。

  7. Sitecore Dockerイメージをダウンロードし、コンテナーをインストールします。

    .\up.ps1

    テンプレートは、Windows hostsファイルに次のエントリを作成します。それぞれがSitecoreコンテナを指しています。

  8. スクリプトがSitecore Identity Serverのブラウザー タブを開くのを待ちます。次に、ログインしてデバイスの認証を受け入れます。

  9. スクリプトがContent Managementとレンダリング ホストのブラウザ タブを開くのを待ちます。

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

Sitecoreソリューションまたはそのデータが機密である場合は、.envファイルをソース管理から除外し、変数を一元的に設定する他の手段を提供することをお勧めします。

MyProjectソリューションをテストする

ソリューションを作成したら、コンテンツ エディターを使用してソリューションを変更および発行し、Visual Studioを使用してコードを変更および発行できます。

ソリューションをテストするには:

先端

アプリケーションをデプロイする

Sitecore ASP.NETアプリケーションは、他のASP.NETアプリケーションと同様にデプロイします。

アプリケーションをデプロイするには:

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