Restructuration des référentiels dans AEM 6.5

Présentation

Avant AEM 6.4, 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 AEM officielles remplacent 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 l'AEM 6.4 et à poursuivre dans les versions futures, le contenu est restructuré à partir de /etc vers d'autres dossiers du référentiel, ainsi que des directives sur le contenu qui va où, 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 future - la grande majorité des modifications de la restructuration de /etc peuvent être reportées jusqu'à un certain temps dans l'avenir 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’y ait pas de calendrier forcé pour lequel les modifications doivent être effectuées, il est recommandé de les faire avant la mise à niveau ultérieure, car les fonctions futures peuvent 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 future" peut être reporté à une mise à niveau ultérieure.

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