ウォークスルー Azure App Serviceへの新しいSitecore環境の展開
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このウォークスルーを使って、ソリューションに適した設定を行い、認証証明書を作成し、環境テンプレートを設定し、検索プロバイダーを展開し、プロビジョニングを開始しましょう。
このウォークスルーでは、以下の方法を説明します:
Sitecoreの設定
Sitecoreを設定するには、Sitecoreソリューションに適した構成を使用する必要があります。Sitecoreデフォルトで以下のSitecore構成をサポートしています:
構成
概要
XPシングル
これはSitecore Experience Platformの構成で、動作します:
-
Sitecore Identity Server。
-
Content Delivery、Content Management、xDB Processingの3つのSitecore役割が単一のWebAppインスタンスとして存在します。
-
XP役割:xConnect Search、xConnect Collection、xDB Reference Data、xDB Marketing Automation、 xDB Marketing Automation Reporting、 Sitecore Cortex Processing、 Sitecore Cortex Reportingを単一のAzure WebAppインスタンスとしてまとめます。
> [!注]
> すべての役割をホストする1つのXConnect WebAppの下で動作するWebJob XP複数あります。具体的には、役割は Marketing Automation Engine、 xConnect Search Indexer、 Sitecore Cortex Processing Engineです。
この構成は開発およびテストに使用してください。セキュリティおよびスケーラビリティの観点から、本番環境ではXMまたはXP構成を使用するのがベストプラクティスです。
XP スケールド
これはSitecore Experience Platformの構成で、動作します:
-
Sitecore Identity Server。
-
Sitecoreの役割はContent Delivery、Content Management、 xDB Processingの3つです。それぞれの役割は別々の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インスタンスにホストされているのとは異なります)。
各WebJobは特定の役割のもとで動作します。以下は、それらがホストしているさまざまな役割とWebJobです:
-
xDB Marketing Automation - マーケティングオートメーションエンジンのWebJobをホストしています。
-
Sitecore Cortex Processing - Cortex Processing Engine WebJobをホストします。
-
xConnect Search - XConnect Search Indexer WebJobをホストしています。
フル機能のSitecore Experience Platformインストールを計画する際には、この環境を活用してください。
XMシングル
以下は以下の構成Sitecore Experience Managementを実行します:
-
Sitecore Identity Server。
-
Content DeliveryとContent Managementの両方が単一のWebAppインスタンスとして機能します。
Sitecore Experience PlatformのAnalyticsやMarketing機能(すなわちCMSのみモード)を使う予定がない場合、この構成は開発やテストに使用してください。
XMスケール
以下は以下の構成Sitecore Experience Managementを実行します:
-
Sitecore Identity Server。
-
役Content Deliveryも、Content Management役も。
Sitecore Experience PlatformのAnalyticsやMarketing機能を使う予定がない場合(つまりCMSのみモードで)この環境を活用してください。
トポロジーやサイズ、展開したい環境の種類を計画する際は、ドキュメントサイトのSitecore Azure Toolkitドキュメントを参照してください。
認証証明書を準備してください
認証証明書の作成方法:
-
Sitecore展開を開始する前に、認証証明書を取得し、PKCS #12形式(.pfx)で保存する必要があります。
!notexConnectは、デフォルトで有効な信頼チェーンを持つクライアント認証証明書を必要とします。制限により、Azure App Serviceでは、証明書がグローバルに信頼される認証機関によって発行されたルート証明書でなければ、有効な信頼チェーンを持つことはできません。
-
自己署名証明書やActive Directory Certificate Servicesのような民間の証明書機関が発行する証明書を使用する場合、allowInvalidClientCertificatesパラメータをtrueに設定し、azuredeploy.parameters.jsonファイルを以下のもので拡張する必要があります:
"allowInvalidClientCertificates": { "value": true }
パラメータファイルの詳細と拡張方法については、次のセクションのステップ4で説明されています。
環境テンプレートをダウンロードして設定する
計画中のSitecore設定用環境テンプレートをダウンロード・設定するには:
- GitHubリポジトリにアクセスし、選択したSitecoreの設定とバージョンのテンプレート(例:フォルダ 10.0、サブフォルダ)を探してください。
- 選択した構成とバージョンの適切なサブフォルダで、azuredeploy.jsonファイルを指定してください。これはデプロイプロセスで使う主なARMテンプレートです。このファイルの生URLは、GitHubでファイルを選択してからRawをクリックすることで取得できます。ファイルは新しいブラウザウィンドウで開きます。アドレスバーからURLを直接コピーし、後で使うためにメモしてください。
- 選択した構成とバージョンに関連するサブフォルダで、azuredeploy.parameters.jsonファイルを識別してダウンロードします。展開プロセスを制御するために、ARMテンプレートはこのファイルを使ってパラメータを渡します。
- ファイルをローカルに保存し、該当する表に記載されている構成に従ってファイル内のパラメータを入力します。
XPシングル
パラメータ
概要
location
現在の展開地域。
sqlServerLogin
サーバー用に作成されている管理者アカウントの名前Azure SQL。
sqlServerPassword
サーバー用に作成中の管理者アカウントのパスワードAzure SQL。
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形式の認証証明書のBase64エンコードされたブロブ(.pfx)。エンコーディング手順については次のセクションのデプロイコマンド例を参照してください。
authCertificatePassword
認証証明書のパスワード。
templateLinkAccessToken
ネストされたインフラストラクチャとアプリケーションテンプレートのアクセストークンです。例えば、Azure Storage Explorerはテンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。
XPスケールド
パラメータ
概要
location
現在の展開地域。
sqlServerLogin
サーバー用に作成されている管理者アカウントの名前Azure SQL。
sqlServerPassword
サーバー用に作成中の管理者アカウントのパスワードAzure SQL。
sitecoreAdminPassword
あなたのXPインスタンスの管理者アカウントのパスワードです。
repAuthenticationApiKey
例えば、Content Managementの役割から処理Webアプリへの通信時に認証に使われるGUIDのような一意値があります。必要な最小長さは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パッチのHTTPSURL WDP。
bootloaderMsDeployPackageUrl
SitecoreブートローダーWDPのHTTP(s)URLです。
xcRefDataMsDeployPackageUrl
xConnect Reference Data Service WDPのHTTP(s)URL。
xcCollectMsDeployPackageUrl
xConnect CollectionサービスWDPのHTTP(s)URL。
xcSearchMsDeployPackageUrl
xConnect Collection SearchサービスWDPのHTTP(s)URLです。
maOpsMsDeployPackageUrl
マーケティングオートメーションサービスのHTTP(s)URLであるWDP。
maRepMsDeployPackageUrl
マーケティングオートメーションレポーティングサービスのHTTP(s)URLであるWDPです。
deployExmDds
Sitecore XP専用ディスパッチサーバーを設置する必要があるかどうかを示します。
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形式の認証証明書のBase64エンコードされたブロブ(.pfx)。エンコーディング手順については次のセクションのデプロイコマンド例を参照してください。
authCertificatePassword
認証証明書のパスワード。
templateLinkAccessToken
ネストされたインフラストラクチャとアプリケーションテンプレートのアクセストークンです。例えば、Azure Storage Explorerはテンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。
XMシングル
パラメータ
概要
location
現在の展開地域。
sqlServerLogin
サーバー用に作成されている管理者アカウントの名前Azure SQL。
sqlServerPassword
サーバー用に作成中の管理者アカウントのパスワードAzure SQL。
sitecoreAdminPassword
XMのインスタンスの管理者アカウントのパスワードです。
singleMsDeployPackageUrl
Sitecore XMシングルウェブデプロイパッケージ(WDP)のHTTP(s)URLです。
siMsDeployPackageUrl
Sitecore Identity Server WDPのHTTP(s)URL。
authCertificateBlob
PKCS #12形式の認証証明書のBase64エンコードされたブロブ(.pfx)。エンコーディング手順については次のセクションのデプロイコマンド例を参照してください。
authCertificatePassword
認証証明書のパスワード。
templateLinkAccessToken
ネストされたインフラストラクチャとアプリケーションテンプレートのアクセストークンです。例えば、Azure Storage Explorerはテンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。
XMスケール
パラメータ
概要
location
現在の展開地域。
sqlServerLogin
サーバー用に作成されている管理者アカウントの名前Azure SQL。
sqlServerPassword
サーバー用に作成中の管理者アカウントのパスワードAzure SQL。
sitecoreAdminPassword
XMのインスタンスの管理者アカウントのパスワードです。
cmMsDeployPackageUrl
Sitecore XM Content Management Deployment Package(WDP)のHTTP(s)URL。
cdMsDeployPackageUrl
Sitecore XM Content Delivery WDPのHTTP(s)URLです。
siMsDeployPackageUrl
Sitecore Identity Server WDPのHTTP(s)URL。
authCertificateBlob
PKCS #12形式の認証証明書のBase64エンコードされたブロブ(.pfx)。エンコーディング手順については次のセクションのデプロイコマンド例を参照してください。
authCertificatePassword
認証証明書のパスワード。
templateLinkAccessToken
ネストされたインフラストラクチャとアプリケーションテンプレートのアクセストークンです。例えば、Azure Storage Explorerはテンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。
-
オプションとして、azuredeploy.parameters.jsonファイルに宣言した任意のパラメータで拡張することで追加パラメータを追加することもazuredeploy.json。各Sitecore環境構成のルートフォルダ内のREADME.mdファイルに追加情報を提供します。
!注azuredeploy.parameters.jsonファイルにはsiMsDeployPackageUrlが含まれていますが、デフォルトでは含まれていないSitecore Identityパッケージ は別途ダウンロードする必要があります。
-
任意のスケールトポロジー(XP、XM)でデフォルトの「Extra Small」sitecoreSKUパラメータの「」値を上書きし、「Small」、「Medium」、「Large」、「Extra Large」に変えることができます。例えば、Mediumに変更するには以下の方法を使用します。
"sitecoreSKU": { "value": "Medium" }
Solrを検索プロバイダーとしてデプロイ
SolrサーバーはARMテンプレートでプロビジョニングされていないため、Azureにデプロイした後は手動でテンプレートを作成し、Solrコアで埋める必要があります。Solrサーバーを使用するには、以下の表のパラメータを渡してください:
XMスケールとXMシングル
パラメータ
概要
solrConnectionString
既存のSolrサーバーへの接続文字列で、Sitecore Platformの役割に渡されます。
XPスケールド
パラメータ
概要
solrConnectionString
既存のSolrサーバーへの接続文字列で、Sitecoreプラットフォームの役割に渡ります。
xcSearchMsDeployPackageUrl
Solr xConnect Searchウェブデプロイパッケージへのブロブストレージ(HTTPS)URLです。
xcSolrConnectionString
(任意)xConnectの役割に渡す既存のSolrサーバーへの接続文字列。パラメータを指定しない場合、デフォルト値は次のようになります: solrConnectionString。
XPシングル
パラメータ
概要
solrConnectionString
既存のSolrサーバーへの接続文字列で、Sitecoreプラットフォームの役割に渡されます。
xcSolrConnectionString
(任意)xConnectの役割に渡す既存のSolrサーバーへの接続文字列。パラメータを指定しない場合、デフォルト値は次のようになります: solrConnectionString。
xcSingleMsDeployPackageUrl
Solr xConnect Single Web デプロイパッケージのHTTP(s)URLです。
デプロイコマンドを呼び出してプロビジョニングを開始します
PowerShellコマンドを呼び出してプロビジョニングを開始するには:
-
PowerShellのSitecore Azure Toolkitフォルダで、Sitecore Azure Toolkitモジュールを読み込みます
.\tools\Sitecore.Cloud.Cmdlets.psm1。 -
インポート必須モジュールAz.Accounts: Import-Module Az.Accounts.
-
Connect、PowerShellセッションに以下のAzureを説明してください: Connect-AzAccount
-
複数のサブスクリプションにアクセスできる場合は、展開したいサブスクリプションを選択してください
-SubscriptionId ""。 -
プロビジョニングはStart-SitecoreAzureDeploymentコマンドレットを使って開始します:
Start-SitecoreAzureDeployment -location
-Name -ArmTemplateUrl -ArmParametersPath -LicenseXmlPath ; -SetKeyValue Start-SitecoreAzureDeploymentコマンドレットは以下のパラメータを受け付けます:
パラメータ
概要
Location
リソースを展開したいAzureデータセンターの名前です。Azureデータセンター互換性表には、Sitecore Experience Platformが展開をサポートしているMicrosoft Azureデータセンターが一覧化されています。
Name
新しい環境のリソースグループの名前です。新しいリソースグループまたは既存のリソースグループを指すことができ、通常はデプロイメントIDと同じです。
ArmTemplateUrl
デプロイしたい環境設定のARMテンプレートファイルのURLです。テンプレートをホストしているHTTP(S)の場所を指しています。
> [!注]
> ネストされたテンプレートを動作させるには、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%2010.2.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"; #Solr is the only supported search provider; set the connection string to your existing Solr server "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
-
スクリプトを実行し、環境が完全にプロビジョニングされるまで待ちます。