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

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

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

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

大事な

ソリューション デプロイ機能は下位互換性があり、SAT 3.0.0を使用して以前のSXPバージョンをAzureにデプロイできます。

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

メモ

Sitecore Azure Toolkitでは、現在、ローカルのxConnectコンポーネントをロールにパッケージ化することはサポートされていません。ロールの標準WDP: コレクション、参照データ、マーケティング オートメーション、コレクションSearch、マーケティング オートメーション レポートは、Sitecore Experience Platformダウンロード ページからダウンロードできるパッケージの一部として利用できます。

前提 条件

パッケージ化プロセスを開始する前に、次のものが必要です。

  • パッケージ化プロセスへの入力として使用するローカルSitecoreインスタンス。Sitecore Azure Toolkitは、インストールプログラムと一緒にインストールされるか、ZIPファイルからインストールされ、デフォルトのフォルダ構造を使用するインスタンスのパッケージ化をサポートしSitecore。

  • Microsoftデータ層アプリケーション フレームワーク (DAC Fx)。このフレームワークは通常、Microsoft SQL Server ®またはMicrosoft Visual Studio ®とともにインストールされます。DAC Fxは、Microsoftダウンロード センターからダウンロードすることもできます。

  • Sitecore Azure Toolkitは、「Sitecore Azure Toolkitの開始」で説明されている手順に従ってインストールする必要があります。

パッケージングの変換

Azureで正しく動作するようにSitecoreをパッケージ化するプロセス中に、Sitecore Azure Toolkitは1つ以上のWDPを作成します。各WDPには、元のSitecoreインストールが含まれており、Azure内の適切なリソースに特定のSitecoreロールをインストールするために必要な構造と構成に変換されます。たとえば、「小規模」サイズの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フォルダ内にあります。ただし、カスタマイズされたインストールのカスタム展開要件を満たすには、これらのファイルを拡張、カスタマイズ、または追加する必要がある場合があります。

packagingコマンドの呼び出し

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

手記

次のコマンドは、Sitecore Azure ToolkitがインストールされているフォルダーのWindows PowerShell ® Microsoft実行する必要があります。

RequestResponse
> 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バージョン固有のロールと機能変換ファイルのパスの例:

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です - これは、<Website name>\App_Config\ConnectionStrings.configファイル内の接続文字列のユーザー IDとパスワードが使用されることを意味します。

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

大事な

Sitecoreデータベースへのアクセスに使用するSQL Serverアカウントは、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つのが生成されます。

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、