Sincronização do conteúdo do ambiente do AEM com a ferramenta Cópia de conteúdo

Última atualização: 24 de junho de 2026

A sincronização de conteúdo entre ambientes do AEMaaCS falha ou produz resultados errados quando a ferramenta Cópia de conteúdo é usada sem seus caminhos de configuração dependentes ou em uma direção de fluxo não compatível. O AEMaaCS separa o código imutável do conteúdo mutável, de modo que os ambientes não podem ser clonados no nível do repositório — o mecanismo compatível é a cópia baseada em caminhos de um ambiente superior para um inferior, que substitui caminhos JCR correspondentes e mesclagens nas quais eles são diferentes. Caminhos dependentes ausentes, como /conf perfis de metadados, causam metadados incorretos após uma sincronização, e copiar de um ambiente inferior para um superior requer que o Fluxo de encaminhamento esteja habilitado. Incluir os caminhos dependentes, confirmar a direção do fluxo e as permissões e validar o ambiente de destino produz uma sincronização confiável e repetível.

Descrição description

Problema: a cópia de conteúdo produz metadados incorretos ou falha entre ambientes do AEM

Descrição

Os clientes sincronizam regularmente o conteúdo dos ambientes de produção para preparo, desenvolvimento ou RDE para testes ou validação. As transferências manuais baseadas em pacotes são lentas, propensas a erros e inadequadas para repositórios DAM grandes. O AEMaaCS fornece a ferramenta Cópia de conteúdo para copiar caminhos JCR mutáveis permitidos de um ambiente superior para um inferior, mas você pode encontrar incompatibilidades de perfis de metadados devido a dependências /conf ausentes, limites de automação (a Cópia de conteúdo é sob demanda por padrão), restrições de fluxo (Produção somente para ambientes inferiores, a menos que o Fluxo de encaminhamento esteja habilitado) e confusão sobre a cópia incremental ou delta, que não é compatível.

Ambiente:

Adobe Experience Manager as a Cloud Service (AEMaaCS)
Fundamentos do AEM Assets
AEM Managed Services
Cloud Manager (Conjuntos de conteúdo e Cópia de conteúdo)

Problema/sintomas:

O conteúdo copiado para o Palco exibe um esquema de metadados incorreto ou valores padrão.
A operação de Cópia de Conteúdo não pode ser iniciada devido a permissões ausentes (Gerenciador de Implantação mais Administrador do AEM) ou a uma direção de fluxo de ambiente indisponível.
Os usuários não podem copiar de um ambiente inferior para um superior, como Dev para Preparo ou Dev para Produção, a menos que o Fluxo de encaminhamento esteja explicitamente habilitado.
As tentativas de automação falham porque a Cópia de conteúdo não tem um scheduler integrado.
As sincronizações baseadas em pacote demoram muito ou falham porque o tamanho do DAM excede os limites do pacote do AEM.

Causa raiz:

O AEMaaCS usa uma separação de código imutável e conteúdo mutável, de modo que o conteúdo do ambiente não pode ser clonado diretamente no nível do repositório. O mecanismo compatível é a cópia baseada em caminhos com a ferramenta Cópia de conteúdo, que substitui o conteúdo de destino para caminhos JCR correspondentes, mescla quando os caminhos diferem e funciona somente de ambientes superiores a inferiores, a menos que o Fluxo de encaminhamento esteja habilitado para fluxos não relacionados à produção. Caminhos dependentes ausentes — como /conf perfis de metadados — causam comportamento inesperado após uma sincronização. A Cópia de conteúdo não é compatível com filtragem do tipo nó ou alterações incrementais; cada execução é uma atualização completa do conjunto de conteúdo definido.

Como confirmar

Confirme a direção do fluxo do ambiente e suas permissões. No Cloud Manager, acesse Programa → Ambientes, selecione a origem e o destino e confirme se a origem é o ambiente de nível superior (Produção → Estágio → Desenvolvimento → RDE). Confirme se o usuário tem as funções de Gerente de implantação e Administrador do AEM abrindo Cloud Manager → Conjuntos de conteúdo e verificando se ele é carregado sem erros de acesso negado.
Identifique os caminhos JCR que devem ser sincronizados — páginas, ativos DAM, tags, fragmentos de experiência e perfis de metadados — e inclua os /conf caminhos correspondentes para evitar incompatibilidades de metadados ou configuração. Os caminhos permitidos são:
- /content/
- /conf/
- /etc/
- /var/workflow/models/
- /var/commerce/

Resolução resolution

Crie um conjunto de conteúdo no Cloud Manager. Vá para Programa → Ambientes → Conjuntos de conteúdo → Adicionar conjunto de conteúdo, adicione todos os caminhos de inclusão necessários e adicione exclusões, se necessário. Abra os detalhes do conjunto de conteúdo e confirme se todos os caminhos correspondem aos seus requisitos. Se a interface bloquear um caminho, confirme se ele é um dos caminhos permitidos acima.
Inicie o processo de cópia de conteúdo. Em Cloud Manager → Cópia de conteúdo, selecione o conjunto de conteúdo e os ambientes de origem e destino e, em seguida, inicie a cópia. O Cloud Manager transfere conteúdo usando um instantâneo do volume do ambiente de origem. A produção permanece totalmente disponível, enquanto o ambiente de destino entra em inatividade durante a sincronização. Monitore o progresso até o status mudar de Em Execução para Concluído.
. Para automação, use as APIs de cópia de conteúdo do Cloud Manager. Chame a API de conjuntos de conteúdo e a API de fluxo de conteúdo pelo Adobe I/O a partir do scheduler externo para executar fluxos diariamente, semanalmente ou mensalmente. Confirme na interface do usuário do Cloud Manager se os fluxos aparecem com carimbos de data e hora correspondentes ao seu scheduler. A sincronização incremental não é compatível, portanto, uma cópia de conteúdo completa é o único método. Validar o ambiente de destino. Faça logon no autor do AEM de destino, navegue até exemplos de caminhos e ativos de conteúdo e confirme se as páginas, os ativos do DAM, os perfis de metadados e os fragmentos de experiência refletem a origem. Para metadados DAM, selecione um ativo, abra Propriedades → Metadados e confirme se o esquema personalizado foi aplicado. Se os metadados estiverem incorretos, execute novamente a cópia do conteúdo, incluindo os caminhos /conf principais. . Sincronizar Autor do Estágio com Publicação do Estágio. Depois que a cópia do Autor de produção para preparo for concluída, replique o conteúdo para preparar a publicação usando a replicação padrão do autor para publicação do AEM. Confirme se o conteúdo aparece no Stage Publish verificando os logs do publicador e abrindo os URLs publicados. Se o conteúdo não for exibido, valide os agentes de replicação no Autor do preparo.

Validação

*1. Faça logon no ambiente de Autor do AEM de destino e confirme se todo o conteúdo esperado existe em /content/. 2. Abra vários ativos DAM e confirme se os esquemas de metadados estão corretos e correspondem à Produção. 3. Se a automação for usada, confirme se os trabalhos do Fluxo de conteúdo do Cloud Manager são exibidos nos intervalos esperados.### Leitura relacionada A Ferramenta de Cópia de Conteúdo

recommendation-more-help

experience-cloud-kcs-help-kbarticles