DocumentationExperience Cloud KCS

AEM as a Cloud Service : le composant est déployé localement, mais pas dans le cloud en raison de l’incohérence des versions de SDK.

Dernière mise à jour : 16 octobre 2026

✨ Ce contenu est généré par l’IA et peut être inexact. Termes IA génératifs

Cet article explique pourquoi un composant AEM personnalisé peut être déployé avec succès sur un SDK local, mais ne pas apparaître dans les environnements cloud, en se concentrant sur les incohérences de version de SDK et sur la manière de les résoudre.

Description description

Environnement

  • Adobe Experience Manager as a Cloud Service
  • Version locale de SDK : 2026.3.*
  • Version de Cloud SDK : 2026.8.*

Symptômes

  • Un composant personnalisé (par exemple, compte à rebours) est déployé avec succès sur l’instance AEM Cloud SDK locale.
  • Le composant n’apparaît pas après le déploiement dans les environnements cloud.
  • Aucun message d’erreur spécifique n’est signalé, mais le composant est manquant dans l’environnement cloud après l’exécution du pipeline.
  • Le déploiement local fonctionne comme prévu ; le déploiement dans le cloud n’inclut pas le composant .

Procédure à suivre

  1. Déployez le composant Compte à rebours sur une instance AEM Cloud SDK locale (2026.3.*).
  2. Déployez la même base de code dans un environnement cloud à l’aide de Cloud SDK (2026.8.*).
  3. Notez que le composant est présent localement, mais manquant dans l’environnement cloud.

Cause

Une incohérence entre les versions du SDK local et cloud peut entraîner des incohérences de déploiement, souvent dues à des modifications importantes ou des incompatibilités introduites dans les versions SDK les plus récentes.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème.

  1. Assurez-vous que le composant personnalisé et ses dépendances sont compatibles avec la version 2026.8.* de Cloud SDK.
  2. Consultez les notes de mise à jour d’AEM as a Cloud Service SDK pour connaître les modifications entre la version 2026.3.et la version 2026.8..
  3. Vérifiez que le composant Compte à rebours est inclus dans le code de base et n’est exclu par aucun filtre de build ou de déploiement (comme dans filter.xml).
  4. Vérifiez que le composant est présent dans le package créé (.zip ou .jar) avant le déploiement.
  5. Accédez aux journaux d’exécution du pipeline Cloud Manager pour rechercher les erreurs ou les avertissements liés au déploiement du composant, ainsi que les installations de packages ignorées ou ayant échoué.
  6. Configurez une instance AEM locale à l’aide de la version de Cloud SDK (2026.8.*) et tentez de déployer le composant.
  7. Si le problème se reproduit localement sur la version 2026.8.*, recherchez les problèmes de compatibilité ou de dépendance.
  8. Refactorisez ou mettez à jour le composant pour résoudre les problèmes de compatibilité identifiés avec la nouvelle version de SDK.
  9. Recréez et redéployez le package.

Après avoir suivi ces étapes, vérifiez que le composant apparaît dans l’environnement cloud.

recommendation-more-help
experience-cloud-kcs-help-kbarticles