Documentação

Os mapeamentos sling no local falham após a migração para o AEMaaCS

Last update: Mon Aug 25 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

A migração de mapeamentos do sling de uma configuração do AEM no local para o Adobe Experience Manager as a Cloud Service (AEMaaCS) apresenta problemas de compatibilidade devido à natureza imutável do ambiente de nuvem. Para resolver o problema, reestruture e implante os mapeamentos do sling usando o formato compatível com a nuvem compatível.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS) - Sites

Problema/Sintomas

  • Os mapeamentos para vários caminhos e domínios não geram URLs corretos.
  • Os mapeamentos de encaminhamento e reversão em /etc/map não funcionam no AEMaaCS.
  • Os URLs de saída parecem incorretos, mas são redirecionados para o destino correto.
  • Os URLs de entrada se comportam corretamente, mas o comportamento de saída é inconsistente.
  • O AEMaaCS exige que os mapeamentos do Sling sejam implantados por meio de código devido à imutabilidade do AEMaaCS.

Resolução resolution

Siga estas etapas para converter e implantar mapeamentos do sling compatíveis com o AEMaaCS:

  1. Exporte mapeamentos sling existentes do diretório /etc/map local para um pacote .zip.

  2. Adicione o pacote .zip exportado à sua base de código do projeto em your_project/ui.content/src/main/content/jcr_root/.

  3. Renomeie a pasta de mapa dentro do diretório etc para map.publish.

  4. Atualize a configuração do Apache Sling Resource Resolver para fazer referência a /etc/map.publish como o local de mapeamento.

    1. Crie ou atualize o JSON de configuração OSGi para o PID org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl.
    2. Defina resource.resolver.map.location como /etc/map.publish.
    3. Opcionalmente, atualize resource.resolver.mapping com qualquer valor de matriz personalizado se estiver migrando a lógica de mapeamento do JCR.

  5. Salve todas as alterações e implante a base de código atualizada usando o Adobe Cloud Manager para enviar as alterações para o AEMaaCS.

  6. Teste os mapeamentos minuciosamente nos ambientes de desenvolvimento e de preparo para garantir que os URLs de entrada e de saída se comportem corretamente antes da implantação na produção.

Leitura relacionada

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