Résolution des avertissements d’utilisation de bibliothèque obsolète pour ch.qos.logback et les API supprimées dans Cloud Manager
Cloud Manager signale une utilisation obsolète de la bibliothèque pour les API ch.qos.logback ou autres API supprimées lors des étapes de création, de qualité du code ou de déploiement. Ces avertissements proviennent de versions obsolètes d’ACS AEM Commons, d’un classificateur Maven incorrect ou d’un code client qui fait directement référence à des API supprimées. Dans certains cas, les références de connexion proviennent de lots de plateformes gérées par Adobe et ne nécessitent aucune modification de la part du client. L’identification de la source exacte (version d’ACS Commons, incohérence des classificateurs, code client ou exécution d’Adobe) détermine le correctif correct.
Description description
Problème : Cloud Manager signale l’utilisation obsolète de ch.qos.logback ou de l’API supprimée lors des contrôles de qualité de la version ou du code
Description
Les alertes du Centre de maintenance Cloud Manager ou les échecs de pipeline indiquent une utilisation obsolète de ch.qos.logback ou d’autres API supprimées. Ces avertissements s’affichent lors de la phase de création sous les contrôles region-deprecated-api ou configuration-api. La cause principale varie : les versions obsolètes d’ACS AEM Commons extraient la journalisation de manière transitoire, le mauvais classificateur Maven est utilisé, les références de code client supprimées sont des API ou des lots internes gérés par Adobe enregistrent la journalisation à l’exécution sans affecter la version.
Environnement :
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- Cloud Manager (pipelines de build, de qualité du code et de déploiement)
- ACS AEM Commons
Problème/Symptômes :
- Les journaux de build de Cloud Manager affichent :
Usage of deprecated package found : ch.qos.logback.* : This internal logback API is not supported by AEM as a Cloud Service - Les journaux d’exécution contiennent des entrées telles que
ServiceEvent REGISTERED [ ch.qos.logback.core.filter.Filter]même lorsque le code client n’utilise pas la fonction de journalisation - La compilation de build échoue avec des erreurs liées aux API obsolètes, telles que
RequestResponseFactory - L’analyseur de code signale les erreurs telles que les
Service.ranking is not of type Integerou les avertissements degroovy-all:2.4.15 - Les échecs du précompilateur JSP apparaissent après la mise à niveau d’ACS Commons :
File tld:http://sling.apache.org/taglibs/sling/1.0 not found
Cause principale :
Des avertissements de bibliothèque obsolètes se produisent lorsque Cloud Manager détecte l’utilisation d’API planifiées pour suppression. Les anciens packages ACS AEM Commons incluent ch.qos.logback de manière transitoire. L’utilisation du classificateur ACS Commons on-prem sur AEMaaCS déclenche également cet avertissement. Les API de référencement de code client obsolètes dans Cloud Service (telles que com.day.cq.contentsync.handler.util.RequestResponseFactory) génèrent des échecs similaires. Les références de connexion à partir des lots de plateformes gérés par Adobe ne provoquent pas de blocs de déploiement et ne nécessitent pas d’action de la part du client.
Comment confirmer
-
Consultez les journaux de build Cloud Manager pour les entrées référençant les versions de bundle
ch.qos.logback.*,groovy-all:2.4.15,com.day.cq.contentsync.handler.utilou ACS Commons . Si les journaux ne sont pas accessibles, téléchargez-les via Pipelines>Cloud Manager>Journaux d’exécution>d’exécution. -
Confirmez la version exacte d’ACS Commons en localisant les lignes telles que les
com.adobe.acs:acs-aem-commons-bundle:5.2.0ou les avertissements faisant référence à la connexion arrière. -
Exécutez une arborescence de dépendance Maven complète pour rechercher les versions en conflit :
code language-none mvn dependency:tree -Dincludes=com.adobe.acs:acs-aem-commons* -
Recherchez des références de connexion directe dans les fichiers détenus par le client :
-
Windows :
code language-none findstr /S /N /I "ch.qos.logback" pom.xml *.xml *.yml *.yaml
-
Résolution resolution
-
Incompatibilité de la version d’ACS Commons ou du classificateur (la plus courante) : vérifiez la
all/pom.xmlde votre projet pour la dépendance ACS Commons . Assurez-vous que<classifier>cloud</classifier>est présent et que la version est au moins6.11.0. L’entrée doit ressembler àcode language-none <groupId>com.adobe.acs</groupId> <artifactId>acs-aem-commons-all</artifactId> <version>6.16.0</version> <classifier>cloud</classifier>
Si des versions en conflit apparaissent dans l’arborescence des dépendances, supprimez toutes les références directes ou transitives aux anciennes versions d’ACS Commons
.
2. Le code client référençant des API supprimées : recherchez dans votre base de code les packages obsolètes indiqués dans les journaux Cloud Manager. Remplacez les utilisations des API supprimées telles que RequestResponseFactory par les API du créateur Sling (org.apache.sling.api.request.builder.Builders ou SlingUriBuilder). Exécutez à nouveau l’analyse du code Cloud Manager pour confirmer qu’aucun avertissement d’API obsolète ne subsiste.
3. Échecs du précompilateur JSP après une mise à jour d’ACS Commons : ajoutez la dépendance Taglib JSP Sling à votre module ui.apps avec scope=provided:
«
<groupId>org.apache.sling</groupId>
<artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
<version>2.4.0</version>
<scope>fournie</scope>
»
Réexécutez le pipeline et vérifiez que l’erreur tld not found a disparu.
4. erreurs de configuration d’aemanalyser sur les versions ultérieures : si la version 1.6.16 renvoie des erreurs telles que Service.ranking is not of type Integer, passez à la version 1.6.4 ou 1.6.14. Exécutez à nouveau le pipeline et vérifiez qu’il se termine sans erreur d’analyseur.
5. groovy-all:2.4.15 marqué comme obsolète : remplacez par la variante de console Orbinson Groovy :
«
<groupId>be.orbinson.aem</groupId>
<artifactId>aem-groovy-console-all</artifactId>
<version>19.0.8</version>
<type>zip</type>
»
’étape Confirmer la qualité du code ne signale aucun avertissement de groovy-all. Si la console Groovy n’est pas en cours d’utilisation, supprimez-la entièrement.
6. Références de connexion depuis les lots gérés par Adobe uniquement : si la qualité du code n’affiche aucun avertissement de bibliothèque obsolète et que les seules entrées de connexion sont des lignes d’exécution seule telles que ServiceEvent REGISTERED [ ch.qos.logback.core.filter.Filter] dans les journaux (sans avertissement à l’étape de création), aucune action n’est requise. Ils proviennent des lots de la plateforme Adobe et ne bloquent pas le déploiement.
7. Valider : démarrer une nouvelle analyse du code ou une exécution complète du pipeline. Confirmer les journaux de génération n’affiche aucune entrée de ch.qos.logback sous region-deprecated-api et aucun avertissement d’API obsolète pour le code client ou ACS Commons.
Lecture connexe
- Fonctionnalités et API obsolètes et supprimées — ch.qos.logback
- Utilisation d’ACS AEM Commons Maven
- Fonctionnalités obsolètes et supprimées
- Notes de mise à jour de la version 2025.8.0 d’Adobe Experience Manager as a Cloud Service
- Notes de mise à jour de la version 2025.9.0 d’Adobe Experience Manager as a Cloud Service