DocumentationAEM 6.5Guide de l’utilisateur

Purge de version version-purging

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Dans une installation standard, Adobe Experience Manager (AEM) crée une version d’une page ou d’un nœud lorsque vous activez une page après la mise à jour du contenu.

NOTE
Si le contenu n’est pas modifié, un message s’affiche indiquant que la page a été activée, mais qu’aucune nouvelle version n’est créée.

Vous pouvez créer des versions supplémentaires sur demande à l’aide de l’onglet Contrôle de version du sidekick. Ces versions sont stockées dans le référentiel et peuvent être restaurées si nécessaire.

Ces versions ne sont jamais purgées. La taille du référentiel augmente au fil du temps et doit donc être gérée.

AEM est fourni avec divers mécanismes pour vous aider à gérer votre référentiel :

  • Le gestionnaire de versions
    Il peut être installé pour supprimer les anciennes versions lorsque de nouvelles versions sont créées.

  • L’outil Purger les versions
    Sert dans le cadre de la surveillance et de la maintenance du référentiel.
    Il vous permet d’intervenir et de supprimer les anciennes versions d’un nœud ou d’une hiérarchie de nœuds, en fonction des paramètres suivants :

    • Le nombre maximal de versions à conserver dans le référentiel.
      Une fois ce nombre dépassé, la version la plus ancienne est supprimée.

    • L’âge maximal des versions conservées dans le référentiel.
      Lorsque l’âge d’une version dépasse cette valeur, elle est purgée du référentiel.

  • La tâche de maintenance Purge de version. Vous pouvez planifier la tâche de maintenance Purge de version pour supprimer automatiquement les anciennes versions. Ainsi, cela réduit la nécessité d’utiliser manuellement les outils de purge de version.

CAUTION
Pour optimiser la taille du référentiel, vous devez exécuter la tâche de purge des versions fréquemment. La tâche doit être planifiée en dehors des heures de bureau lorsqu’il y a un trafic limité.

Gestionnaire de versions version-manager

Outre la purge explicite à l’aide de l’outil dédié, le gestionnaire de versions peut être configuré pour purger les anciennes versions lors de la création de nouvelles versions.

Pour installer le gestionnaire de versions, créez une configuration pour :

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

Les options suivantes sont disponibles :

  • versionmanager.createVersionOnActivation (booléen, valeur par défaut : true)
    Spécifie si vous souhaitez créer une version lorsque des pages sont activées.
    Une version est créée sauf si l’agent de réplication est configuré pour supprimer la création de versions, qui est prise en charge par le gestionnaire de versions.
    Une version est créée uniquement si l’activation s’effectue sur un chemin qui est contenu dans versionmanager.ivPaths (voir ci-dessous).

  • versionmanager.ivPaths(Chaîne[], valeur par défaut : {"/"})
    Spécifie les chemins d’accès sur lesquels des versions sont créées implicitement lors de leur activation si la valeur de versionmanager.createVersionOnActivation est true.

  • versionmanager.purgingEnabled (booléenne, valeur par défaut : false)
    Définit s’il faut activer la purge lors de la création de nouvelles versions.

  • versionmanager.purgePaths (Chaîne[], valeur par défaut : {"/content"})
    Indique sur quels chemins d’accès purger les versions lorsque de nouvelles versions sont créées.

  • versionmanager.maxAgeDays (int, valeur par défaut : 30)
    Lors de la purge, toute version antérieure à cette valeur est supprimée. Si cette valeur est inférieure à 1, la purge n’est pas effectuée sur la base de l’âge de la version.

  • versionmanager.maxNumberVersions (int, valeur par défaut : 5)
    Lors de la purge, toute version antérieure à la n-ième dernière version est supprimée. Si cette valeur est inférieure à 1, la purge n’est pas effectuée sur la base du nombre de versions.

  • versionmanager.minNumberVersions (int, valeur par défaut : 0)
    Nombre minimum de versions à conserver, indépendamment de l’âge. Si cette valeur est inférieure à 1, aucun nombre minimum de versions n’est conservé.

NOTE
Il n’est pas recommandé de conserver de nombreuses versions dans le référentiel. Par conséquent, lors de la configuration de l’opération de purge de version, veillez à ne pas exclure un trop grand nombre de versions de la purge, faute de quoi la taille du référentiel ne sera pas correctement optimisée. Si vous conservez un grand nombre de versions en raison d’exigences métier, contactez l’assistance technique d’Adobe pour trouver d’autres moyens d’optimiser la taille du référentiel.

Combinaison d’options de conservation combining-retention-options

Les options qui définissent la manière dont les versions doivent être conservées (maxAgeDays, maxNumberVersions, minNumberVersions) peuvent être combinées en fonction de vos besoins.

Par exemple, lors de la définition du nombre maximal de versions à conserver ET de la version la plus ancienne à conserver :

  • Configuration :

    • maxNumberVersions = 7

    • maxAgeDays = 30

  • Avec :

    • Dix versions ont été créées au cours des 60 derniers jours.
    • Trois de ces versions ont été créées au cours des 30 derniers jours.

  • Cela signifie que :

    • Les trois dernières versions sont conservées.

Par exemple, pour définir le nombre maximal ET minimal de versions à conserver ET définir la version la plus ancienne à conserver :

  • Configuration :

    • maxNumberVersions = 3
    • maxAgeDays = 30
    • minNumberVersions = 3

  • Avec :

    • Cinq versions ont été créées il y a 60 jours.

  • Cela signifie que :

    • Trois versions sont conservées.

Outil Purge de version purge-versions-tool

L’outil Purge de version est destiné à purger les versions d’un nœud ou d’une hiérarchie de nœuds dans votre référentiel. Son objectif premier est de vous aider à réduire la taille de votre référentiel en supprimant les anciennes versions de vos nœuds.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2