DocumentaciónKCS de Experience Cloud

AEM Cloud Manager: El conflicto de versión del paquete ui.content bloquea la implementación en entornos más bajos

Última actualización: 1 de agosto de 2026

Este artículo explica cómo las versiones de paquetes estáticos impiden la implementación de paquetes ui.content en entornos más bajos en canalizaciones Cloud Manager de Adobe Experience Manager.

Descripción description

Entorno

Adobe Experience Manager (AEM) Cloud Manager (todas las versiones)

Problema/Síntomas

Al implementar a través de canalizaciones de Cloud Manager en entornos más bajos (como Dev, E2E2 o PLRT), el paquete ui.content no se puede cargar si ya existe un paquete con la misma versión. Los registros de implementación no muestran errores, pero el paquete no se reinstala ni actualiza. En las canalizaciones de producción, el mismo paquete se carga correctamente porque se genera una versión con marca de tiempo única para cada compilación.

Extracto de registro de muestra de la producción:

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 ...

Extracto de registro de muestra de entornos inferiores:

Executing command mvn --batch-mode org.apache.maven.plugins:maven-dependency-plugin:3.1.2:resolve-plugins
  • El problema se puede reproducir cuando se construye en entornos más bajos.
  • La versión del proyecto es fija (por ejemplo: 5.0.0) debido a los requisitos de administración de dependencias.
  • No se muestra ningún error, pero el paquete no se actualiza si la versión no cambia.

Para obtener más información, consulte Administración de versiones del proyecto en Cloud Manager y uso de SNAPSHOT en canalizaciones que no son de producción.

Causa

Cloud Manager omite la instalación del paquete en entornos inferiores si la versión del paquete no ha cambiado y ya está presente. Las canalizaciones de producción evitan esto al generar versiones con marca de tiempo única para cada compilación, mientras que los entornos más bajos requieren SNAPSHOT versiones o incrementos de versión manuales para forzar la reinstalación.

Resolución resolution

Siga los pasos a continuación para resolver el problema:

  1. Comprender la administración de versiones de Cloud Manager

    • En las canalizaciones de producción, Cloud Manager genera automáticamente una versión con marca de tiempo única para cada compilación, lo que permite reinstalar los paquetes, incluso si existe una versión anterior.
    • En entornos más bajos, Cloud Manager no incrementa automáticamente las versiones y espera que la versión del proyecto sea -SNAPSHOT para compilaciones de desarrollador.

  2. Opción 1: usar -SNAPSHOT para entornos inferiores

    • Para ramas que solo se usan en entornos inferiores, actualice la versión del proyecto pom.xml para que incluya -SNAPSHOT (por ejemplo: <version>5.0.0-SNAPSHOT</version>).
    • Asegúrese de que todos los módulos (como ui.apps, ui.content) hereden esta versión de SNAPSHOT.
    • Esto permite a Cloud Manager tratarlas como artefactos mutables y reinstalarlas, incluso si la versión no ha cambiado.

  3. Opción 2: Incrementar manualmente la versión para cada implementación

    • Si se requiere el uso de una versión estática (debido a la administración de dependencias u otras directivas), incremente manualmente la versión del proyecto en pom.xml para cada implementación en entornos más bajos.
    • Esto garantiza que Cloud Manager reconozca el paquete como una nueva versión y lo instale.

  4. Revisar y probar

    • Después de realizar el cambio de versiones, déclencheur una nueva implementación de canalización para confirmar que el paquete ui.content se ha cargado e instalado según lo esperado.
recommendation-more-help
experience-cloud-kcs-help-kbarticles