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

Current version: 2.7

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

重要

Sitecore Azure Toolkit 2.6.0 を使用して WDP に変換された更新パッケージは、SXP リリース 10.1 とのみ互換性があります。 バージョンが 10.0.x 以前の SXP のパッケージをビルドする必要がある場合は、バージョン 2.5.1 の SAT を使用してください。

ソリューションの展開機能には下位互換性があり、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 の開始方法」の手順に従ってインストールする必要があります。

パッケージ化変形

Azure で正しく機能するように Sitecore をパッケージ化するプロセス中に、Sitecore Azure Toolkit は 1 つ以上の WDP を作成します。 各 WDP には元の Sitecore インストールが含まれ、Azure 内の適切なリソースに特定の Sitecore ロールをインストールするために必要な構造と設定に変形されています。 たとえば、「小規模」サイズの Sitecore Experience Platform の展開における 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® で、次のコマンドを実行する必要があります。

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 のバージョン固有のロールと機能変形ファイルを含むフォルダーへのパスの例。

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

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

重要

Web Deploy パッケージを使用して Sitecore インスタンスを展開すると、Sitecore データベースへのアクセスに使用する SQL Server アカウントが上書きされます。

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 ロール用に生成された WDP が 1 つ、Content Delivery ロール用に生成された WDP が 1 つあります。

Do you have some feedback for us?

If you have suggestions for improving this article,