DocumentaçãoKCS da Experience Cloud

AEM Cloud Manager: o conflito de versão do pacote ui.content bloqueia a implantação em ambientes inferiores

Última atualização: 1 de agosto de 2026

Este artigo explica como as versões de pacotes estáticos impedem a implantação de pacotes do ui.content em ambientes inferiores nos pipelines do Adobe Experience Manager Cloud Manager.

Descrição description

Ambiente

Adobe Experience Manager (AEM) Cloud Manager (todas as versões)

Problema/Sintomas

Ao implantar por meio dos pipelines do Cloud Manager em ambientes inferiores (como Dev, E2E2 ou PLRT), o pacote ui.content não será carregado se um pacote com a mesma versão já existir. Os logs de implantação não mostram erros, mas o pacote não é reinstalado ou atualizado. Nos pipelines de produção, o mesmo pacote é carregado com êxito porque uma versão com carimbo de data e hora exclusiva é gerada para cada build.

Exemplo de trecho de log da Produção:

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

Exemplo de trecho de log de Ambientes Inferiores:

Executing command mvn --batch-mode org.apache.maven.plugins:maven-dependency-plugin:3.1.2:resolve-plugins
  • O problema pode ser reproduzido ao criar em ambientes inferiores.
  • A versão do projeto foi corrigida (por exemplo: 5.0.0) devido a requisitos de gerenciamento de dependência.
  • Nenhum erro é exibido, mas o pacote não é atualizado se a versão não for alterada.

Para obter mais detalhes, consulte Manuseio de Versão de Projeto no Cloud Manager e uso de SNAPSHOT em pipelines de não produção.

Causa

O Cloud Manager ignora a instalação do pacote em ambientes inferiores se a versão do pacote não for alterada e já estiver presente. Os pipelines de produção evitam isso gerando versões com carimbo de data e hora exclusivas para cada compilação, enquanto os ambientes inferiores exigem SNAPSHOT versões ou incrementos de versão manuais para forçar a reinstalação.

Resolução resolution

Siga as etapas abaixo para resolver o problema:

  1. Entender o Manuseio de Versão do Cloud Manager

    • Nos pipelines de produção, o Cloud Manager gera automaticamente uma versão exclusiva com carimbo de data e hora para cada build, permitindo que os pacotes sejam reinstalados, mesmo que uma versão anterior exista.
    • Em ambientes inferiores, o Cloud Manager não incrementa automaticamente versões e espera que a versão do projeto seja um -SNAPSHOT para compilações de desenvolvedores.

  2. Opção 1: usar -SNAPSHOT para ambientes inferiores

    • Para ramificações usadas somente em ambientes inferiores, atualize a versão do projeto pom.xml para incluir -SNAPSHOT (Por exemplo: <version>5.0.0-SNAPSHOT</version>).
    • Verifique se todos os módulos (como ui.apps, ui.content) herdam esta versão SNAPSHOT.
    • Isso permite que o Cloud Manager os trate como artefatos mutáveis e os reinstale, mesmo que a versão não seja alterada.

  3. Opção 2: incrementar manualmente a versão para cada implantação

    • Se for necessário usar uma versão estática (devido ao gerenciamento de dependência ou outras políticas), incremente manualmente a versão do projeto em pom.xml para cada implantação em ambientes inferiores.
    • Isso garante que a Cloud Manager reconheça o pacote como uma nova versão e o instale.

  4. Análise e teste

    • Depois de fazer a alteração de controle de versão, acione uma nova implantação de pipeline para confirmar se o pacote ui.content foi carregado e instalado conforme esperado.
recommendation-more-help
experience-cloud-kcs-help-kbarticles