SitecoreソリューションをMicrosoft Azure App Service用にパッケージ化する
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このトピックでは、Sitecore Azure Toolkitを使用して、Microsoft Azure App Service® にデプロイする準備ができているWeb Deploymentパッケージ (WDP) にローカルSitecoreインスタンスをパッケージ化する方法について説明します。この機能は、カスタマイズされたローカルSitecoreソリューションをパッケージ化する場合にのみ必要です。
Sitecore Azure Toolkit 2.6.0を使用してWDPに変換された更新パッケージは、SXPリリース10.1とのみ互換性があります。SXP 10.0.x以前のバージョンのパッケージをビルドする必要がある場合は、SATバージョン2.5.1を使用します。
ソリューション デプロイ機能は下位互換性があり、SAT 2.6.0を使用して以前のSXPバージョンをAzureにデプロイできます。
標準のSitecoreソリューションのWDPは、Sitecore Experience Platformのダウンロード ページからダウンロードできます。
Sitecore Azure Toolkitは、現在、ローカルのxConnectコンポーネントをロールにパッケージ化することをサポートしていません。ロールの標準WDP: コレクション、参照データ、マーケティング オートメーション、コレクション検索、マーケティング オートメーション レポートは、Sitecore Experience Platformのダウンロード ページからダウンロードできるパッケージの一部として利用できます。
前提 条件
パッケージ化プロセスを開始する前に、次のものが必要です。
-
パッケージ化プロセスへの入力として使用するローカルSitecoreインスタンス。Sitecore Azure Toolkitは、インストール プログラムまたはZIPファイルからインストールされ、デフォルトのフォルダー構造を使用するSitecoreインスタンスのパッケージ化をサポートしています。
-
Microsoft Data Tier Application Framework (DAC Fx) です。このフレームワークは、通常、Microsoft SQL Server® またはMicrosoft Visual Studio® と共にインストールされます。DAC Fxは、Microsoftダウンロード センターからダウンロードすることもできます。
-
Sitecore Azure Toolkitは、「Sitecore Azure Toolkitの使用開始」で説明されている手順に従ってインストールする必要があります。
パッケージングの変換
Sitecoreをパッケージ化してAzureで正しく動作させるプロセス中に、Sitecore Azure Toolkitは1つ以上のWDPを作成します。各WDPには、元のSitecoreインストールが含まれており、Azure内の適切なリソースに特定のSitecoreロールをインストールするために必要な構造と設定に変換されています。たとえば、「小規模」サイズのSitecore Experienceプラットフォーム デプロイのコンテンツ管理ロールは、Azure Web Appsリソースでのみホストされます。そのリソースにデプロイされたときに動作するようにするには、構成でコンテンツ検索プロバイダーとしてAzure Cognitive Searchが使用されていることを確認する必要があります。Content ManagementロールのWDPがパックされている間、この設定を有効にする手順は、Sitecore Cargo Payloadファイル (SCCPL) を通じてプロセスに提供されます。Sitecoreは、標準のSitecoreインストールをAzureにデプロイ可能なさまざまなトポロジにパッケージ化するために必要なすべてのSCCPLファイルを提供します。これらのファイルは、Sitecore Azure Toolkitのダウンロードの一部であるCargoPayloadsフォルダー内にあります。ただし、カスタマイズされたインストールのカスタム展開要件を満たすには、これらのファイルを拡張、カスタマイズ、または追加する必要がある場合があります。
packagingコマンドの呼び出し
パッケージ化プロセスを開始するには、Sitecore Azure Toolkit PowerShellモジュールをインポートし、Start-SitecoreAzurePackagingコマンドレットを呼び出します。
Microsoft Windows PowerShell® で、Sitecore Azure Toolkitがインストールされているフォルダーで次のコマンドを実行する必要があります。
> Import-Module .\tools\Sitecore.Cloud.Cmdlets.psm1
> Import-Module .\tools\Sitecore.Cloud.Cmdlets.dll
> Start-SitecoreAzurePackaging [-sitecorePath] <String> [-destinationFolderPath] <String> [-cargoPayloadFolderPath] <String> [-commonConfigPath] <String> [-skuConfigPath] <String> [-parameterXmlPath] <String> [[-fileVersion] <String>]Start-SitecoreAzurePackagingコマンドレットには、次のパラメーターがあります。
|
パラメーター |
形容 |
|---|---|
|
sitecorePath |
パッケージ化するSitecoreインストールのSitecoreインスタンスWebサイト フォルダー、またはzipファイル内のパッケージ化されたSitecoreインスタンス フォルダーへのパス。 Webサイトフォルダへのパスの例: C:\inetpub\wwwroot\sampleWebSite\Website |
|
destinationFolderPath |
生成されたパッケージが格納されるフォルダ。 生成されたパッケージを保存するパスの例: C:\Sitecore\WDPs |
|
cargoPayloadFolderPath |
Sitecoreバージョン固有のロールおよび機能変換ファイルを含むフォルダーへのパス。 Sitecoreバージョン固有のロールおよび機能変換ファイルのパスの例: SitecoreAzureToolkitFolder\resources\version\CargoPayloads |
|
commonConfigPath |
すべてのロールに適用される変換ファイルの一覧を含むファイルへのパス。 Sitecoreに必要なすべての汎用変換を含むファイルのパスの例: SitecoreAzureToolkitFolder\resources\version\Configs\ common.packaging.config.json |
|
skuConfigPath |
選択したSitecoreバージョンとMicrosoft App ServiceのSitecore設定のロール固有の変換のリストを含むファイルへのパス。 ロール固有の変換を含むファイルへのパスの例: XMの小規模構成から特大構成まで、 SitecoreAzureToolkitFolder\resources\version\Configs\ XM.packaging.config.json XPの小規模構成から超大規模構成まで、 SitecoreAzureToolkitFolder\resources\version\Configs\ XP.packaging.config.json XPのシングル構成の場合、 SitecoreAzureToolkitFolder\resources\version\Configs\ XPSingle.packaging.config.json |
|
archiveAndParameterXmlPath |
WebDeploy Sitecoreバージョン固有のアーカイブ マニフェストとパラメーター宣言ファイルへのパス。 SitecoreAzureToolkitFolder\resources\version\MsDeployXMls |
|
fileVersion |
生成されたWebDeployパッケージにバージョン・マーカーを埋め込むことができるオプションのパラメータ。マーカーは、生成されたパッケージ内のVersion.txtファイルに格納されます。 |
|
integratedSecurity |
デフォルト値はfalse- これは、<Website name>\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にローカルにインストールされ、Webサイト フォルダーはC:\inetpub\example\Websiteです。
-
Sitecore Azure ToolkitはC:\Tools\SitecoreAzureToolkitにインストールされます。
-
生成されたパッケージはC:\Workspace\WDPsに保存されます。
コマンドレットによって作成されるパッケージは、パッケージ化中に要求されたSitecore設定によって異なります。通常、ロールごとに1つのWDPが存在するため、たとえば、XMトポロジでは、Content Managementロール用に1つのWDPが生成され、Content Deliveryロール用に1つのWDPが生成されます。