DocumentaçãoKCS da Experience Cloud

Problemas de carregamento e herança da configuração do OSGi em ambientes da AEM Cloud

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

O Adobe Experience Manager as a Cloud Service (AEMaaCS) encontra problemas de configuração do OSGi quando os valores aparecem ausentes, duplicados ou inconsistentes entre os ambientes. Isso ocorre devido à resolução rigorosa baseada em modo de execução, implantação orientada por Git e carregamento da configuração no nível do pod. Para resolver o problema, corrija a estrutura de pastas do OSGi, valide a nomeação do modo de execução e reimplante as configurações para garantir um comportamento consistente em todos os pods.

Descrição description

Ambiente

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Adobe Managed Services (AMS)

Problema/Sintomas

  • Os valores de configuração do OSGi não aparecem no vDeveloper Console após a implantação.
  • Várias instâncias do mesmo PID são exibidas, como com.day.cq.mailer.DefaultMailService, uma por pod.
  • As configurações são carregadas somente no Autor ou somente na Publicação, dependendo do modo de execução.
  • Os valores de visualização não correspondem aos valores de Publicar, mesmo que sejam herdados por padrão.
  • A nova interface do Developer Console mostra valores obsoletos, enquanto a exibição clássica mostra valores corretos.

Causa raiz

O AEMaaCS resolve configurações OSGi do Git usando a nomenclatura de pasta baseada em modo de execução rigorosa no caminho do repositório necessário. Pastas fora do lugar, nomes de modo de execução incorretos ou aninhamento profundo impedem a detecção de configuração. As configurações são carregadas por pod por meio do Sling JCR Installer e a Visualização herda os valores de Publicação. A nova interface do Developer Console pode exibir valores obsoletos devido a uma limitação conhecida.

Resolução resolution

Siga estas etapas para garantir o comportamento correto da configuração e da implantação do OSGi:

  1. Navegue até o repositório Git e verifique se as configurações OSGi estão armazenadas em ui.config/src/main/content/jcr_root/apps/<project>/osgiconfig.
  2. Verifique se as pastas de configuração seguem o padrão de modo de execução correto, como config.publish, config.publish.stage ou config.author.dev.
  3. Mova todas as pastas de configuração aninhadas profundamente, como apps/project/test1/test2/config.author, para pps/<project>/osgiconfig/config.<runmode> para garantir a detecção.
  4. Identifique o ambiente de destino e verifique se o modo de execução mais específico se aplica, por exemplo, config.publish.stage substitui config.publish.
  5. Corrija qualquer nome de modo de execução incompatível, como config.stg.public, para um padrão válido como config.publish.stage.
  6. Execute o pipeline do Cloud Manager associado ao módulo ui.config para implantar alterações de configuração.
  7. Verifique os valores de configuração na visualização clássica do Developer Console porque a interface do usuário mais recente pode mostrar dados obsoletos.
  8. Abra o modo de exibição de configuração para Todos os autores ou Todos os editores e confirme se os valores aparecem agrupados por pod.
  9. Reimplante o pipeline se apenas um pod mostrar valores atualizados, pois pode ocorrer um descompasso temporário no nível do pod.
  10. Remova todas as pastas config.preview.* para que a Visualização herde valores de Publicar.
  11. Use variáveis de ambiente com o conjunto de serviços para visualizar se é necessária uma diferenciação específica de visualização.
  12. Remova o arquivo .cfg.json do Git e reimplante o pipeline para excluir uma configuração e redefini-la para o padrão.
  13. Adicione mode="replace" em filter.xml se a configuração persistir após a exclusão.
  14. Certifique-se de que os arquivos de configuração incluam apenas as propriedades necessárias para que os valores não especificados retornem aos padrões.
  15. Valide se todos os valores de configuração efetivos aparecem corretamente em todos os pods na exibição clássica do Developer Console.

Quando escalonar:

  • Os valores de configuração não aparecem após validar a estrutura de pastas e reimplantar o pipeline.
  • A resolução do modo de execução não aplica os valores de configuração esperados apesar da nomeação correta da pasta.
  • Somente alguns pods refletem valores de configuração atualizados após várias implantações.
  • A visualização não herda valores de Publicação após remover as pastas de configuração específicas da visualização.
  • A exclusão da configuração não tem efeito após a remoção de arquivos e a reimplantação.
  • O Sling Installer não processa os recursos de configuração conforme esperado.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles