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

Version: 2.7

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

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

このトピックでは、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 つあります。

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

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