Conflits de déploiement dans MSM

Des conflits peuvent se produire si de nouvelles pages portant le même nom de page sont créées à la fois dans la branche de plan directeur et dans une branche de Live Copy dépendante.

Ces conflits doivent être gérés et résolus lors du déploiement.

Gestion des conflits

Lorsqu’il y a des pages en conflit (dans les branches Plan directeur et Live Copy), MSM permet de définir comment elles doivent être gérées (voire si elles doivent l’être).

Pour vous assurer que le déploiement n’est pas bloqué, les définitions possibles peuvent inclure :

  • Page (Plan directeur et Live Copy) ayant la priorité lors du déploiement

  • Pages renommées (et comment)

  • Impact sur le contenu publié

    Le comportement par défaut d’AEM (version commerciale) est que le contenu publié n’est pas affecté. Ainsi, si une page créée manuellement dans la branche Live Copy a été publiée, ce contenu est toujours publié avec la gestion du conflit et le déploiement.

Outre les fonctionnalités standard, des gestionnaires de conflit personnalisés peuvent être ajoutés pour mettre en œuvre différentes règles. Elles peuvent également permettre des actions de publication sous forme de processus individuel.

Exemple de scénario

Dans les sections suivantes, nous utilisons l’exemple d’une nouvelle page b, créée dans les branches Plan directeur et Live Copy (créée manuellement) pour illustrer les différentes méthodes de résolution des conflits :

  • blueprint: /b

    un gabarit ; avec 1 page enfant, bp-level-1.

  • Live Copy : /b

    une page créée manuellement dans la branche Live Copy ; avec une page enfant, lc-level-1.

    • Activé lors de la publication sous la forme /b, avec la page enfant.

Avant le déploiement

plan directeur avant le déploiement Live Copy avant le déploiement publication avant déploiement
b
(créé dans la branche de plan directeur, prêt pour le déploiement)
b
(créé manuellement dans la branche Live Copy)
b
(contient le contenu de la page b qui a été créée manuellement dans la branche Live Copy)
/bp-level-1 /lc-level-1
(créé manuellement dans la branche Live Copy)
/lc-level-1
(contient le contenu de la page
child-level-1 qui a été créé manuellement dans la branche Live Copy)

Gestionnaire de déploiement et gestion des conflits

Le gestionnaire de déploiement permet d’activer ou de désactiver la gestion des conflits.

Ceci est effectué à l’aide de la configuration OSGi du gestionnaire de déploiement WCM Day CQ:

  • Gérez le conflit avec les pages créées manuellement :

    ( rolloutmgr.conflicthandling.enabled)

    Définissez cette variable sur true si le gestionnaire de déploiement doit gérer les conflits provenant d’une page créée dans la Live Copy avec un nom existant dans le plan directeur.

AEM possède un comportement prédéfini lorsque la gestion des conflits a été désactivée.

Gestionnaires de conflit

AEM utilise des gestionnaires de conflit pour résoudre des conflits de page qui émergent lors du déploiement du contenu du plan directeur vers la Live Copy. L’une des méthodes (habituelles) pour résoudre ce type de conflit est de renommer les pages. Plusieurs gestionnaires de conflit peuvent être opérationnels pour permettre de sélectionner différents comportements.

AEM comporte les éléments suivants :

  • Gestionnaire de conflits par défaut :

    • ResourceNameRolloutConflictHandler
  • Possibilité de mettre en œuvre un gestionnaire personnalisé.

  • Le mécanisme de classement des services qui permet de définir la priorité de chaque gestionnaire individuel. Le service qui possède la valeur la plus élevée est utilisé.

Gestionnaire de conflits par défaut

Le gestionnaire de conflits par défaut :

  • S’appelle ResourceNameRolloutConflictHandler

  • Avec ce gestionnaire, la page du plan directeur prévaut.

  • Le classement des services pour ce gestionnaire est défini sur le bas ( "c.-à-d. sous la valeur par défaut de la propriété service.ranking, car on suppose que les gestionnaires personnalisés auront besoin d’un classement supérieur. Cependant, le classement n’est pas le minimum absolu pour s’assurer de la flexibilité lorsque cela est nécessaire.

Ce gestionnaire de conflits donne la priorité au plan directeur. La page Live Copy /b est déplacée (dans la branche Live Copy) vers /b_msm_moved.

  • Live Copy : /b

    Est déplacé (dans la Live Copy) vers /b_msm_moved. Cela fait office de sauvegarde et permet de s’assurer qu’aucun contenu n’est perdu.

    • lc-level-1 n’est pas déplacé.
  • plan directeur : /b

    est déployé sur la page Live Copy /b.

    • bp-level-1 est déployé dans la Live Copy.

Après le déploiement

plan directeur après le déploiement Live Copy après le déploiement
Live Copy après le déploiement


publier après le déploiement

b b
(contient le contenu de la page de plan directeur b qui a été déployée)
b_msm_moved
(contient le contenu de la page b qui a été créée manuellement dans la branche Live Copy)
b
(aucune modification; contient le contenu de la page d’origine b qui a été créée manuellement dans la branche Live Copy et s’appelle désormais b_msm_moved)
/bp-level-1 /bp-level-1 /lc-level-1
(aucune modification)
/lc-level-1
(aucune modification)

Gestionnaires personnalisés

Les gestionnaires de conflit personnalisés permettent de mettre en œuvre vos propres règles. À l’aide du mécanisme de classement des services, vous pouvez également définir leur mode d’interaction avec les autres gestionnaires.

Les gestionnaires de conflit personnalisés peuvent être :

  • nommés selon vos besoins ; "

  • développés/configurés selon vos besoins, par exemple, vous pouvez développer un gestionnaire de sorte que la page de la Live Copy prévale ;

  • conçus de manière à être configurés à l’aide de la configuration OSGi, en particulier :

    • Classement de service:

      Définit l’ordre associé aux autres gestionnaires de conflit ( service.ranking).

      La valeur par défaut est 0.

Comportement lorsque la gestion des conflits est désactivée

Si vous désactivez manuellement la gestion des conflits, AEM n’intervient pas sur les pages créant un conflit (les pages ne présentant pas de conflit sont déployées comme prévu).

ATTENTION

AEM ne fournit pas d’indication lorsque des conflits sont ignorés, car ce comportement doit être configuré explicitement. Il est donc considéré comme le comportement exigé.

Dans ce cas, la Live Copy prévaut effectivement. La page de plan directeur /b n’est pas copiée et la page Live Copy /b n’est pas touchée.

  • plan directeur : /b

    N’est pas copié du tout et est ignoré.

  • Live Copy : /b

    Reste la même.

Après le déploiement
plan directeur après le déploiement Live Copy après le déploiement


publier après le déploiement

b b
(aucune modification; comporte le contenu de la page b qui a été créée manuellement dans la branche Live Copy).
b
(aucune modification; contient le contenu de la page b qui a été créée manuellement dans la branche Live Copy).
/bp-level-1 /lc-level-1
(aucune modification)
/lc-level-1
(aucune modification)

Classements des services

Le classement des services OSGi peut être utilisé pour définir la priorité des différents gestionnaires de conflit.

Sur cette page