Sitecore Azure Toolkitでのパッケージング

Microsoft Azure App ServiceのSitecoreソリューションのパッケージ化

Version: 3.0

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

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

このトピックでは、Sitecore Azure Toolkitを使ってローカルSitecoreインスタンスをWebデプロイメントパッケージ(WDP)にパッケージ化し、Microsoft Azure App Service®へのデプロイ準備を整える方法について説明します。この機能は、カスタマイズされたローカルSitecoreソリューションのパッケージ化にのみ必要です。

!重要ソリューション展開機能は後方互換性があり、SAT 3.0.0はAzure上での旧SXPバージョンのデプロイに利用できます。

標準的なSitecoreソリューション用のWDPは、Sitecore Experience Platformのダウンロードページからダウンロードできます。

!注Sitecore Azure Toolkitは現在、ローカルのxConnectコンポーネントをロールにパッケージ化するサポートがありません。ロールの標準WDP(コレクション、リファレンスデータ、マーケティングオートメーション、コレクションSearch、マーケティングオートメーション報告)は、Sitecore Experience Platformダウンロードページからダウンロード可能なパッケージの一部として利用可能です。

前提条件

包装作業を始める前に、以下の条件を満たす必要があります:

パッケージングプロセスの入力として使用するローカルSitecoreインスタンスです。Sitecore Azureツールキットは、インストールプログラムまたはZIPファイルからインストールされるインスタンスのSitecoreパッケージングをサポートし、デフォルトのフォルダ構造を使用します。
Microsoftデータティアアプリケーションフレームワーク(DAC Fx)。このフレームワークは通常、Microsoft SQL Server ®またはMicrosoft Visual Studio ®と一緒にインストールされます。また、MicrosoftダウンロードセンターからもDAC Fxをダウンロードできます。
Sitecore Azureツールキットは、「ツールキットの始め方」に記載された手順に従ってインストールSitecore Azureなければなりません。

パッケージングの変革

Azure上で正しく動作するようにパッケージングSitecore過程で、Sitecore Azureツールキットは1つ以上のWDPを作成します。各WDPには元のSitecoreインストールが含まれており、Azure内の適切なリソースに特定のSitecore役割をインストールするために必要な構造や構成に変換されています。例えば、「Small」サイズのSitecore Experienceプラットフォーム展開におけるContent Management役割は、Azure Web Appsリソース上で専用にホストされます。そのリソースにデプロイされた際に動作するようにするためには、構成がコンテンツ検索プロバイダーとしてAzure Cognitive Searchを使用していることを確認してください。Content Management役割のWDPがパックされている間、この構成イネーブルメントの指示はSitecore Cargo Payloadファイル(SCCPL)を通じてプロセスに提供されます。Sitecore、標準SitecoreインストールをAzure上で展開可能なさまざまなトポロジーにパッケージ化するための必要なSCCPLファイルをすべて提供しています。これらのファイルはSitecore Azure Toolkitダウンロードに含まれるCargoPayloadsフォルダ内にあります。ただし、カスタマイズされたインストールのカスタム展開要件を満たすためには、これらのファイルの拡張、カスタマイズ、追加が必要になる場合があります。

パッケージングコマンドの呼び出し

パッケージングを始めるには、Sitecore Azure Toolkit PowerShellモジュールをインポートし、Start-SitecoreAzurePackagingコマンドレットを呼び出します。

!注Sitecore Azure ToolkitがインストールされているフォルダのMicrosoft Windows PowerShell ®で以下のコマンドを実行しなければなりません:

Import-Module .\tools\Sitecore.Cloud.Cmdlets.psm1 Import-Module .\tools\Sitecore.Cloud.Cmdlets.dll Start-SitecoreAzurePackaging -sitecorePath -destinationFolderPath -cargoPayloadFolderPath -commonConfigPath -skuConfigPath -parameterXmlPath -fileVersion

Start-SitecoreAzurePackagingコマンドレットには以下のパラメータがあります:

パラメータ

概要

