1. その他の開発タスク

パッケージ管理サービス

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

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

パッケージ管理サービスを使用して、ユーザーがSitecoreパッケージに関する情報を取得し、アップデート センターを使用してこれらのパッケージをダウンロードしてインストールできるようにするWeb APIを提供します。これらのパッケージはローカルでホストします。

パッケージ管理サービスは、次の2つの構成グループをサポートしています。

  • Management - このプラットフォーム グループには、WCMS設定、ファイル、DLLのみが含まれます。Sitecore Analyticsに必要なパーツがないXMです。

  • Platform - このプラットフォーム グループには、XPに必要なファイルが含まれており、完全なSitecore設定です。

パッケージ管理サービスを使用して組織内でSitecoreパッケージをホストおよび配布する理由には、次のようなものがあります。

  • 開発者が開発環境とテスト環境にインストールしたパッケージを制御します。

  • パッケージは、Sitecoreインフラストラクチャ全体で一貫して配布できます。

パッケージ管理サービスは、1つの.zipアーカイブとして配布されます。アーカイブには、インストール手順を含むSitecore.PackageManagementService.Web.deploy-readme.txtファイルがあります。

インストール後、web.configファイルのappSettingsectionで次のパラメーターの値を指定して、サービスを構成します。

  • HotfixesRootとUpdatesRootを指定します。これらは、それぞれホットフィックスと更新を保持するファイルシステムフォルダです。

  • 次の2つの認証モードのいずれかを選択します。

    • 認証を完全に無効にするには、RequiredAuthorizationをfalseに設定します。

    • カスタム トークンベースの認証プロバイダー (実装する必要がある) を登録するには、OAuthAuthorizationServerProviderを指定します。カスタム プロバイダーは、Microsoft.Owin.Security.OAuth.OAuthAuthorizationServerProvider.

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

パッケージは、次の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プラットフォームとモジュールは、セマンティック バージョニングに基づくバージョン名を使用します。

  • 定期的な更新の名前は <Major>.<Minor>.187912757818791275788、例: 9.2.2。

  • ホットフィックスの名前は <Major>.<Minor18791275782<Patch>.<Hotfix>8 (例: 9.2.0.3)。

ファイルストレージ

Package Management Serviceのパッケージは、ファイル システム内の特定のフォルダ構造に格納する必要があります。この構造体は、プラットフォームまたはモジュールの特定のバージョンのパッケージの可用性を定義します。

フォルダ構造は、次の要素を定義します。

  • パッケージが更新プログラムまたは修正プログラムの場合。

  • プラットフォームまたはモジュールのソースバージョン。

  • プラットフォームまたはモジュールのターゲット バージョン。

更新は、次のようにフォルダ構造に保存されます。

  • プラットフォームの更新の場合:

    <updates root>\<source platform version>\<platform group name (Platform or Management)>\<target platform version>

  • モジュールの更新の場合:

    <updates root>\<source platform version>\Modules\<module name>\<current module version>\<target modules version>

更新ルートフォルダは、前述のようにweb.configファイルで指定します。

これは、フォルダ構造の例です。

Folder structurer

フォルダの場所:

フォルダパス

形容

\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

現在のバージョンからアップグレードできるプラットフォーム構成「管理」のターゲットバージョン。この例では、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

SXA 1.5.0がプラットフォーム9.0.0にインストールされている場合は、SXA 1.6.0にアップグレードできます。

ホットフィックスは、次のようにフォルダ構造に保存されます。

<hotfixes root>\<package name (Platform, Management or module name like EXM)>\<source product version>\<target product version>

これは、フォルダ構造の例です。

Folder structure

フォルダの場所:

フォルダパス

形容

<hotfixes root>\management\9.1.0\9.1.0.1

ターゲット プラットフォーム管理グループ バージョン9.0.1の最初の修正プログラム。

<hotfixes root>\platform\9.1.0\9.1.0.1

ターゲット プラットフォーム バージョン9.0.1の最初の修正プログラム。

<hotfixes root>\sxa\1.5.0\1.5.0.1

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

Azure Blob Storageを使用する

