バージョンのパージ version-purging

標準インストールの場合、コンテンツの更新後にページをアクティベートすると、Adobe Experience Manager(AEM)によってページまたはノードのバージョンが作成されます。

NOTE
コンテンツが変更されない場合は、ページがアクティベート済みで、新しいバージョンが作成されないことを示すメッセージが表示されます。

サイドキックの「バージョン管理」タブを使用すると、リクエストに応じて追加のバージョンを作成できます。 これらのバージョンはリポジトリに格納され、必要に応じて復元できます。

これらのバージョンはパージされることがなく、時間の経過と共にリポジトリーのサイズが大きくなるので、管理が必要です。

AEM には、リポジトリの管理に役立つ様々なメカニズムが備わっています。

  • バージョン マネージャー🔗
    これは、新しいバージョンが作成されたときに古いバージョンをパージするように設定できます。

  • ​ バージョンのパージ ​ ツール
    これは、リポジトリの監視とメンテナンスの一部として使用されます。
    このツールを使用すると、次のパラメーターに従って、ノードの古いバージョンまたはノードの階層を削除するためにユーザーが介入できます。

    • リポジトリに保持されるバージョンの最大数。
      この数値を超えると、最も古いバージョンが削除されます。

    • リポジトリ内に保持されているバージョンの最大有効期間。
      バージョンの年齢がこの値を超えると、リポジトリからパージされます。

  • バージョンパージのメンテナンスタスク。 バージョンのパージメンテナンスタスクをスケジュールして、古いバージョンを自動的に削除できます。 これにより、バージョンのパージツールを手動で実行する必要性を最小限に抑えることができます。

CAUTION
リポジトリサイズを最適化するには、バージョンのパージタスクを頻繁に実行します。 トラフィック量が限られている場合は、このタスクを営業時間外にスケジュールする必要があります。

バージョンマネージャー version-manager

パージツールを使用した明示的なパージに加えて、新しいバージョンの作成時に古いバージョンをパージするようにバージョンマネージャーを構成できます。

バージョンマネージャーを設定するには、次の設定を作成します。

PID com.day.cq.wcm.core.impl.VersionManagerImpl

以下のオプションが利用できます。

  • versionmanager.createVersionOnActivation (ブール値、デフォルト:true)
    ページがアクティブ化されたときにバージョンを作成するかどうかを指定します。
    レプリケーションエージェントがバージョンの作成を抑制するように設定されていない限り、バージョンが作成されます。これはバージョンマネージャーで順守されます。
    アクティベーションが versionmanager.ivPaths に含まれているパスで行われた場合にのみバージョンが作成されます(以下を参照)。

  • versionmanager.ivPaths (String[]、既定値:{"/"}
    versionmanager.createVersionOnActivationがtrueに設定されている場合に、ライセンス認証時に暗黙的に作成されるバージョンのパスを指定します。

  • versionmanager.purgingEnabled (ブール値、デフォルト:false)
    新しいバージョンの作成時にパージを有効にするかどうかを定義します。

  • versionmanager.purgePaths (文字列[]、デフォルト:{"/content"})
    新しいバージョンの作成時にバージョンをパージするパスを指定します。

  • versionmanager.maxAgeDays (int、デフォルト:30)
    バージョンのパージ時に、設定された値より古いバージョンが削除されます。 この値が 1 未満の場合、バージョンの期間に基づいたパージは実行されません。

  • versionmanager.maxNumberVersions (int、デフォルト 5)
    バージョンのパージ時に、n番目の新しいバージョンより古いバージョンが削除されます。 この値が 1 未満の場合、バージョンの数に基づいたパージは実行されません。

  • versionmanager.minNumberVersions (int、デフォルト 0)
    期間にかかわらず保持するバージョン数の最小数。 この値を 1 未満に設定すると、保持するバージョン数の最小数は設定されません。

NOTE
リポジトリに多数のバージョンを保存することはお勧めできません。 そのため、バージョンのパージ操作を設定する際は、パージ対象から多くのバージョンを除外しすぎないでください。そうしないと、リポジトリサイズが適切に最適化されません。 業務上の要件で多数のバージョンを保持する場合は、アドビサポートに連絡して、リポジトリサイズを最適化する代替方法をご相談ください。

保持オプションの組み合わせ combining-retention-options

どのバージョンを保持するかを定義するオプション(maxAgeDaysmaxNumberVersionsminNumberVersions)は、要件に応じて組み合わせることができます。

例えば、保持するバージョンの最大数と保持する最も古いバージョンを組み合わせて定義する場合は、次のようになります。

  • 設定:

    • maxNumberVersions = 7

    • maxAgeDays = 30

  • シナリオは以下の通りです。

    • 過去 60 日以内に 10 個のバージョンが作成されました。
    • そのうちの 3 個が過去 30 日以内に作成されました。
  • 結果は次の通りです。

    • 最新の 3 個のバージョンが保持されます。

例えば、保持するバージョン数の最大数と最小数、および保持する最も古いバージョンを組み合わせて定義する場合は、次のようになります。

  • 設定:

    • maxNumberVersions = 3
    • maxAgeDays = 30
    • minNumberVersions = 3
  • シナリオは以下の通りです。

    • 60 日前に 5 個のバージョンが作成されました。
  • 結果は次の通りです。

    • 最新の 3 個のバージョンが保持されます。

バージョンのパージツール purge-versions-tool

バージョンのパージツールを使用すると、リポジトリ内のノードまたはノードの階層のバージョンをパージすることができます。 このツールの主な目的は、古いバージョンのノードを削除してリポジトリのサイズを縮小することです。

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2