チュートリアル: 開始テンプレートの使用

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

このページの翻訳は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

前提条件のインストール

テンプレートをインストールしてソリューションを作成するには、次のソフトウェア コンポーネントをワークステーションにインストールする必要があります。

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

テンプレートのインストール

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

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

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

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

    RequestResponse
    dotnet 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 ソリューションを作成するには:

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

  2. ポート 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
    重要

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

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

  6. 次のスクリプトを実行して、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 (既定)、xm1xp1 です。

    スクリプトにより、次のアイテムが準備されます。

    • *.myproject.localhost 用の valid/trusted ワイルドカード証明書。

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

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

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

    RequestResponse
    .\up.ps1

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

    注記

    up.ps1 コマンドが失敗し、「実装されていません」というメッセージが表示された場合は、Docker for Windows の設定に移動し、実験的な Docker Compose V2 機能を無効にします。

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

  9. スクリプトが 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:

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

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