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

Version:

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

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

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

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

Sitecoreの設定

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

構成	形容
XP Single	これは、以下を実行するSitecore Experience Platform設定です。 Sitecore IDサーバー。 Sitecoreの3つのロール:Content Delivery、、Content Management、xDB Processingを1つのWebAppインスタンスとして。すべてのXPロール:xConnect Search、xConnect Collection、xDB Reference Data、xDB Marketing Automation、xDB Marketing Automation Reporting、Sitecore Cortex Processing、Sitecore Cortex Reportingを1つのAzure Web Appインスタンスとして。メモすべてのXPロールをホストする1つのXConnect WebAppで実行されるWebジョブは多数あります。具体的には、ロールはMarketing Automation Engine、xConnect Search Indexer、およびSitecore Cortex Processing Engineです。この構成は、開発とテストに使用します。セキュリティとスケーラビリティの理由から、実稼働環境ではXMまたはXP構成を使用することをお勧めします。
XP Scaled	これは、以下を実行するSitecore Experience Platform設定です。 Sitecore IDサーバー。 Sitecoreの3つのロール:Content Delivery、Content Management、xDB Processing。各ロールは、個別のAzure WebAppとして実行されます。すべてのXPロール:xConnect Search、xConnect Collection、xDB Reference Data、xDB Marketing Automation、xDB Marketing Automation Reporting、Sitecore Cortex Processing、およびSitecore Cortex Reporting。各ロールは、独自のWebAppインスタンスで実行されます (XP Singleでは、すべてのロールが1つのWebAppインスタンスでホストされます)。各Webジョブは、特定のロールで実行されます。以下は、さまざまなロールと、ホストしているWebジョブです。 xDB Marketing Automation - マーケティングオートメーションエンジンWebジョブをホストします。 Sitecore Cortex Processing - CortexプロセッシングエンジンWebJobをホストします。 xConnect Search - XConnect Search Indexer Webジョブをホストします。この環境は、フル機能の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専用モード) を使用する予定がない場合に、この環境を使用します。

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

認証証明書を準備する

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

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

手記

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

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

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

GitHubリポジトリに移動し、選択したSitecoreの設定とバージョンのテンプレートを見つけます (例: フォルダー: Sitecore 10.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 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トークンを生成できます。

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。
exmDdsMsDeployPackageUrl	Sitecore専用ディスパッチサーバー WDPのHTTP(s) URL。
exmCmMsDeployPackageUrl	Sitecore XP Content Management EXMパッチWDPのHTTPS(s) URL。
bootloaderMsDeployPackageUrl	Sitecoreブートローダー 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。
deployExmDds	Sitecore XP Dedicated Dispatchサーバーをインストールする必要があるかどうかを示します。
cortexReportingMsDeployPackageUrl	Sitecore Cortex ReportingサービスWDPのHTTP(s) URL。
cortexProcessingMsDeployPackageUrl	Sitecore Cortex Processing Engineサービス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 Web Deployパッケージ (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トークンを生成できます。

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

手記

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

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

Azure Cognitive Searchは、Azureデプロイの既定のプロバイダーです。バージョン9.0.2以降では、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。

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

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

PowerShellのSitecore Azure Toolkitフォルダーに、Sitecore Azure Toolkitモジュール (Import-Module .\tools\Sitecore.Cloud.Cmdlets.psm1.
必要なモジュール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>

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

パラメーター	形容
Location	リソースをデプロイするAzureデータセンターの名前。Azureデータセンターの互換性テーブルには、Sitecore Experience PlatformがデプロイをサポートしているMicrosoft Azureデータセンターがリストされています。
Name	新しい環境のリソース・グループの名前。これは、新規または既存のリソースグループを参照でき、通常はデプロイIDと同じです。
ArmTemplateUrl	デプロイする環境構成のARMテンプレートファイルのURL。これは、テンプレートをホストしているHTTP(S) の場所を指しています。 GitHubを参照している場合は、"生の" リンクを使用します (例: 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

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

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

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