Documentação

Falha no pipeline de implantação do AEM devido à propriedade de configuração OSGi inválida

Last update: Thu Nov 13 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Os pipelines de implantação nos ambientes de Preparo e Produção falham durante a subetapa Update services após serem executados por algum tempo. Para corrigir isso, atualize ou remova a chave vazia do arquivo de configuração e implante novamente pelo Cloud Manager.

Descrição description

Ambiente

  • Adobe Experience Manager (AEM) as a Cloud Service
  • Pipelines de CI/CD do Cloud Manager (Preparo/Produção)
  • Iniciador de recursos do Sling

Problema/Sintomas

  • Falha do pipeline de implantação com uma mensagem de problema do sistema .
  • A falha ocorre na subetapa Update services após mais de 2 horas de execução.

Causa

  • O Inicializador de recursos do Sling falha ao inicializar devido a uma propriedade de configuração OSGi inválida na base de código do projeto.

  • Veja um exemplo onde um arquivo de configuração OSGi tem uma chave de propriedade vazia,

    code language-none 
    {
                "scheduler.expression": "0 0 6 * * ?",
                "job.enabled": true,
                "": "notifications@example.com",
                "emailName": "System Reminder",
                "emailSubject": "Reminder",
                "emailMessage": "This is an automated reminder for your content."
            }

A propriedade vazia ("") faz com que o AEM falhe ao analisar a configuração durante a inicialização, o que leva ao erro de pipeline na etapa Update services.

Resolução resolution

Para resolver o problema, atualize ou remova a propriedade inválida no arquivo de configuração afetado.

  1. Abra o arquivo de configuração afetado, normalmente encontrado em:

    ui.config/src/main/content/jcr_root/apps/<project-name>/osgiconfig/config.<runmode>/
    Consulte Configuração de OSGi para Adobe Experience Manager as a Cloud Service para obter mais detalhes.

  2. Remova ou corrija a propriedade inválida.

    Exemplo (correção da propriedade)

    code language-none 
    {
                "scheduler.expression": "0 0 6 * * ?",
                "job.enabled": true,
                "recipientEmail": "notifications@example.com",
                "emailName": "System Reminder",
                "emailSubject": "Reminder",
                "emailMessage": "This is an automated reminder for your content."
            }

    Importante: nunca inclua segredos, senhas, chaves de API ou outras informações confidenciais diretamente nos arquivos de configuração OSGi. Para gerenciar com segurança valores confidenciais, use Variáveis de ambiente na Cloud Manager.

  3. Confirme e reimplante a configuração corrigida por meio do Cloud Manager. Consulte Implantação no AEM as a Cloud Service no Guia do Usuário do AEM as a Cloud Service para obter mais detalhes.

Depois de corrigir a configuração, o pipeline deve ser executado com sucesso.

Observações adicionais

  • Valide as configurações JSON localmente antes de confirmar, usando ferramentas como jsonlint ou validação baseada em IDE.
  • Verifique se todos os nomes de propriedades não estão vazios, são exclusivos e foram digitados corretamente.
  • Revise os logs de build do AEM as a Cloud Service no Cloud Manager para detectar problemas de configuração antecipadamente.
  • Mantenha configurações específicas do ambiente colocando-as em config.<runmode> pastas (por exemplo, config.author, config.publish).
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f