Sitecore on Azureを使用したデプロイ

チュートリアル: 新しいSitecore環境をMicrosoft Azure App Serviceにデプロイする

Version:

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

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

このチュートリアルを使用して、ソリューションに適した構成を設定し、認証証明書を準備し、環境テンプレートを構成し、検索プロバイダーをデプロイし、プロビジョニングを開始します。

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

Sitecoreの設定

Sitecoreを設定するには、Sitecoreソリューションに適した適切な設定を使用する必要があります。Sitecoreバージョン9.0は、デフォルトで次のSitecore設定をサポートしています。

構成	形容
XP Single	これは、以下を実行するSitecore Experience Platform設定です。 Sitecore IDサーバー。 Sitecoreの4つのロール:Content Delivery、Content Management、処理、レポートを1つのWebAppインスタンスとして。 5つのxConnectロール:Search、Collection、Reference Data、Marketing Automation、Marketing Automation Reportingを1つのWebAppインスタンスとして。この構成は、開発とテストに使用します。セキュリティとスケーラビリティの理由から、実稼働環境ではXMまたはXP構成を使用することをお勧めします。
XP Scaled	これは、以下を実行するSitecore Experience Platform設定です。 Sitecore IDサーバー。 Sitecoreの4つのロール:Content Delivery、Content Management、Processing、レポート 5つのxConnectロール:Search、Collection、Reference Data、Marketing Automation、Marketing Automation Reporting. この環境は、フル機能のSitecore Experience Platformのインストールを計画している場合に使用します。
XM Single	これは、以下を実行するSitecore Experience Management設定です。 Sitecore IDサーバー。 Content DeliveryとContent Management の両方のロールは、1つのWebAppインスタンスとして機能します。この設定は、Sitecore Experience PlatformのAnalytics 機能とMarketing 機能 (つまり、CMS専用モード) を使用する予定がない場合の開発とテストに使用します。
XM Scaled	これは、以下を実行するSitecore Experience Management設定です。 Sitecore IDサーバー。 Content DeliveryロールとContent Managementロールの両方。 Sitecore Experience PlatformのAnalytics 機能とMarketing 機能 (つまり、CMS専用モード) を使用する予定がない場合に、この環境を使用します。
xDB Single	これは、以下を実行するSitecore Experience Database設定です。 2つのSitecoreロール:Processing とReporting を1つのWebAppインスタンスとして使用します。 5つのxConnectロール:Search、Collection、Reference Data、Marketing Automation、Marketing Automation Reportingを1つのWebAppインスタンスとして。この設定は、開発とテストに使用し、オンプレミスのSitecore XMインストールと組み合わせてエクスペリエンスデータベース機能を提供します。
xDB Scaled	これは、以下を実行するSitecore Experience Database設定です。 Sitecoreの2つのロール:ProcessingとReporting。 5つのxConnectロール:Search、Collection、Reference Data、Marketing Automation、Marketing Automation Reporting。この環境をオンプレミスのSitecore XMインストールと組み合わせて使用し、Experience Database機能を提供します。

トポロジ、サイジング、デプロイする環境のタイプを計画する場合は、ドキュメントサイトのSitecore Azure Toolkitドキュメントを参照してください。

認証証明書を準備する

認証証明書を準備するには:

Sitecore 9.0のデプロイを開始する前に、認証証明書を取得または生成し、PKCS #12形式 (.pfx) で保存する必要があります。

メモ

XConnectには、デフォルトで有効なトラストチェーンを持つクライアント認証証明書が必要です。制限により、Azure App Serviceでは、証明書のルート証明書がグローバルに信頼された証明機関によって発行されている場合にのみ、証明書に有効な信頼チェーンを設定できません。
自己署名証明書、またはプライベート認証局 (Active Directory証明書サービスなど) によって発行された証明書を使用する場合は、allowInvalidClientCertificatesパラメータをtrue に設定し、次のようにazuredeploy.parameters.jsonファイルを拡張する必要があります。
"allowInvalidClientCertificates": { "value": true }
パラメータファイルとその拡張方法の詳細については、次のセクションのステップ4で説明します。

環境テンプレートをダウンロードして構成する

計画したSitecore設定の環境テンプレートをダウンロードして設定するには:

