Conflits de déploiement

Des conflits peuvent apparaître si de nouvelles pages portant le même nom de page sont créées 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 :

  • La page (Plan directeur ou Live Copy) ayant la priorité lors du déploiement
  • Les pages renommées (et comment elles le seront)
  • L’impact sur le contenu publié.

Le comportement par défaut d’AEM prêt à l’emploi 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. Ils peuvent également permettre des actions de publication sous la forme d’un 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 (avec création manuelle) pour illustrer les différentes méthodes de résolution des conflits :

  • blueprint: /b

    Un gabarit avec une 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 le déploiement
Valeur b b b
Commentaire Création dans la branche du plan directeur, prêt pour le déploiement Création manuelle dans la branche Live Copy Contient le contenu de la page b créée manuellement dans la branche Live Copy
Valeur /bp-level-1 /lc-level-1 /lc-level-1
Commentaire Création manuelle dans la branche Live Copy Contient le contenu de la page child-level-1 créée 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. Définissez la valeur Gérer un conflit avec des pages créées manuellement (rolloutmgr.conflicthandling.enabled ) sur true si le gestionnaire de déploiement doit gérer les conflits d’une page créée dans la Live Copy qui porte un nom déjà présent 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. Le changement de nom des pages est la méthode habituelle (mais pas la seule) pour résoudre de tels conflits. Plusieurs gestionnaires de conflit peuvent être opérationnels pour permettre une sélection de comportements différents.

AEM fournit :

  • Le gestionnaire de conflit 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 est ResourceNameRolloutConflictHandler

  • Avec ce gestionnaire, la page du plan directeur prévaut.
  • Le classement des services pour ce gestionnaire est défini sur Bas, c’est-à-dire en dessous de la valeur par défaut pour la propriété service.ranking, car l’hypothèse est que les gestionnaires personnalisés doivent posséder un classement supérieur. Cependant, le classement n’est pas le minimum absolu pour garantir de la flexibilité lorsque cela est nécessaire.

Ce gestionnaire de conflits donne la priorité au plan directeur. Par exemple, la page de la 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é.
  • Blueprint: /b

    Est déployé dans la page Live Copy /b.

    • bp-level-1 est déployé dans 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 Publication après le déploiement
Valeur b b b_msm_moved b
Commentaire Contient le contenu de la page du plan directeur b qui a été déployée Contient le contenu de la page b créée manuellement dans la branche Live Copy Aucune modification, contient le contenu de la page d’origine b qui a été créée manuellement dans la branche Live Copy et est maintenant appelée b_msm_moved
Valeur /bp-level-1 /bp-level-1 /lc-level-1 /lc-level-1
Commentaire Aucune modification Aucune modification

Gestionnaires personnalisés

Les gestionnaires de conflit personnalisés permettent de mettre en œuvre vos propres règles. Grâce au mécanisme de classement des services, vous pouvez également définir la manière dont ils interagissent avec d’autres gestionnaires.

Les gestionnaires de conflit personnalisés peuvent :

  • 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 Live Copy soit prioritaire.
  • conçus de manière à être configurés à l’aide de la configuration OSGi, en particulier :
    • Classement des services 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’engage aucune action concernant les pages en conflit. Les pages ne provoquant pas de conflits sont déployées comme prévu.

ATTENTION

Lorsque la gestion des conflits est désactivée, AEM n’indique pas que les conflits sont ignorés. Dans de tels cas, ce comportement doit être explicitement configuré, il est supposé correspondre au comportement souhaité.

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

  • Blueprint: /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 Publication après le déploiement
Valeur b b b
Commentaire Aucune modification, contient le contenu de la page b créée manuellement dans la branche Live Copy Aucune modification, contient le contenu de la page b créée manuellement dans la branche Live Copy
Valeur /bp-level-1 /lc-level-1 /lc-level-1
Commentaire Aucune modification 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