--- title: "ウォークスルー:はじめにテンプレートを使う" slug: "walkthrough--using-the-getting-started-template" abstract: "Getting Startedテンプレートを使って、初めてのSitecoreヘッドレス開発体験のためにSitecoreコンテナとレンダリングホストを素早くセットアップする方法。" --- # ウォークスルー:はじめにテンプレートを使う > !重要以前にアプリを統合していた場合、それは旧版のASP.NETコアレンダリングSDK(バージョン22以前)を使用しています。このSDKは更新を受け取っていないため、[最新のバージョンへのアップグレード](https://doc.sitecore.com/xmc/en/developers/asp-net/latest/asp-net-core-sdk/upgrade-from-v22.html) をお勧めします。 Sitecoreは[、ASP](https://dotnet.microsoft.com/apps/aspnet)[.NET Sitecore SitecoreコンテナでHeadless Development](https://doc.sitecore.com/xp/ja/developers/hd/21/sitecore-headless-development/headless-development-with-the-asp-net-rendering-sdk.html "Headless development with the ASP.NET Rendering SDK")を試したいSitecore開発者向けに*Getting Started*テンプレートを提供しています[Headless](https://containers.doc.sitecore.com/) Developmentを試すために。これを使えば、迅速に始めることも、新しい顧客プロジェクトを立ち上げるのにも役立ちます。 このテンプレートはソリューションアーキテクチャのSitecore Helix慣例を実装していません。Sitecoreソリューションの構築を始める際には、モジュール型ソリューションアーキテクチャの実装に関する指針として[Sitecore Helix](https://helix.sitecore.net/)と[Sitecore Helix](https://sitecore.github.io/Helix.Examples/)例の確認をお勧めします。 テンプレートには以下が含まれます: - [Docker](https://www.docker.com/)環境で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](https://docs.microsoft.com/en-us/visualstudio/msbuild/msbuild)プロジェクトで、Sitecore Content Managementロールへの設定とコードをデプロイします。詳細はsrc\\platformフォルダをご覧ください。 - ASP.NETレンダリングホスト用のMSBuildプロジェクトRenderingHostです。詳細はsrc\\renderingフォルダをご覧ください。 *Getting Started*テンプレートからソリューションを作成する前に、いくつかのソフトウェアコンポーネントをインストールし、テンプレートをインストールする必要があります。 このウォークスルーでは、以下の方法を説明します: - 前提条件をインストール - テンプレートをインストールする - MyProjectソリューションの作成 - MyProjectのソリューションをテストしてください - アプリケーションの展開 ## 前提条件をインストール テンプレートをインストールしてソリューションを作成する前に、以下のソフトウェアコンポーネントをワークステーションにインストールしてください: - [.NET Core 6.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) (インストールされているバージョンを 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 2022](https://visualstudio.microsoft.com/downloads/) - [Docker for Windows](https://docs.docker.com/docker-for-windows/install/) (Windows コンテナとCompose V2有効) - [PowerShell 5.1](https://docs.microsoft.com/en-us/skypeforbusiness/set-up-your-computer-for-windows-powershell/download-and-install-windows-powershell-5-1) (インストール済みのバージョンを $PSVersionTable.PSVersion コマンドで確認してください。PowerShell 7はサポートされていません。) システム要件の詳細については、[Sitecoreコンテナの](https://doc.sitecore.com/xp/en/developers/103/developer-tools/containers-in-sitecore-development.html) ドキュメントをご覧ください。 ## テンプレートをインストールする テンプレートをダウンロードしてファイルシステムにインストールします。その後、テンプレートに基づいてソリューションを作成できます。 テンプレートをインストールするには: 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. ポート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 > !重要プロジェクト名やフォルダ名には必ずラテン文字を使用しなければなりません。Dockerのレジストリ名やURLの文字制限により、非ラテン文字を使うと予期せぬ結果が出ることがあります。 5. MyProject/フォルダに行ってください。 6. 以下のスクリプトを実行してSitecoreコンテナ環境を準備します: .\\init.ps1 -InitEnv -LicenseXmlPath "" -AdminPassword "" -Topology ライセンスファイルの絶対パスを提供します。例: C:\\license.xml 次のステップでここで指定したパスワードを使ってSitecore Identity Serverにログインします。 \-Topologyパラメータは任意です。\-Topologyパラメータのサポート値は、xp0(デフォルト)、xm1、xp1です。 スクリプトは以下の項目を準備します: - 有効で信頼できるワイルドカード証明書 \*.myproject.localhost。 - ホストは myproject.localhostのエントリをファイルします。 - 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/103/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/103/platform-administration-and-architecture/content-management--cm-.html)、[Content Delivery](https://doc.sitecore.com/xp/en/developers/103/platform-administration-and-architecture/content-delivery--cd-.html)、[Sitecoreレイアウトサービスを](https://doc.sitecore.com/xp/ja/developers/hd/21/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/21/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/103/platform-administration-and-architecture/sitecore-identity-server.html)のブラウザタブを開くのを待ちます。その後ログインしてデバイス認証を受け入れます。 9. スクリプトがContent Managementとレンダリングホストのブラウザタブを開くのを待ちます。 アプリケーションは.gitignoreファイルに.envファイルの参照を含めていないため、開発者が初期化された環境変数を共有できます。.envファイルをソースコントロールにチェックインすると、他の開発者はinit.ps1スクリプトを実行するだけで証明書を作成し、ファイルエントリをhostsできます。 もしSitecoreソリューションやそのデータが機密性が高い場合は、.envファイルをソース管理から除外し、変数を中央で設定する他の手段を提供することをおすすめします。 ## MyProjectのソリューションをテストしてください ソリューションを作成した後は、コンテンツエディターで修正・公開し、Visual Studioでコードを修正・公開できます。 解を試すために: - [Getting Startedテンプレートの公開、実行、テスト](https://doc.sitecore.com/xp/ja/developers/hd/21/sitecore-headless-development/publish,-run,-and-test-the-getting-started-template-projects.md "Publish, run, and test the Getting Started template projects")の手順に従ってください。 > !ヒントプロジェクト内のREADMEファイルと解決策を確認し、追加情報を確認してください。 ## アプリケーションの展開 Sitecore ASP.NETアプリケーションは他のASP.NETアプリケーションと同様に展開します。 アプリケーションを展開するには: - [公式のMicrosoftドキュメント](https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/?view=aspnetcore-6.0)の手順に従ってください。