GitHubリポジトリに移動し、選択したSitecoreの設定とバージョンのテンプレートを見つけます (例: フォルダー: Sitecore 9.0、サブフォルダー: xp)。
選択した構成とバージョンの適切なサブフォルダで、azuredeploy.jsonファイルを特定します。これは、デプロイプロセス中に使用するメインのARMテンプレートです。このファイルの未加工のURLをGitHubから取得するには、ファイルを選択し、Rawをクリックします。ファイルが新しいブラウザウィンドウで開きます。アドレスバーから直接URLをコピーし、後で使用するためにこれをメモしておきます。
選択した構成とバージョンに関連するサブフォルダで、azuredeploy.parameters.jsonファイルを特定してダウンロードします。デプロイプロセスを制御するために、ARMテンプレートはこのファイルを使用してパラメーターを渡します。

ファイルをローカルに保存し、関連する表に記載されている設定に従って、ファイル内のパラメータを入力します。

XPシングル

パラメーター	形容
location	現在のデプロイの地理的リージョン。
sqlServerLogin	Azure SQL Server用に作成される管理者アカウントの名前。
sqlServerPassword	Azure SQL Server用に作成されている管理者アカウントのパスワード。
sitecoreAdminPassword	XPのインスタンスの管理者アカウントのパスワード。
singleMsDeployPackageUrl	Sitecore XP Single Web Deploymentパッケージ (WDP) のHTTP(s) URL。
xcSingleMsDeployPackageUrl	XConnectシングルWDPのHTTP(s) URL。
siMsDeployPackageUrl	Sitecore Identity Server WDPのHTTP(s) URL。
authCertificateBlob	PKCS #12形式 (.pfx) の認証証明書のBase64でエンコードされたBLOB 。エンコード手順については、次のセクションのデプロイメント・コマンドの例を参照してください。
authCertificatePassword	認証証明書のパスワード。
templateLinkAccessToken	ネストされたインフラストラクチャー・テンプレートとアプリケーション・テンプレートのアクセス・トークン。たとえば、Azure Storage Explorerでは、テンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。

XPスケーリング

パラメーター	形容
location	現在のデプロイの地理的リージョン。
sqlServerLogin	Azure SQL Server用に作成される管理者アカウントの名前。
sqlServerPasswordの	Azure SQL Server用に作成されている管理者アカウントのパスワード。
sitecoreAdminPassword	XPのインスタンスの管理者アカウントのパスワード。
repAuthenticationApiKey	GUIDなどの一意の値。これは、Content ManagementロールからレポートWebアプリへの通信時に認証に使用されます。必要な最小長は32文字です。
cmMsDeployPackageUrl	Sitecore XP Content Management Web Deployパッケージ (WDP) のHTTP(s) URL。
cdMsDeployPackageUrl	Sitecore XP Content Delivery WDPのHTTP(s) URL。
prcMsDeployPackageUrl	Sitecore XP処理WDPのHTTP(s) URL。
repMsDeployPackageUrl	Sitecore XP Reporting WDPのHTTP(s) URL。
xcRefDataMsDeployPackageUrl	XConnect Reference Data Service WDPのHTTP(s) URL。
xcCollectMsDeployPackageUrl	XConnect Collection Service WDPのHTTP(s) URL。
xcSearchMsDeployPackageUrl	XConnect Collection SearchサービスWDPのHTTP(s) URL。
maOpsMsDeployPackageUrl	マーケティングオートメーションサービスWDPのHTTP(s) URL。
maRepMsDeployPackageUrl	マーケティングオートメーションレポートサービスWDPのHTTP(s)URL。
siMsDeployPackageUrl	Sitecore Identity Server WDPのHTTP(s) URL。
authCertificateBlob	PKCS #12形式 (.pfx) の認証証明書のBase64でエンコードされたBLOB 。エンコード手順については、次のセクションのデプロイメント・コマンドの例を参照してください。
authCertificatePassword	認証証明書のパスワード。
templateLinkAccessToken	ネストされたインフラストラクチャー・テンプレートとアプリケーション・テンプレートのアクセス・トークン。たとえば、Azure Storage Explorerでは、テンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。

XMシングル

パラメーター	形容
location	現在のデプロイの地理的リージョン。
sqlServerLogin	Azure SQL Server用に作成される管理者アカウントの名前。
sqlServerPassword	Azure SQL Server用に作成されている管理者アカウントのパスワード。
sitecoreAdminPassword	XMのインスタンスの管理者アカウントのパスワード。
singleMsDeployPackageUrl	Sitecore XM Singleデプロイメントパッケージ (WDP) のHTTP(s) URL。
siMsDeployPackageUrl	Sitecore Identity Server WDPのHTTP(s) URL。
authCertificateBlob	PKCS #12形式 (.pfx) の認証証明書のBase64でエンコードされたBLOB 。エンコード手順については、次のセクションのデプロイメント・コマンドの例を参照してください。
authCertificatePassword	認証証明書のパスワード。
templateLinkAccessToken	ネストされたインフラストラクチャー・テンプレートとアプリケーション・テンプレートのアクセス・トークン。たとえば、Azure Storage Explorerでは、テンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。

