バージョンのパージ

最終更新日: 2023-09-15
  • トピック:
  • Configuring
    このトピックの詳細を表示
  • 作成対象:
  • Developer

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

メモ

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

リクエストに応じて、 バージョン管理 サイドキックのタブ。 これらのバージョンはリポジトリに保存され、必要に応じて復元できます。

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

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

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

  • バージョンをパージ ツールこれは、リポジトリの監視および保守の一環として使用されます。
    これにより、次のパラメーターに従って、ノードの古いバージョンまたはノードの階層を削除するように介入できます。

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

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

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

注意

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

バージョンマネージャー

パージツールを使用した明示的なパージに加えて、バージョンマネージャーでは、新しいバージョンが作成されたときに古いバージョンをパージするように設定できます。

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

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

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

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

  • versionmanager.ivPaths(String[]、デフォルト:{"/"}
    versionmanager.createVersionOnActivation が true の場合に、アクティベーションによりバージョンが暗黙的に作成されるパスを指定します。

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

  • versionmanager.purgePaths(String[]、デフォルト:{"/content"})
    新しいバージョンが作成された際にバージョンをパージするパスを指定します。

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

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

  • versionmanager.minNumberVersions (整数、デフォルト 0)年齢に関係なく保持されるバージョンの最小数です。 値を 1 未満に設定した場合、保持されるバージョンの最小数はありません。

メモ

多くのバージョンをリポジトリに保持することはお勧めしません。 そのため、バージョンのパージ操作を設定する際は、パージから多くのバージョンを除外しないように注意してください。除外しない場合は、リポジトリのサイズが適切に最適化されません。 ビジネス要件が原因で多数のバージョンを保持している場合は、Adobeサポートに連絡して、リポジトリサイズを最適化する別の方法を見つけてください。

保持オプションの組み合わせ

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

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

  • 設定:

    • maxNumberVersions = 7

    • maxAgeDays = 30

  • 次を使用:

    • 過去 60 日以内に 10 個のバージョンが作成されました
    • 過去 30 日以内に 3 つのバージョンが作成されました
  • つまり、

    • 最後の 3 つのバージョンが保持されます

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

  • 設定:

    • maxNumberVersions = 3
    • maxAgeDays = 30
    • minNumberVersions = 3
  • 次を使用:

    • 5 つのバージョンが 60 日前に作成されました
  • つまり、

    • 3 つのバージョンが保持されます

バージョンのパージツール

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

このページ