Documentation

Panne du service RDE après le déploiement d’AEM en raison de lots OSGi manquants

Last update: Fri Nov 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Le déploiement du code dans l’environnement de l’outil RDE d’Adobe Experience Manager as a Cloud Service (AEMaaCS) entraîne une panne du service lorsque les lots OSGi tiers tels que io.jsonwebtoken ne sont pas résolus en raison de contraintes de zone géographique d’API plus strictes. Pour résoudre ce problème, incorporez les fichiers JAR requis dans votre projet à l’aide de Bundle-ClassPath ou -conditionalpackage, redéployez à l’aide de aio aem:rde:install et vérifiez que toutes les dépendances sont résolues avec succès.

Description description

Environnement

  • Produit : Adobe Experience Manager as a Cloud Service (AEMaaCS) - Sites
  • Context : RDE (environnement de développement rapide)
  • Outils : commande aio aem:rde:install pour le déploiement

Remarque : les instances cloud standard et les déploiements locaux ne sont pas affectés.

Problème/Symptômes

  • L’environnement du RDE ne répond plus après le déploiement à l’aide de aio aem:rde:install.

  • L’instance affiche un message de « panne du service ».

  • Le redémarrage ou la réinitialisation de l’instance ne résout pas le problème.

  • Les journaux d’erreurs affichent les dépendances de lots OSGi tiers non résolues liées à io.jsonwebtoken.

  • Les dépendances se résolvent dans les environnements cloud locaux et standard, mais échouent dans le RDE en raison de contraintes de région d’API plus strictes.

  • Extrait du journal des erreurs :

    Unable to resolve fpaec-aem-base-components.core 645: missing requirement fpaec-aem-base-components.core [ 645] osgi.wiring.package; (&(osgi.wiring.package=io.jsonwebtoken)(version>=0.11.0)(!(version>=1.0.0)))

Résolution resolution

Pour résoudre ce problème, procédez comme suit :

  1. Examinez les contraintes de zone géographique de l’API appliquées par le RDE. Ces contraintes limitent la visibilité des packages et bloquent l’accès aux lots tiers tels que io.jsonwebtoken.

  2. Incorporez les bibliothèques tierces requises dans votre projet. Utilisez -conditionalpackage ou Bundle-ClassPath pour inclure les fichiers JAR suivants :

    • lib/jjwt-api-0.11.2.jar
    • lib/jjwt-impl-0.11.2.jar
    • lib/jjwt-jackson-0.11.2.jar

  3. Ajoutez les instructions suivantes à votre fichier bnd.bnd :

    code language-none 
    Bundle-ClassPath: .,
  lib/jjwt-api-0.11.2.jar,
  lib/jjwt-impl-0.11.2.jar,
  lib/jjwt-jackson-0.11.2.jar
    code language-none 
    -conditionalpackage: \
  io.jsonwebtoken;version="0.11.2", \
  io.jsonwebtoken.security;version="0.11.2"

  4. Déployez le package mis à jour à l’aide de aio aem:rde:install. Vérifiez que toutes les dépendances sont résolues et que la panne de service n’a plus lieu.

  5. Testez le déploiement dans les environnements de création et de publication pour garantir la stabilité.

Lecture connexe

Utilisation de l’environnement de développement rapide dans AEM

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f