XMスケール

パラメーター	形容
location	現在のデプロイの地理的リージョン。
sqlServerLogin	Azure SQL Server用に作成される管理者アカウントの名前。
sqlServerPassword	Azure SQL Server用に作成されている管理者アカウントのパスワード。
sitecoreAdminPassword	XMのインスタンスの管理者アカウントのパスワード。
cmMsDeployPackageUrl	Sitecore XM Content Managementデプロイメントパッケージ (WDP) へのHTTP(s) URL。
cdMsDeployPackageUrl	Sitecore XMコンテンツ配信WDPのHTTP(s) URL。
siMsDeployPackageUrl	Sitecore Identity Server WDPのHTTP(s) URL。
authCertificateBlob	PKCS #12形式 (.pfx) の認証証明書のBase64でエンコードされたBLOB 。エンコード手順については、次のセクションのデプロイメント・コマンドの例を参照してください。
authCertificatePassword	認証証明書のパスワード。
templateLinkAccessToken	ネストされたインフラストラクチャー・テンプレートとアプリケーション・テンプレートのアクセス・トークン。たとえば、Azure Storage Explorerでは、テンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。

xDBシングル

パラメーター	形容
location	現在のデプロイの地理的リージョン。
sqlServerLogin	Azure SQL Server用に作成される管理者アカウントの名前。
sqlServerPassword	Azure SQL Server用に作成されている管理者アカウントのパスワード。
sitecoreAdminPassword	XPのインスタンスの管理者アカウントのパスワード。
singleMsDeployPackageUrl	Sitecore xDB Single Web Deploymentパッケージ (WDP) のHTTP(s) URL。
xcSingleMsDeployPackageUrl	XConnect Single (WDP) のHTTP(s) URL。
authCertificateBlob	PKCS #12形式 (.pfx) の認証証明書のBase64でエンコードされたBLOB 。エンコード手順については、次のセクションのデプロイメント・コマンドの例を参照してください。
authCertificatePassword	認証証明書のパスワード。
templateLinkAccessToken	ネストされたインフラストラクチャー・テンプレートとアプリケーション・テンプレートのアクセス・トークン。たとえば、Azure Storage Explorerでは、テンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。

xDBのスケーリング

パラメーター	形容
location	現在のデプロイの地理的リージョン。
sqlServerLogin	Azure SQL Server用に作成される管理者アカウントの名前。
sqlServerPassword	Azure SQL Server用に作成されている管理者アカウントのパスワード。
sitecoreAdminPassword	XPのインスタンスの管理者アカウントのパスワード。
repAuthenticationApiKey	GUIDなどの一意の値。これは、Content ManagementロールからレポートWebアプリへの通信時に認証に使用されます。必要な最小長は32文字です。
prcMsDeployPackageUrl	Sitecore xDB Processing WDPのHTTP(s) URL。
repMsDeployPackageUrl	Sitecore xDBレポートWDPのHTTP(s) URL。
xcRefDataMsDeployPackageUrl	XConnect Reference Data Service WDPのHTTP(s) URL。
xcCollectMsDeployPackageUrl	XConnect Collection Service WDPのHTTP(s) URL。
xcSearchMsDeployPackageUrl	XConnect Collection SearchサービスWDPのHTTP(s) URL。
maOpsMsDeployPackageUrl	マーケティングオートメーションサービスWDPのHTTP(s) URL。
maRepMsDeployPackageUrl	マーケティングオートメーションレポートサービスWDPのHTTP(s)URL。
authCertificateBlob	PKCS #12形式 (.pfx) の認証証明書のBase64でエンコードされたBLOB 。エンコード手順については、次のセクションのデプロイメント・コマンドの例を参照してください。
authCertificatePassword	認証証明書のパスワード。
templateLinkAccessToken	ネストされたインフラストラクチャー・テンプレートとアプリケーション・テンプレートのアクセス・トークン。たとえば、Azure Storage Explorerでは、テンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。

必要に応じて、で宣言された任意のパラメータを使用してazuredeploy.parameters.jsonファイルを拡張して、追加のパラメータを追加することもできますazuredeploy.json各Sitecore環境設定のルートフォルダーにあるREADME.mdファイルには、追加情報が表示されます。

手記

