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

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

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

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

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

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

Sitecoreの設定

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

構成

概要

XPシングル

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

  • Sitecore Identity Server。

  • Sitecoreの役割は4つあります:Content Delivery、Content Management、処理、報告を単一のWebAppインスタンスとしてまとめます。

  • 5つのxConnect役割:Search、Collection、Reference Data、Marketing Automation、そしてMarketing Automation Reportingを単一のWebAppインスタンスとして。

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

XP スケールド

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

  • Sitecore Identity Server。

  • Sitecoreの役割は4つあります:Content Delivery、Content Management、Processing、そしてレポーター。

  • 5つのxConnect役割:Search、Collection、Reference Data、Marketing Automation、Marketing Automation Reporting。

フル機能の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のみモードで)この環境を活用してください。

xDB シングル

これはSitecore Experience Databaseの設定で、実行されます:

  • Sitecore役割は2つあります:Processingと単一のWebAppインスタンスとしてReporting。

  • 5つのxConnect役割:Search、Collection、Reference Data、Marketing Automation、そしてMarketing Automation Reportingを単一のWebAppインスタンスとして。

この構成を開発およびテストに使用し、オンプレミスのSitecore XMインストールと組み合わせてExperience Database機能を提供します。

xDB スケールド

これはSitecore Experience Databaseの設定で、実行されます:

  • Sitecore役割は2つあります:Processing、そしてReporting。

  • 5つのxConnect役割:Search、Collection、Reference Data、Marketing Automation、Marketing Automation Reporting。

この環境をオンプレミスのSitecore XMインストールと組み合わせて使用し、エクスペリエンスデータベースの機能を利用してください。

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

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

認証証明書の作成方法:

  1. Sitecore 9.0展開を開始する前に、認証証明書を取得し、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は、ファイルを選択してからRAWをクリックしてGitHubから取得します。ファイルは新しいブラウザウィンドウで開きます。アドレスバーから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。

    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です。

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

    xDBシングル

    パラメータ

    概要

    location

    現在の展開地域。

    sqlServerLogin

    サーバー用に作成されている管理者アカウントの名前Azure SQL。

    sqlServerPassword

    サーバー用に作成中の管理者アカウントのパスワードAzure SQL。

    sitecoreAdminPassword

    あなたのXPインスタンスの管理者アカウントのパスワードです。

    singleMsDeployPackageUrl

    Sitecore xDB Single Web Deploymentパッケージ(WDP)のHTTP(s)URLです。

    xcSingleMsDeployPackageUrl

    XConnect Single(WDP)のHTTP(s)URL。

    authCertificateBlob

    PKCS #12形式の認証証明書のBase64エンコードされたブロブ(.pfx)。エンコーディング手順については次のセクションのデプロイコマンド例を参照してください。

    authCertificatePassword

    認証証明書のパスワード。

    templateLinkAccessToken

    ネストされたインフラストラクチャとアプリケーションテンプレートのアクセストークンです。例えば、Azure Storage Explorerはテンプレートがアップロードされた場所にアクセスするためのSASトークンを生成できます。

    xDBスケールド

    パラメータ

    概要

    location

    現在の展開地域。

    sqlServerLogin

    サーバー用に作成されている管理者アカウントの名前Azure SQL。

    sqlServerPassword

    サーバー用に作成中の管理者アカウントのパスワードAzure SQL。

    sitecoreAdminPassword

    あなたのXPインスタンスの管理者アカウントのパスワードです。

    repAuthenticationApiKey

    例えば、Content Managementの役割からReporting Web Appへの通信時に認証するために使われるGUIDのような一意値があります。必要な最小長さは32文字です。

    prcMsDeployPackageUrl

    Sitecore xDB処理WDPのHTTP(s)URL。

    repMsDeployPackageUrl

    Sitecore xDB報告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です。

    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、xDB)でデフォルトのsitecoreSKUパラメータ「Extra Small」値を上書きし、「Small」「Medium」「Large」「Extra Large」に変更できます。例えば、Mediumに変更するには以下の方法を使用します。

    "sitecoreSKU": { "value": "Medium" }

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

Azure Cognitive SearchはAzureデプロイのデフォルトプロバイダーです。SolrをAzure Cognitive Searchの代替として選択できます。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コマンドを呼び出してプロビジョニングを開始するには:

!注SATバージョン2.5を使用している場合は、以下のセクションを参照してください: デプロイコマンドを呼び出し、SAT 2.5でプロビジョニングを開始する

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

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

  2. PowerShellセッションに以下のAzureアカウントを追加してください

    。

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

    -SubscriptionName ""。

  4. プロビジョニングは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 Add-AzureRMAccount Set-AzureRMContext -SubscriptionId $SubscriptionId Start-SitecoreAzureDeployment -Name $DeploymentId -Location $Location -ArmTemplateUrl "$SCTemplates/azuredeploy.json" -ArmParametersPath $ParamFile -LicenseXmlPath $LicenseFile -SetKeyValue $Parameters

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

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

SATバージョン2.5を使用する場合、プロビジョニングを開始する際には少し異なる手順を踏む必要があります:

  1. 必要なモジュールAz.Accounts: Import-Module Az.Accountsをインポートしてください。

  2. PowerShellセッションに以下のAzureアカウントをConnectしてください: Connect-AzAccount。

  3. 複数のサブスクリプションにアクセスできる場合は、展開したいサブスクリプションを選択してください: Set-AzContext -SubscriptionId "id of the subscription"。

  4. プロビジョニングはStart-SitecoreAzureDeploymentコマンドレットを使って開始します:

    Start-SitecoreAzureDeployment -location -Name -ArmTemplateUrl -ArmParametersPath -LicenseXmlPath ; -SetKeyValue

    完全なスクリプト例:

    $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

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

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