Conflits de déploiement dans MSM msm-rollout-conflicts
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 conflict-handling
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 :
-
quelle page (Plan directeur ou Live Copy) a la priorité lors du déploiement
-
quelles pages sont renommées (et comment),
-
comment cela affecte le contenu publié.
Le comportement par défaut d’Adobe Experience Manager (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 example-scenario
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 :
-
Plan directeur :
/bPage principale avec une page enfant, bp-level-1.
-
Live Copy :
/bPage 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.
- Activé lors de la publication sous la forme
Avant le déploiement
Gestionnaire de déploiement et gestion des conflits rollout-manager-and-conflict-handling
Le gestionnaire de déploiement permet d’activer ou de désactiver la gestion des conflits.
Vous pouvez le faire à l’aide de la configuration OSGi du gestionnaire de déploiement gestion du contenu web Day CQ :
-
Gestion des conflits avec les pages créées manuellement :
(
rolloutmgr.conflicthandling.enabled)Définissez sur true si le gestionnaire de déploiement doit gérer des conflits d’une page créée dans la Live Copy portant un nom existant déjà 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 conflict-handlers
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 une sélection de comportements différents.
AEM fournit :
-
Le gestionnaire de conflits par défaut :
ResourceNameRolloutConflictHandler
-
La 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 default-conflict-handler
Le gestionnaire de conflits par défaut :
-
est appelé
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 le postulat de base est que les gestionnaires personnalisés nécessitent 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. La page de la Live Copy /b est déplacée (dans la branche Live Copy) vers /b_msm_moved.
-
Live Copy :
/bEst déplacée (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-1n’est pas déplacé.
-
Plan directeur :
/bEst déployé dans la page Live Copy
/b.bp-level-1est déployé dans la Live Copy.
Après le déploiement
Gestionnaires personnalisés customized-handlers
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 offrent les possibilités suivantes :
-
Vous pouvez les nommer selon vos besoins ;
-
Vous pouvez les développer/configuer selon vos besoins. Vous pouvez, par exemple, développer un gestionnaire pour que la page de la Live Copy soit prioritaire.
-
Vous pouvez les concevoir de manière à les configurer à l’aide de la configuration OSGi, en particulier le :
-
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 behavior-when-conflict-handling-deactivated
Si vous désactivez manuellement la gestion des conflits, AEM n’effectue aucune action sur les pages en conflit (les pages qui ne sont pas en conflit sont déployées normalement).
Dans ce cas, la Live Copy prévaut. La page du plan directeur /b n’est pas copiée, et la page de la Live Copy /b reste intacte.
-
Plan directeur :
/bN’est pas copié du tout et est ignoré.
-
Live Copy :
/bLa même chose.
Classements des services service-rankings
Le classement des services OSGi peut être utilisé pour définir la priorité des différents gestionnaires de conflit.