sitecorePath

パッケージ化するSitecoreインストールのSitecoreインスタンスのウェブサイトフォルダか、zipファイル内のパッケージ化されたSitecoreインスタンスフォルダへのパスです。

ウェブサイトフォルダへのパスの例:

C:\inetpub\wwwroot\sampleWebSite\Website

destinationFolderPath

生成されたパッケージを保存するフォルダです。

生成されたパッケージを格納するためのパスの例:

C:\Sitecore\WDPs

cargoPayloadFolderPath

Sitecoreのバージョン固有の役割および機能変換ファイルを含むフォルダへのパス。

Sitecoreバージョン固有の役割および機能変換ファイルの経路の例:

SitecoreAzureToolkitResourcesFolder\resources\CargoPayloads

commonConfigPath

すべての役割に適用する変換ファイルのリストを含むファイルへのパス。

Sitecoreに必要なすべての汎用変換を含むファイルのパスの例:

SitecoreAzureToolkitResourcesFolder\resources\Configs\common.packaging.config.json

skuConfigPath

選択したSitecoreバージョンおよびMicrosoft App Service上のSitecore構成に関する役割固有の変換リストを含むファイルへのパス。

役割固有の変換を含むファイルへのパスの例:

XMの小型から超大型構成の場合、

SitecoreAzureToolkitResourcesFolder\resources\Configs\XM.packaging.config.json

XPの小規模から超大型構成の場合、

SitecoreAzureToolkitResourcesFolder\resources\Configs\XP.packaging.config.json

XPの単一構成の場合、

SitecoreAzureToolkitResourcesFolder\resources\Configs\XPSingle.packaging.config.json

archiveAndParameterXmlPath

WebDeploy Sitecoreのバージョン固有のアーカイブマニフェストおよびパラメータ宣言ファイルへのパス。

SitecoreAzureToolkitResourcesFolder\resources\MsDeployXMls

fileVersion

生成されたWebDeployパッケージにバージョンマーカーを埋め込むためのオプションパラメータです。マーカーは生成されたパッケージ内のVersion.txtファイルに保存されます。

integratedSecurity

デフォルト値はfalseです。これは、\App_Config\ConnectionStrings.configファイルの接続文字列からユーザー IDとパスワードが使われることを意味します。

値がtrueに設定されている場合 - 現在のWindowsアカウントの認証情報が認証に使われます(ユーザーはSQLサーバーにアクセスするには管理者権限が必要です)。これにより、Sitecoreインスタンスをパッケージ化する際のセキュリティ制限の問題を解決できます。

!重要Sitecoreデータベースにアクセスするために使用するSQLサーバーアカウントは、Web Deployパッケージを使ってSitecoreインスタンスをデプロイすると上書きされます。

呼び出し時、Start-SitecoreAzurePackagingコマンドレットは宛先フォルダ内に複数のWebDeployパッケージを生成します。すべてのパッケージは同じ名前パターンに従い、例えばロール名を含むSitecore version rev. 171002_cm.scwdp.zip。

!注コマンドレットは役割固有の接尾辞を名前に含まない中間のWDPパッケージを生成することもあります。展開中はこのパッケージを無視しても構いません。

パッケージングの例

以下のコードサンプルは、Start-SitecoreAzurePackagingコマンドレットを使ってXP構成のためにWDPパッケージを準備する方法を示しています。サンプルは以下を前提としています:

SitecoreはC:\inetpub\exampleにローカルインストールされており、ウェブサイトのフォルダはC:\inetpub\example\Websiteされています。
Sitecore Azure ToolkitはC:\Tools\SitecoreAzureToolkitにインストールされています。
生成されたパッケージはC:\Workspace\WDPsに保存されます。

コマンドレットによって作成されるパッケージは、パッケージング時に要求されたSitecore設定に依存します。通常、役割ごとに1つのWDPが存在するため、例えばXMトポロジーではContent Managementロール用に1つのWDP、Content Deliveryロール用の別の1つが生成されます。

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