azuredeploy.parameters.jsonファイルにはsiMsDeployPackageUrlが含まれていますが、Sitecore Identityパッケージはデフォルトでは含まれていないため、別途ダウンロードする必要があります。
スケーリングされたトポロジ (XP、XM、XDB) のsitecoreSKUパラメーターのデフォルトの "Extra Small" 値を上書きし、"Small"、"Medium"、"Large"、"Extra Large" に変更できます。たとえば、Mediumに変更するには、次のコマンドを使用します。
"sitecoreSKU": { "value": "Medium" }

Solrを検索プロバイダーとしてデプロイ

Azure Cognitive Searchは、Azureデプロイの既定のプロバイダーです。Azure Cognitive Searchの代わりにSolrを使用することを選択できます。SolrサーバーはARMテンプレートによってプロビジョニングされないため、Azureにデプロイした後、テンプレートを手動で作成し、Solrコアを設定する必要があります。Azure Cognitive SearchリソースがプロビジョニングされていないときにSolrサーバーを使用するには、次の表のパラメーターを渡します。

XM ScaledとXM Single

パラメーター	形容
solrConnectionString	Sitecore Platformロールに渡される既存のSolrサーバーへの接続文字列。

XPスケーリング

パラメーター	形容
solrConnectionString	Sitecore Platformロールに渡される既存のSolrサーバーへの接続文字列。
xcSearchMsDeployPackageUrl	Solr XConnect Search WebデプロイパッケージへのBLOBストレージ (HTTPS) URL。
xcSolrConnectionString	(オプション)XConnectロールに渡される既存のSolrサーバーへの接続文字列。このパラメータを指定しない場合、デフォルト値はsolrConnectionStringになります。

XPシングル

パラメーター	形容
solrConnectionString	Sitecore Platformロールに渡される既存のSolrサーバーへの接続文字列。
xcSolrConnectionString	(オプション)XConnectロールに渡される既存のSolrサーバーへの接続文字列。このパラメータを指定しない場合、デフォルト値はsolrConnectionStringになります。
xcSingleMsDeployPackageUrl	Solr XConnect Single WebデプロイパッケージへのHTTP(s) URL。

xDBのスケーリング

パラメーター	形容
xcsolrConnectionString	XConnectロールに渡される既存のSolrサーバーへの接続文字列。このパラメータを指定しない場合、デフォルト値はsolrConnectionStringです。
xcSearchMsDeployPackageUrl	Solr XConnect Search WebデプロイパッケージへのHTTPS URL。

xDBシングル

パラメーター	形容
xcsolrConnectionString	XConnectロールに渡される既存のSolrサーバーへの接続文字列。
xcSingleMsDeployPackageUrl	Solr XConnect SingleWebデプロイパッケージへのHTTP(s) URL

デプロイメント・コマンドを呼び出し、プロビジョニングを開始します

PowerShellコマンドを呼び出してプロビジョニングを開始するには:

手記

SATバージョン2.5を使用する場合は、デプロイメント・コマンドの呼び出しとSAT 2.5を使用したプロビジョニングの開始のセクションを参照してください。

