Restructuration des référentiels dans AEM 6.5

Présentation

Avant la version 6.4 d’AEM, le code client était déployé dans des zones imprévisibles du JCR qui pouvaient faire l’objet de modifications lors des mises à niveau. C’est pourquoi il était courant que les versions d’AEM officielles écrasent le code, la configuration ou le contenu personnalisé. En outre, les modifications apportées aux clients remplaçaient parfois le code ou le contenu du produit AEM, annulant les fonctionnalités du produit.

Il est possible d’éviter ces conflits en définissant clairement les hiérarchies applicables au code du produit AEM et au code client.

À cette fin, à partir de la version 6.4 d’AEM et qui sera poursuivie dans les prochaines versions, le contenu est restructuré depuis /etc vers d’autres dossiers du référentiel, ainsi que des directives sur le contenu à destination, en respectant les règles de haut niveau suivantes :

Le code de produit AEM sera toujours placé dans /libs, qui ne peut pas être écrasé par du code personnalisé.
Le code personnalisé doit être placé dans /apps, /content et /conf.

Impact sur les mises à niveau vers le version 6.5

Lors de la mise à niveau vers AEM 6.5, un sous-ensemble important du contenu sous /etc sera dupliqué dans d’autres dossiers du référentiel. Ces nouveaux emplacements sont les emplacements favoris dans lesquels le contenu est référencé. Cependant, tout a été mis en œuvre pour que la mise à niveau d’AEM 6.5 soit rétrocompatible avec les emplacements précédents du dossier /etc. Ainsi, dans la plupart des cas, les anciens emplacements continueront à être référencés par le code AEM jusqu’à ce que les modifications soient activement - et dans de nombreux cas manuellement - créées dans l’application d’un client. Du point de vue de la chronologie, il existe deux catégories de modifications :

Avec la mise à niveau vers la version 6.5 : quelques modifications de restructuration /etc ne sont pas compatibles avec les versions antérieures. Par conséquent, les modifications doivent être planifiées et implémentées dans le cadre de la mise à niveau d’AEM 6.5.
Avant la mise à niveau ultérieure : la grande majorité des modifications de restructuration /etc peuvent être différées jusqu’à un certain temps après la mise à niveau. Comme mentionné précédemment, le code AEM 6.5 continuera à faire référence aux anciens emplacements jusqu’à ce que les modifications soient implémentées dans le cadre d’une version client. Bien qu’il n’existe pas de calendrier forcé pour lequel les modifications doivent être apportées, il est recommandé de les effectuer avant la mise à niveau ultérieure, car les fonctionnalités futures pourront dépendre des nouveaux emplacements référencés. De plus, par convention, la documentation relative à une fonctionnalité donnée référencera les nouveaux emplacements. Cela pourrait donc prêter à confusion si les anciens emplacements sont toujours utilisés.

Guide de restructuration

Lors de la planification d’une mise à niveau vers AEM 6.5, les pages suivantes par solution doivent être référencées afin d’évaluer le travail :

Chaque page contient deux sections correspondant à l’urgence des modifications nécessaires. Tout élément de la section « Avec la mise à niveau vers la version 6.5 » doit être traité dans le cadre du projet de mise à niveau d’AEM 6.5. Tout ce qui se trouve sous "Avant la mise à niveau vers l’avenir" peut éventuellement être différé jusqu’à après la mise à niveau.

Chaque entrée de la page comprend un champ "Conseil de restructuration", qui détaille la stratégie technique recommandée pour l’alignement avec le nouveau modèle de référentiel 6.5 afin que les nouveaux emplacements soient référencés pour le contenu situé précédemment sous le dossier /etc. Un champ supplémentaire « Remarques » fournit un contexte utile.