ウォークスルー
Azure App Serviceへの新しいSitecore環境の展開

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

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

このウォークスルーを使って、ソリューションに適した設定を行い、認証証明書を作成し、環境テンプレートを設定し、検索プロバイダーを展開し、プロビジョニングを開始しましょう。

このウォークスルーでは、以下の方法を説明します:

Sitecoreの設定

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

構成

概要

XPシングル

これはSitecore Experience Platformの構成で、動作します:

  • Sitecore Identity Server。

  • Content DeliveryContent ManagementxDB Processingの3つのSitecore役割が単一のWebAppインスタンスとして存在します。

  • XP役割:xConnect SearchxConnect CollectionxDB Reference DataxDB Marketing AutomationxDB Marketing Automation ReportingSitecore Cortex ProcessingSitecore Cortex Reportingを単一のAzure WebAppインスタンスとしてまとめます。

> [!注]
> すべての役割をホストする1つのXConnect WebAppの下で動作するWebJob XP複数あります。具体的には、役割は Marketing Automation EnginexConnect Search IndexerSitecore Cortex Processing Engineです。

この構成は開発およびテストに使用してください。セキュリティおよびスケーラビリティの観点から、本番環境ではXMまたはXP構成を使用するのがベストプラクティスです。

XP スケールド

これはSitecore Experience Platformの構成で、動作します:

  • Sitecore Identity Server。

  • Sitecoreの役割はContent DeliveryContent ManagementxDB Processingの3つです。それぞれの役割は別々のAzure WebAppとして動作します。

  • すべてのXPロール:xConnect SearchxConnect CollectionxDB Reference DataxDB Marketing AutomationxDB Marketing Automation ReportingSitecore Cortex ProcessingSitecore 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 DeliveryContent Managementの両方が単一のWebAppインスタンスとして機能します。

Sitecore Experience PlatformのAnalyticsMarketing機能(すなわちCMSのみモード)を使う予定がない場合、この構成は開発やテストに使用してください。

XMスケール

以下は以下の構成Sitecore Experience Managementを実行します:

  • Sitecore Identity Server。

  • Content Deliveryも、Content Management役も。

Sitecore Experience PlatformのAnalyticsMarketing機能を使う予定がない場合(つまりCMSのみモードで)この環境を活用してください。

トポロジーやサイズ、展開したい環境の種類を計画する際は、ドキュメントサイトのSitecore Azure Toolkitドキュメントを参照してください。

認証証明書を準備してください

認証証明書の作成方法:

  1. Sitecore展開を開始する前に、認証証明書を取得し、PKCS #12形式(.pfx)で保存する必要があります。

    !notexConnectは、デフォルトで有効な信頼チェーンを持つクライアント認証証明書を必要とします。制限により、Azure App Serviceでは、証明書がグローバルに信頼される認証機関によって発行されたルート証明書でなければ、有効な信頼チェーンを持つことはできません。

  2. 自己署名証明書やActive Directory Certificate Servicesのような民間の証明書機関が発行する証明書を使用する場合、allowInvalidClientCertificatesパラメータをtrueに設定し、azuredeploy.parameters.jsonファイルを以下のもので拡張する必要があります:

    "allowInvalidClientCertificates": { "value": true }

    パラメータファイルの詳細と拡張方法については、次のセクションのステップ4で説明されています。

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

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

  1. GitHubリポジトリにアクセスし、選択したSitecoreの設定とバージョンのテンプレート(例:フォルダ
    10.0、サブフォルダ
    )を探してください。
  2. 選択した構成とバージョンの適切なサブフォルダで、azuredeploy.jsonファイルを指定してください。これはデプロイプロセスで使う主なARMテンプレートです。このファイルの生URLは、GitHubでファイルを選択してからRawをクリックすることで取得できます。ファイルは新しいブラウザウィンドウで開きます。アドレスバーからURLを直接コピーし、後で使うためにメモしてください。
  3. 選択した構成とバージョンに関連するサブフォルダで、azuredeploy.parameters.jsonファイルを識別してダウンロードします。展開プロセスを制御するために、ARMテンプレートはこのファイルを使ってパラメータを渡します。
  4. ファイルをローカルに保存し、該当する表に記載されている構成に従ってファイル内のパラメータを入力します。

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コマンドを呼び出してプロビジョニングを開始するには:

  1. PowerShellSitecore Azure Toolkitフォルダで、Sitecore Azure Toolkitモジュールを読み込みます

    .\tools\Sitecore.Cloud.Cmdlets.psm1。

  2. インポート必須モジュールAz.Accounts: Import-Module Az.Accounts.

  3. Connect、PowerShellセッションに以下のAzureを説明してください: Connect-AzAccount

  4. 複数のサブスクリプションにアクセスできる場合は、展開したいサブスクリプションを選択してください

    -SubscriptionId ""。

  5. プロビジョニングは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)の場所を指しています。

    GitHubを指す場合は、例えばhttps://raw.githubusercontent.com/Sitecore/Sitecore-Azure-Quickstart-Templates/master/Sitecore%2010.2.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%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

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

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