1. AzureでSitecoreを使ったデプロイメント

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

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

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

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

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

Sitecoreの設定

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

構成

概要

XPシングル

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

  • Sitecore Identity Server。

  • Sitecoreの役割はContent Delivery、Content Management、 xDB Processing、xDB Reportingの4つの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。

  • 4つのSitecore役割:Content Delivery、Content Management、xDB Processing、 xDB Reporting。それぞれの役割は別々の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ドキュメントを参照してください。

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

認証証明書の作成方法:

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

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

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

    "allowInvalidClientCertificates": { "value": true }

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

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

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

  1. GitHubリポジトリにアクセスし、選択したSitecoreの設定とバージョンのテンプレート(例:フォルダ

    9.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のシングル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の役割からReporting Web Appへの通信時に認証するために使われる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です。

    repMsDeployPackageUrl

    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参照データサービスWDPのHTTP(s)URL。

    xcCollectMsDeployPackageUrl

    XConnectコレクションサービスWDPのHTTP(s)URL。

    xcSearchMsDeployPackageUrl

    XConnectコレクションSearchサービスのHTTP(s)URL WDP。

    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トークンを生成できます。

  5. オプションとして、azuredeploy.parameters.jsonファイルに宣言した任意のパラメータで拡張することで追加パラメータを追加することもazuredeploy.json。各Sitecore環境構成のルートフォルダ内のREADME.mdファイルに追加情報を提供します。

    !注azuredeploy.parameters.jsonファイルにはsiMsDeployPackageUrlが含まれていますが、デフォルトでは含まれていないSitecore Identityパッケージ は別途ダウンロードする必要があります。

  6. 任意のスケールトポロジー(XP、XM)でデフォルトの「Extra Small」sitecoreSKUパラメータの「」値を上書きし、「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スケールとXMシングル

パラメータ

概要

solrConnectionString

既存のSolrサーバーへの接続文字列で、Sitecore Platformの役割に渡されます。

XPスケールド

パラメータ

概要

solrConnectionString

既存のSolrサーバーへの接続文字列で、Sitecoreプラットフォームの役割に渡ります。

xcSearchMsDeployPackageUrl

Solr XConnect Searchウェブデプロイパッケージへのブロブストレージ(HTTPS)URLです。

xcSolrConnectionString

(任意)既存のSolrサーバーへの接続文字列で、XConnectの役割に渡されます。パラメータを指定しない場合、デフォルト値は次のようになります: solrConnectionString。

XPシングル

パラメータ

概要

solrConnectionString

既存のSolrサーバーへの接続文字列で、Sitecoreプラットフォームの役割に渡されます。

xcSolrConnectionString

(任意)既存のSolrサーバーへの接続文字列で、XConnectの役割に渡されます。パラメータを指定しない場合、デフォルト値は次のようになります: solrConnectionString。

xcSingleMsDeployPackageUrl

Solr XConnect Single Web デプロイパッケージのHTTP(s)URL。

xDBスケールド

パラメータ

概要

xcsolrConnectionString

既存のSolrサーバーへの接続文字列で、XConnectの役割に渡されます。パラメータを指定しない場合、デフォルト値は以下の通りです

。

xcSearchMsDeployPackageUrl

Solr XConnect Search WEB DEPLOYパッケージへのHTTPS URLです。

xDBシングル

パラメータ

概要

xcsolrConnectionString

既存のSolrサーバーへの接続文字列で、XConnectの役割に渡されます。

xcSingleMsDeployPackageUrl

Solr XConnect SingleウェブデプロイパッケージのHTTP(s)URLです

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

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

  1. PowerShellのSitecore 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 ""Set-AzContext -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%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

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

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

    #"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. スクリプトを実行し、環境が完全にプロビジョニングされるまで待ちます。

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