パッケージ管理サービス

パッケージのメタデータと構造

パッケージとは、2つのファイルからなる.zipアーカイブのことです。

• Package.update – 標準的なSitecoreの更新ファイルです。
• Package.json – パッケージを記述する情報。

情報(JSON形式)にはプロパティの説明、インストール前ステップ、インストール後のステップが含まれます。アップデートセンターはこの情報を読み取り表示します。以下はJSON形式のパッケージ情報の例です:

{ "Properties": { "Description": "This update package will upgrade your current Sitecore Platform version to 9.0.2", "Installation instruction": "https:/dev.sitecore.net/", "Release notes": "https:/dev.sitecore.net/", "Some Property": "something", "Another Property": "something" }, "PostSteps": { "Name": "Name of poststep here", "Description": "Description of poststep here" }, { "Name": "Name of the next poststep here", "Description": "Description of poststep here" }, "PreSteps": { "Name": "Name of prestep here", "Description": "Description of prestep here" }, { "Name": "Name of the next prestep here", "Description": "Description of prestep here" } }

バージョン管理ルール

Sitecoreプラットフォームおよびモジュールは、意味的なバージョン設定に基づくバージョン名を使用しています。

• 定期的な更新は以下の通りです:..、例えば9.2.2。
• ホットフィックスは以下の通りです:.、例えば9.2.0.3。

ファイル保存

パッケージ管理サービス用のパッケージは、ファイルシステムの特定のフォルダ構造に保存しなければなりません。この構造は、プラットフォームやモジュールの特定のバージョンに対するパッケージの可用性を定義します。

フォルダー構造は以下の要素を定義しています:

• パッケージがアップデートかホットフィックスか。
• プラットフォームまたはモジュールのソースバージョン。
• プラットフォームまたはモジュールのターゲットバージョン。

更新情報は以下の方法でフォルダ構造に格納されます:

• プラットフォームの最新情報:

  \\<platform group name (Platform or Management)>\

• モジュールの最新情報:

  \\Modules\\\

前述の通り、web.configファイル内で更新ルートフォルダを指定します。

以下はフォルダ構造の例です:

フォルダーの場所:

フォルダパス

概要

\updates

アップデートパッケージのルートフォルダです。

\updates\9.1.0

インストールされたプラットフォームのソース(現在の)バージョンです。この例では9.1.0です。

\updates\9.1.0\platform\9.1.1 および \updates\9.1.0\platform\9.1.2

現在のバージョンからアップグレードできるプラットフォームのターゲットバージョンです。この例では、9.1.0から9.1.1または9.1.2へアップグレードできます

\updates\9.1.0\management\9.1.1 および \updates\9.1.0\management\9.1.2

現在のバージョンからアップグレードできるプラットフォーム構成「Management」のターゲットバージョンです。この例では、9.1.0 Managementから9.1.1または9.1.2 Managementへアップグレードできます。

\updates\9.0.0\modules

現在インストールされているプラットフォームのバージョンと互換性のあるモジュール。

\updates\9.0.0\modules\sxa\1.5.0

現在のSXAモジュールのバージョンです。この例では1.5.0です。

\updates\9.0.0\modules\sxa\1.5.0\1.6.0

プラットフォーム9.0.0にSXA 1.5.0をインストールした場合、SXA 1.6.0へアップグレードできます。

ホットフィックスは以下の方法でフォルダ構造に格納されます:

\<package name (Platform, Management or module name like EXM)>\\

以下はフォルダ構造の例です:

フォルダーの場所:

フォルダパス

概要

\management\9.1.0\9.1.0.1

ターゲットプラットフォームManagement Groupバージョン9.0.1の最初のホットフィックスです。

\platform\9.1.0\9.1.0.1

ターゲットプラットフォームバージョン9.0.1の最初のホットフィックスです。

\sxa\1.5.0\1.5.0.1

SXAモジュールバージョン1.5.0の最初のホットフィックス(1.5.0.1)。

Azure Blob storageを使おう

パッケージの保存にはファイルシステムの代わりにAzure Blobストレージを使うことができます。

パッケージ管理サービスでブログストレージAzure使用するには、web.configファイルに以下の変更を加えてください:

1. HotfixesRootおよびUpdatesRoot設定の値を指定してください。値にはAzure Blobストレージコンテナ名と仮想ディレクトリのルートが含まれ、/で区切られます。小文字の名前のみを使用してください。

2. PackageRepositoryProvider設定の値をSitecore.PackageManagementService.AzureStorageProvider.Repositories.AzureBlobRepository,  Sitecore.PackageManagementService.AzureStorageProviderに変更してください:

3. AzureポータルでAzure Blobストレージアカウントの接続文字列の値をAzureStorage設定の価値として指定してください。

ウェブAPI 2.0

このサービスはパッケージの観察とダウンロードのためのWeb APIを提供します。

クエリ文字列に ?api-version= を追加して、特定のバージョンのAPIを使います。