バージョンのパージ

最終更新日： 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サポートに連絡して、リポジトリサイズを最適化する別の方法を見つけてください。

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

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

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

設定:
- maxNumberVersions = 7
- maxAgeDays = 30
次を使用：
- 過去 60 日以内に 10 個のバージョンが作成されました
- 過去 30 日以内に 3 つのバージョンが作成されました
つまり、
- 最後の 3 つのバージョンが保持されます

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

設定:
- maxNumberVersions = 3
- maxAgeDays = 30
- minNumberVersions = 3
次を使用：
- 5 つのバージョンが 60 日前に作成されました
つまり、
- 3 つのバージョンが保持されます