ファイル システムの代わりにAzure Blob Storageを使用してパッケージを格納できます。

パッケージ管理サービスにAzureブログ ストレージを使用するには、web.configファイルに次の変更を加えます。

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

  2. PackageRepositoryProvider設定の値をSitecore.PackageManagementService.AzureStorageProvider.Repositories.AzureBlobRepository,  Sitecore.PackageManagementService.AzureStorageProviderに変更します。

    <add key="PackageRepositoryProvider" value="Sitecore.PackageManagementService.AzureStorageProvider.Repositories.AzureBlobRepository,  Sitecore.PackageManagementService.AzureStorageProvider"/>

  3. Azure portalでAzure Blob Storageアカウントからの接続文字列値をAzureStorage設定の値として指定します。

Web API 2.0 (英語)

このサービスは、パッケージを監視およびダウンロードするためのWeb APIを提供します。

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

Sitecoreプラットフォームの更新

APIには、Sitecoreプラットフォームの更新をクエリおよびダウンロードするための次のメソッドがあります。

  • /api/updates/<sitecoreVersion>/<platform group name (Platform or Management)>?api-version=2.0

    特定のプラットフォームバージョンとプラットフォームグループのパッケージ説明のリストを返します。

  • /api/updates/<sitecoreVersion>/<platform group name (Platform or Management)>/latest?api-version=2.0

    特定のプラットフォーム バージョンとプラットフォーム グループの最新のパッケージの説明を返します。

  • /api/updates/<sitecoreVersion>/<platform group name (Platform or Management)>/<packageVersion>?api-version=2.0

    特定のプラットフォーム、プラットフォーム グループ、およびパッケージ バージョンのパッケージの説明を返します。

  • /api/download/updates/<sitecoreVersion>/platforms/<platform group name (Platform or Management)>?api-version=2.0

    特定のプラットフォームバージョンのパッケージストリームをパッケージ名とバージョンで返します。

モジュールの更新

APIには、モジュールの更新をクエリおよびダウンロードするための次のメソッドがあります。

  • /api/updates/<sitecoreVersion>/modules/<moduleName>/<moduleVersion>?api-version=2.0

    特定のモジュールバージョンのパッケージ説明のリストを返します。

  • /api/updates/<sitecoreVersion>/modules/<moduleName>/<moduleVersion>/latest?api-version=2.0

    特定のモジュールバージョンの最新のパッケージの説明を返します。

  • /api/updates/<sitecoreVersion>/modules/<moduleName>/<moduleVersion>/<packageVersion>?api-version=2.0

    特定のモジュール バージョンのパッケージの説明を、モジュール名、パッケージ バージョン、およびプラットフォーム バージョンで返します。

  • /api/download/updates/<sitecoreVersion>/modules/<moduleName>/<moduleVersion>/<packageVersion>?api-version=2.0

    特定のプラットフォーム バージョンのパッケージ ストリームをパッケージ名とバージョンで返します。

SitecoreプラットフォームとモジュールのHotfix

APIには、プラットフォームとモジュールのホットフィックスを照会およびダウンロードするための次のメソッドがあります。

  • /api/hotfixes/<packageName(Platform, Management or module name like EXM)>/<packageVersion>/latest?api-version=2.0

    特定のプラットフォーム バージョンで使用できる修正プログラムの説明の一覧を返します。

  • /api/hotfixes/<packageName(Platform, Management or module name like EXM)>/<packageVersion>?api-version=2.0

    特定のプラットフォーム グループ バージョンまたはモジュール バージョンで使用可能な修正プログラムの説明の一覧を返します。

  • /api/hotfixes/<packageName(Platform, Management or module name like EXM)>/<sitecoreVersion>/<packageVersion>?api-version=2.0

    特定のプラットフォーム バージョンの特定の修正プログラム パッケージの説明を返します。

  • /api/download/hotfixes/<packageName(Platform, Management or module name like EXM)>/<sitecoreVersion>/<packageVersion>?api-version=2.0

    特定のプラットフォーム バージョンの修正プログラム パッケージ ストリームを返します。

この記事を改善するための提案がある場合は、 お知らせください!