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

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

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

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

このテンプレートは、ソリューション アーキテクチャのSitecore Helix規則を実装していません。Sitecoreソリューションの構築を開始する際には、Sitecore HelixSitecore 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フォルダを参照してください。

「はじめに」テンプレートからソリューションを作成するには、以下の手順を実行します。

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

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

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

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

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

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

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

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

    RequestResponse
    dotnet new -i 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で実行されているかどうかを確認します。

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

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

    RequestResponse
    iisreset /stop
  3. Apache Solrまたはその他のサービスがポート8984で実行されているかどうかを確認します。

    RequestResponse
    Get-Process -Id (Get-NetTCPConnection -LocalPort 8984).OwningProcess

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

    RequestResponse
    Stop-Service -Name "<the name of your service>"

    または、Non-Sucking Service Managerで開始した場合は、次のコマンドで停止します。

    RequestResponse
    nssm stop "<the name of your service>"
  4. ソリューション フォルダーに移動し、MyProjectソリューションとプロジェクトを作成します。

    RequestResponse
    dotnet new sitecore.aspnet.gettingstarted -n MyProject
  5. MyProject/フォルダに移動します。

  6. 提供されている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ファイルをソース管理から除外し、内部の情報を一元的に設定する別の手段を提供することをお勧めします。

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

    RequestResponse
    .\up.ps1

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

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

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

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

先端

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、