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

Version:

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

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

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

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

Sitecoreの設定

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

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

トポロジ、サイジング、およびデプロイする環境のタイプを計画する際には、Docサイトの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サーバー用に作成される管理者アカウントの名前。
sqlServerPassword	Azure SQLサーバー用に作成されている管理者アカウントのパスワード。
sitecoreAdminPassword	XPのインスタンスの管理者アカウントのパスワード。
singleMsDeployPackageUrl	Sitecore XP単一Web配置パッケージ (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サーバー用に作成される管理者アカウントの名前。
sqlServerPassword	Azure SQLサーバー用に作成されている管理者アカウントのパスワード。
sitecoreAdminPassword	XPのインスタンスの管理者アカウントのパスワード。
repAuthenticationApiKey	一意の値 (GUIDなど) は、Content Managementロールから処理Webアプリへの通信時に認証に使用されます。必要な最小長は32文字です。
cmMsDeployPackageUrl	Sitecore XP Content Management Web DeployパッケージのHTTP(s) URL (WDP)。
cdMsDeployPackageUrl	Sitecore XP Content Delivery WDPのHTTP(s) URL。
prcMsDeployPackageUrl	Sitecore XP処理WDPのHTTP(s) URL。
exmDdsMsDeployPackageUrl	Sitecore Dedicated Dispatchサーバー 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サーバー用に作成される管理者アカウントの名前。
sqlServerPassword	Azure SQLサーバー用に作成されている管理者アカウントのパスワード。
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サーバー用に作成される管理者アカウントの名前。
sqlServerPassword	Azure SQLサーバー用に作成されている管理者アカウントのパスワード。
sitecoreAdminPassword	XMのインスタンスの管理者アカウントのパスワード。
cmMsDeployPackageUrl	Sitecore XM Content Managementデプロイメントパッケージ (WDP) へのHTTP(s) URL。
cdMsDeployPackageUrl	Sitecore XM Content Delivery 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を検索プロバイダーとしてデプロイ

SolrサーバーはARMテンプレートによってプロビジョニングされないため、Azureにデプロイした後、テンプレートを手動で作成し、Solrコアを設定する必要があります。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します。 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などの 'raw' リンクを使用します。手記入れ子になったテンプレートを機能させるには、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

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

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