DocumentationExperience Cloud KCS

AEM Cloud Manager : le conflit de version du package ui.content bloque le déploiement dans les environnements inférieurs

Dernière mise à jour : 1 août 2026

Cet article explique comment les versions de package statiques empêchent le déploiement de packages ui.content dans les environnements inférieurs sur les pipelines de Adobe Experience Manager Cloud Manager.

Description description

Environnement

Adobe Experience Manager (AEM) Cloud Manager (toutes les versions)

Problème/Symptômes

Lors d’un déploiement via les pipelines Cloud Manager vers des environnements inférieurs (tels que Dev, E2E2 ou PLRT), le chargement du package ui.content échoue si un package avec la même version existe déjà. Les journaux de déploiement n’affichent pas d’erreurs, mais le package n’est pas réinstallé ni mis à jour. Dans les pipelines de production, le même package est chargé avec succès, car une version horodatée unique est générée pour chaque version.

Exemple d’extrait de journal provenant de l’environnement de production :

Set project version to 5.0.0.2025_0524_1104410_0008467799 from 5.0.0
Executing command mvn --batch-mode org.codehaus.mojo:versions-maven-plugin:2.6:set -DnewVersion=5.0.0.2025_0524_1104410_0008467799 ...

Exemple d’extrait de journal provenant d’environnements inférieurs :

Executing command mvn --batch-mode org.apache.maven.plugins:maven-dependency-plugin:3.1.2:resolve-plugins
  • Le problème est reproductible lors de la création dans des environnements inférieurs.
  • La version du projet est corrigée (par exemple : 5.0.0) en raison d’exigences de gestion des dépendances.
  • Aucune erreur ne s’affiche, mais le package n’est pas mis à jour si la version est inchangée.

Pour plus d’informations, consultez Gestion des versions de projet dans Cloud Manager et SNAPSHOT utilisation dans les pipelines hors production.

Cause

Cloud Manager ignore l’installation du package dans les environnements inférieurs si la version du package est inchangée et déjà présente. Les pipelines de production évitent cela en générant des versions horodatées uniques pour chaque version, tandis que les environnements inférieurs nécessitent des versions SNAPSHOT ou des incréments de version manuels pour forcer la réinstallation.

Résolution resolution

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

  1. Comprendre la gestion des versions de Cloud Manager

    • Dans les pipelines de production, Cloud Manager génère automatiquement une version horodatée unique pour chaque version, ce qui permet de réinstaller les packages, même s’il existe une version précédente.
    • Dans les environnements inférieurs, Cloud Manager n’incrémente pas automatiquement les versions et s’attend à ce que la version du projet soit un -SNAPSHOT pour les builds de développeur.

  2. Option 1 : utiliser -SNAPSHOT pour les environnements inférieurs

    • Pour les branches utilisées uniquement dans les environnements inférieurs, mettez à jour la version pom.xml du projet pour inclure des -SNAPSHOT (par exemple : <version>5.0.0-SNAPSHOT</version>).
    • Assurez-vous que tous les modules (tels que ui.apps et ui.content) héritent de cette version SNAPSHOT.
    • Cloud Manager peut ainsi les traiter comme des artefacts modifiables et les réinstaller, même si la version reste inchangée.

  3. Option 2 : incrémenter manuellement la version pour chaque déploiement

    • Si l’utilisation d’une version statique est requise (en raison de la gestion des dépendances ou d’autres politiques), incrémentez manuellement la version du projet en pom.xml pour chaque déploiement dans des environnements inférieurs.
    • Cela permet à Cloud Manager de reconnaître le package en tant que nouvelle version et de l’installer.

  4. Révision et test

    • Après avoir apporté la modification de version, déclenchez un nouveau déploiement de pipeline pour confirmer que le package ui.content est chargé et installé comme prévu.
recommendation-more-help
experience-cloud-kcs-help-kbarticles