PowerShellのSitecore Azure Toolkitフォルダーに、Sitecore Azure Toolkitモジュール (Import-Module .\tools\Sitecore.Cloud.Cmdlets.psm1.
PowerShellセッションにAzureアカウントAdd-AzureRMAccountを追加します。
複数のサブスクリプションにアクセスできる場合は、デプロイ先のサブスクリプション (Set-AzureRMContext -SubscriptionName "<name of the subscription>") を選択します。

プロビジョニングを開始するには、Start-SitecoreAzureDeploymentコマンドレットを使用します。

Start-SitecoreAzureDeployment -location <String> -Name <String> -ArmTemplateUrl <String> -ArmParametersPath <String> -LicenseXmlPath <String>; -SetKeyValue <Hashtable>

Start-SitecoreAzureDeploymentコマンドレットは、次のパラメーターを受け入れます。

パラメーター	形容
Location	リソースをデプロイするAzureデータセンターの名前。Azureデータセンターの互換性テーブルには、Sitecore Experience PlatformがデプロイをサポートしているMicrosoft Azureデータセンターがリストされています。
Name	新しい環境のリソース・グループの名前。これは、新規または既存のリソースグループを参照でき、通常はデプロイIDと同じです。
ArmTemplateUrl	デプロイする環境構成のARMテンプレートファイルのURL。これは、テンプレートをホストしているHTTP(S) の場所を指しています。 GitHubを参照している場合は、次のようなrawリンクを使用します。 https://raw.githubusercontent.com/Sitecore/Sitecore-Azure-Quickstart-Templates/master/Sitecore%209.0.0/xp/azuredeploy.json 手記入れ子になったテンプレートを機能させるには、Azure ARMエンジンで使用可能なストレージにデプロイする必要があります。
ArmParametersPath	選択したテンプレートの設定されたazuredeploy.parameters.jsonファイルへのパス。
LicenseXmlPath	環境にデプロイするSitecoreライセンスファイルへのパス。
SetKeyValue	azuredeploy.parameters.jsonファイル内のパラメーターに追加される環境固有のパラメーターのディクショナリ。これを使用して、次の完全なスクリプト例に示すように、クライアント認証証明書をBase64にエンコードするときに渡すことができます。これにより、パラメータの要件を満たすことができます。

完全なスクリプトの例:

$SCSDK="Path to Sitecore Azure Toolkit"
$SCTemplates="https://raw.githubusercontent.com/Sitecore/Sitecore-Azure-Quickstart-Templates/master/Sitecore%209.0/xp/"
$DeploymentId = "Deployment ID"
$LicenseFile = "Path to the Sitecore license.xml file"
$SubscriptionId = "Microsoft Azure SubscriptionId"
$Location="Target location of deployment"
$ParamFile="Path to filled-in azuredeploy.parameters.json file"
$Parameters = @{
     #set the size of all recommended instance sizes   
     "sitecoreSKU"="Medium";
     #by default this installs azuresearch
     #if you uncomment the following it will use an existing solr connectionstring that
     # you have created instead of using AzureSearch
     #"solrConnectionString"= "https://myinstancesomewhere/solr";
}
Import-Module $SCSDK\tools\Sitecore.Cloud.Cmdlets.psm1
Add-AzureRMAccount
Set-AzureRMContext -SubscriptionId $SubscriptionId
Start-SitecoreAzureDeployment -Name $DeploymentId -Location $Location -ArmTemplateUrl "$SCTemplates/azuredeploy.json"  -ArmParametersPath $ParamFile  -LicenseXmlPath $LicenseFile  -SetKeyValue $Parameters

スクリプトを実行し、環境が完全にプロビジョニングされるまで待ちます。

デプロイメント・コマンドを呼び出し、SAT 2.5を使用してプロビジョニングを開始します

SATバージョン2.5を使用する場合は、プロビジョニングを開始するために少し異なる手順に従う必要があります。

必要なモジュールAz.Accountsをインポートします: Import-Module Az.Accounts.
次のAzureアカウントをPowerShellセッションに接続します: Connect-AzAccount.
複数のサブスクリプションにアクセスできる場合は、デプロイ先のサブスクリプション ( Set-AzContext -SubscriptionId "id of the subscription") を選択します。

プロビジョニングを開始するには、Start-SitecoreAzureDeploymentコマンドレットを使用します。

Start-SitecoreAzureDeployment -location <String> -Name <String> -ArmTemplateUrl <String> -ArmParametersPath <String> -LicenseXmlPath <String>; -SetKeyValue <Hashtable>

完全なスクリプトの例:

$SCSDK="Path to Sitecore Azure Toolkit"
$SCTemplates="https://raw.githubusercontent.com/Sitecore/Sitecore-Azure-Quickstart-Templates/master/Sitecore%209.0/xp/"
$DeploymentId = "Deployment ID"
$LicenseFile = "Path to the Sitecore license.xml file"
$SubscriptionId = "Microsoft Azure SubscriptionId"
$Location="Target location of deployment"
$ParamFile="Path to filled-in azuredeploy.parameters.json file"
$Parameters = @{
     #set the size of all recommended instance sizes   
     "sitecoreSKU"="Medium";
     #by default this installs azuresearch
     #if you uncomment the following it will use an existing solr connectionstring that
     # you have created instead of using AzureSearch
     #"solrConnectionString"= "https://myinstancesomewhere/solr";
}
Import-Module $SCSDK\tools\Sitecore.Cloud.Cmdlets.psm1
 Import-Module Az.Accounts
       Connect-AzAccount
       Set-AzContext -SubscriptionId $SubscriptionId
Start-SitecoreAzureDeployment -Name $DeploymentId -Location $Location -ArmTemplateUrl "$SCTemplates/azuredeploy.json"  -ArmParametersPath $ParamFile  -LicenseXmlPath $LicenseFile  -SetKeyValue $Parameters

スクリプトを実行し、環境が完全にプロビジョニングされるまで待ちます。

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