バージョンのパージ version-purging
標準インストールの場合、コンテンツの更新後にページをアクティベートすると、Adobe Experience Manager(AEM)によってページまたはノードのバージョンが作成されます。
サイドキックの「バージョン管理」タブを使用すると、リクエストに応じて追加のバージョンを作成できます。これらのバージョンはリポジトリに格納され、必要に応じて復元できます。
これらのバージョンはパージされることがなく、時間の経過と共にリポジトリーのサイズが大きくなるので、管理が必要です。
AEM には、リポジトリの管理に役立つ様々なメカニズムが備わっています。
-
バージョンマネージャー
新しいバージョンが作成されると古いバージョンをパージするように設定できます。 -
バージョンのパージツール
リポジトリの監視と保守の一部で使用されます。
このツールを使用すると、次のパラメーターに従って、ノードの古いバージョンまたはノードの階層を削除するためにユーザーが介入できます。-
リポジトリに保持するバージョンの最大数
この数値を超えると、最も古いバージョンが削除されます。 -
リポジトリに保持するバージョンの期間の最大値
バージョンの期間がこの値を超えると、リポジトリからパージされます。
-
-
バージョンパージのメンテナンスタスク。バージョンのパージメンテナンスタスクをスケジュールして、古いバージョンを自動的に削除できます。これにより、バージョンのパージツールを手動で実行する必要性を最小限に抑えることができます。
バージョンマネージャー 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
(整数、デフォルト:30)
バージョンパージで、設定した値より古いバージョンが削除されます。この値が 1 未満の場合、バージョンの期間に基づいたパージは実行されません。 -
versionmanager.maxNumberVersions
(整数、デフォルト:5)
バージョンパージで、n 番目に新しいバージョンより古いバージョンが削除されます。この値が 1 未満の場合、バージョンの数に基づいたパージは実行されません。 -
versionmanager.minNumberVersions
(整数、デフォルト:0)
期間にかかわらず保持するバージョン数の最小数。この値を 1 未満に設定すると、保持するバージョン数の最小数は設定されません。
保持オプションの組み合わせ combining-retention-options
どのバージョンを保持するかを定義するオプション(maxAgeDays
、maxNumberVersions
、minNumberVersions
)は、要件に応じて組み合わせることができます。
例えば、保持するバージョンの最大数と保持する最も古いバージョンを組み合わせて定義する場合は、次のようになります。
-
設定:
-
maxNumberVersions
= 7 -
maxAgeDays
= 30
-
-
シナリオは以下の通りです。
- 過去 60 日以内に 10 個のバージョンが作成されました。
- そのうちの 3 個が過去 30 日以内に作成されました。
-
結果は次の通りです。
- 最新の 3 個のバージョンが保持されます。
例えば、保持するバージョン数の最大数と最小数、および保持する最も古いバージョンを組み合わせて定義する場合は、次のようになります。
-
設定:
maxNumberVersions
= 3maxAgeDays
= 30minNumberVersions
= 3
-
シナリオは以下の通りです。
- 60 日前に 5 個のバージョンが作成されました。
-
結果は次の通りです。
- 最新の 3 個のバージョンが保持されます。
バージョンのパージツール purge-versions-tool
バージョンのパージツールを使用すると、リポジトリ内のノードまたはノードの階層のバージョンをパージすることができます。このツールの主な目的は、古いバージョンのノードを削除してリポジトリのサイズを縮小することです。