DocumentaçãoKCS da Experience Cloud

As variáveis de ambiente não interpolam nas configurações de OSGi no Adobe Experience Manager

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

No Adobe Experience Manager as a Cloud Service (AEMaaCS), AEM Managed Services (AMS) e Adobe Developer App Builder, as variáveis de ambiente não são exibidas, não são interpoladas nas configurações OSGi ou retornam valores nulos. Valores de espaço reservado como $[ env:VAR] e $[ secret:VAR] aparecem literalmente nos logs, e o Cloud Manager não permite a configuração de variável de ambiente em ambientes AMS. Para corrigir esse problema, identifique a variante do AEM, valide a configuração da variável de ambiente e verifique os requisitos de implementação do OSGi.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problema/Sintomas

  • Os valores da variável de ambiente aparecem como espaços reservados literais, como $[ secret:ACCESS_KEY] ou $[ env:AEM_EXTERNALIZER_LIVE] em logs.
  • O Cloud Manager impede a adição ou edição de variáveis de ambiente em ambientes AMS.
  • As variáveis de ambiente não são resolvidas nas configurações do OSGi.
  • Os valores secretos retornam nulo ou permanecem não resolvidos.
  • A substituição da variável de ambiente booleano não funciona.

Resolução resolution

Para corrigir esse problema, siga estas etapas:

  1. Identifique a variante do AEM no Cloud Manager e confirme se o programa é o AEM as a Cloud Service (AEMaaCS) ou o AEM Managed Services (AMS).
  2. Para ambientes AEMaaCS, abra Cloud Manager > Ambientes > [ Selecionar ambiente] > Configuração.
  3. Verifique se as variáveis de ambiente necessárias ou os segredos existem e correspondem aos nomes usados na configuração do OSGi.
  4. Revise a configuração OSGi e confirme se ela usa a sintaxe de espaço reservado com suporte $[ env:VAR] ou $[ secret:VAR].
  5. Verifique se as propriedades booleanas não usam substituição de variável de ambiente. Armazenar valores booleanos em configurações específicas do ambiente ou implementar clientes
  6. Confirme se a configuração OSGi usa anotações @ObjectClassDefinition e @Designate e se ela está mapeada corretamente para o PID.
  7. Para ambientes AMS, use Variáveis de pipeline em vez de variáveis de ambiente de tempo de execução do Cloud Manager e faça referência a elas no Maven com ${env.VAR_NAME}.
  8. Acione o componente do aplicativo que lê a configuração e verifique se os registros mostram valores resolvidos ou segredos mascarados em vez de espaços reservados literais.

Leitura relacionada

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