--- title: "ウォークスルー:はじめにテンプレートを使う" slug: "walkthrough--using-the-getting-started-template" abstract: "Getting Startedテンプレートを使って、初めてのSitecoreヘッドレス開発体験のためにSitecoreコンテナとレンダリングホストを素早くセットアップする方法。" --- # ウォークスルー:はじめにテンプレートを使う Sitecoreは[、ASP](https://dotnet.microsoft.com/apps/aspnet)や[Sitecoreコンテナ](https://containers.doc.sitecore.com/)でヘッド[レス開発Sitecore](https://doc.sitecore.com/xp/ja/developers/hd/19/sitecore-headless-development/headless-development-with-the-asp-net-rendering-sdk.html "Headless development with the ASP.NET Rendering SDK")試したいSitecore開発者向けの入門テンプレート.NET提供しています。これは、迅速に始めるためのものや、新しい顧客プロジェクトのキックスタートにも使えます。 このテンプレートはソリューションアーキテクチャの規範Sitecore Helix実装していません。Sitecoreソリューションの構築を始める際は、モジュール型ソリューションアーキテクチャの実装に関する指針として[Sitecore Helix](https://helix.sitecore.net/)と[Sitecore Helix例](https://sitecore.github.io/Helix.Examples/) をご確認することをお勧めします。 テンプレートには以下が含まれます: - [Sitecore](https://www.docker.com/) XP0トポロジーとASP.NETレンダリングホスト用のDocker環境。 > !注付属のdocker-compose.ymlファイルは、Sitecoreコンテナサポートパッケージの標準XP0環境です。このソリューションのすべての変更はdocker-compose.override.ymlファイルに含まれています。 - 1ページのサンプルサイト用のシリアル化されたアイテム。詳細はsrc\\Items.module.configファイルをご覧ください。 - Platformという名前の[MSBuild](https://docs.microsoft.com/en-us/visualstudio/msbuild/msbuild)プロジェクトで、Sitecore Content Managementロールへの設定とコードをデプロイします。詳細はsrc\\platformフォルダをご覧ください。 - ASP.NETレンダリングホスト用のMSBuildプロジェクトRenderingHostです。詳細はsrc\\renderingフォルダをご覧ください。 Getting Startedテンプレートから解答を作成するには、以下の手順を踏みます。 - [前提条件をインストール](https://doc.sitecore.com/xp/ja/developers/hd/19/sitecore-headless-development/walkthrough--using-the-getting-started-template.html#UUID-0e17cba4-ab28-8c72-0808-ee2fa1135617_section-idm231883998424798 "Install the prerequisites") - [テンプレートをインストールする](https://doc.sitecore.com/xp/ja/developers/hd/19/sitecore-headless-development/walkthrough--using-the-getting-started-template.html#UUID-0e17cba4-ab28-8c72-0808-ee2fa1135617_section-idm231884037534541 "Install the template") - [MyProjectソリューションの作成](https://doc.sitecore.com/xp/ja/developers/hd/19/sitecore-headless-development/walkthrough--using-the-getting-started-template.html#UUID-0e17cba4-ab28-8c72-0808-ee2fa1135617_section-idm231884002151201 "Create the MyProject solution") - [MyProjectのソリューションをテストしてください](https://doc.sitecore.com/xp/ja/developers/hd/19/sitecore-headless-development/walkthrough--using-the-getting-started-template.html#UUID-0e17cba4-ab28-8c72-0808-ee2fa1135617_section-idm231884014512248 "Test the MyProject solution") ## 前提条件をインストール テンプレートをインストールしてソリューションを作成する前に、以下のソフトウェアコンポーネントがワークステーションにインストールされていることを確認してください: - [.NET Core 3.1 SDK](https://dotnet.microsoft.com/download/dotnet-core/3.1) (インストールされたバージョンを dotnet --version コマンドで確認してください) - [.NET Framework 4.8 SDK](https://dotnet.microsoft.com/download/dotnet-framework/net48) ( [.NET Frameworkバージョンを確認するためのMicrosoft手順](https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed)を参照) - [Visual Studio 2019](https://visualstudio.microsoft.com/downloads/) - [Windows用のDocker(Windowsコンテナを有効にした場合)](https://docs.docker.com/docker-for-windows/install/) - [PowerShell 5.1](https://docs.microsoft.com/en-us/skypeforbusiness/set-up-your-computer-for-windows-powershell/download-and-install-windows-powershell-5-1) (PowerShell 7はサポートされていません) システム要件の詳細については、Sitecoreコンテナのドキュメントをご覧ください。 ## テンプレートをインストールする テンプレートをダウンロードしてファイルシステムにインストールします。その後、テンプレートに基づいてソリューションを作成できます。 テンプレートをインストールするには: 1. 管理者権限でPowerShellを開いてください。 2. 次のコマンドを実行します: 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. ポート443でInternet Information Serverが動いているか確認してください: 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 "" または、Non-Sucking Service Managerで起動している場合は、次のコマンドで停止してください: nssm stop "" 4. ソリューションフォルダに行き、MyProjectソリューションとプロジェクトを作成してください: dotnet new sitecore.aspnet.gettingstarted -n MyProject 5. MyProject/フォルダに行ってください。 6. 提供されたinit.ps1スクリプトを使って、Sitecoreコンテナ環境用の以下の項目を準備します。 - 有効で信頼できるワイルドカード証明書 \*.myproject.localhost。 - ホストは myproject.localhostのエントリをファイルします。 - Sitecoreインスタンスの .env ファイル内の必要な環境変数の値。 > !重要 > > - プロジェクトやフォルダ名に非ラテン文字を使うと、Dockerレジストリ名やURLの文字制限により予期せぬ結果が生じることがあります。 > > - これらの準備手順については、[Sitecoreコンテナのドキュメント](https://containers.doc.sitecore.com/) をご覧ください。 > Sitecoreコンテナ環境の準備: .\\init.ps1 -InitEnv -LicenseXmlPath "" -AdminPassword "" ライセンスファイルの絶対的なパスを提供してください。 箱から出してみると、この例には.gitignoreファイル内の.envファイルへの参照が含まれていません。これは開発者が初期化された環境変数を共有できるようにするためです。.envファイルをソース管理にチェックインすると、他の開発者はinit.ps1スクリプトを実行するだけで証明書を作成し、ファイルエントリをホストできます。 Sitecoreソリューションやそのデータが機密性の高い場合は、.envファイルをソース管理から除外し、情報を中央で設定する別の手段を提供することを推奨します。 7. Sitecore Dockerイメージをダウンロードし、コンテナをインストールしてください: .\\up.ps1 テンプレートはWindows hostsファイル内に以下のエントリを作成します。それぞれがSitecoreコンテナを指しています: - [https://id.myproject.localhost/](https://id.myproject.localhost/)は、[Identity Server](https://doc.sitecore.com/xp/en/developers/102/platform-administration-and-architecture/sitecore-identity-server.html)をホストするSitecoreインスタンスSitecoremyproject\_id\_1コンテナを指しています。 - [https://cm.myproject.localhost/](https://cm.myproject.localhost/)、[Content Management](https://doc.sitecore.com/xp/en/developers/102/platform-administration-and-architecture/content-management--cm-.html)、[Content Delivery](https://doc.sitecore.com/xp/en/developers/102/platform-administration-and-architecture/content-delivery--cd-.html)、[Sitecoreレイアウトサービスを](https://doc.sitecore.com/xp/ja/developers/hd/19/sitecore-headless-development/sitecore-layout-service.html "Sitecore Layout Service")ホストするSitecoreインスタンスを備えたmyproject\_cm\_1コンテナを指しています。 - [https://www.myproject.localhost/](https://www.myproject.localhost/)レンダリング[ホスト](https://doc.sitecore.com/xp/ja/developers/hd/19/sitecore-headless-development/headless-development-with-the-asp-net-rendering-sdk.html "Headless development with the ASP.NET Rendering SDK")がいるmyproject\_rendering\_1コンテナを指しています。 8. スクリプトが[Sitecore Identity Server](https://doc.sitecore.com/xp/en/developers/102/platform-administration-and-architecture/sitecore-identity-server.html)のブラウザタブを開くのを待ちます。その後ログインしてデバイス認証を受け入れます。 9. スクリプトがContent Managementとレンダリングホストのブラウザタブを開くのを待ちます。 ## MyProjectのソリューションをテストしてください [Getting Startedテンプレートのアイテムやプロジェクトの公開、実行、テスト](https://doc.sitecore.com/xp/ja/developers/hd/19/sitecore-headless-development/publish,-run,-and-test-the-getting-started-template-projects.md "Publish, run, and test the Getting Started template projects")方法をご覧ください。 > !ヒントプロジェクト内のREADMEファイルと解決策を確認し、追加情報を確認してください。