DocumentaciónKCS de Experience Cloud

Las variables de entorno no interpolan en las configuraciones de OSGi en Adobe Experience Manager

Última actualización: 24 de julio de 2026

En Adobe Experience Manager as a Cloud Service (AEMaaCS), AEM Managed Services (AMS) y Adobe Developer App Builder, las variables de entorno no aparecen, no se interpolan en las configuraciones de OSGi o devuelven valores nulos. Los valores de marcador de posición como $[ env:VAR] y $[ secret:VAR] aparecen literalmente en los registros y Cloud Manager no permite la configuración de variables de entorno en entornos de AMS. Para solucionar este problema, identifique la variante de AEM, valide la configuración de la variable de entorno y compruebe los requisitos de implementación de OSGi.

Descripción description

Entorno

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problema/Síntomas

  • Los valores de las variables de entorno aparecen como marcadores de posición literales, como $[ secret:ACCESS_KEY] o $[ env:AEM_EXTERNALIZER_LIVE], en los registros.
  • Cloud Manager evita agregar o editar variables de entorno en entornos de AMS.
  • Las variables de entorno no se resuelven en las configuraciones de OSGi.
  • Los valores secretos devuelven un valor nulo o permanecen sin resolver.
  • La sustitución de variables de entorno booleano no funciona.

Resolución resolution

Para solucionar este problema, siga estos pasos:

  1. Identifique la variante de AEM en Cloud Manager y confirme si el programa es AEM as a Cloud Service (AEMaaCS) o AEM Managed Services (AMS).
  2. Para entornos AEMaaCS, abra Cloud Manager > Entornos > [ Seleccionar entorno] > Configuración.
  3. Compruebe que existen las variables de entorno o los secretos necesarios y que coinciden con los nombres utilizados en la configuración OSGi.
  4. Revise la configuración de OSGi y confirme que utiliza la sintaxis de marcador de posición $[ env:VAR] o $[ secret:VAR] admitida.
  5. Compruebe que las propiedades booleanas no utilizan la sustitución de variables de entorno. Almacenar valores booleanos en configuraciones específicas del entorno o implementar clientes
  6. Confirme que la configuración de OSGi utiliza anotaciones @ObjectClassDefinition y @Designate, y que la configuración está asignada correctamente al PID.
  7. Para entornos de AMS, utilice Variables de canalización en lugar de variables de entorno de tiempo de ejecución de Cloud Manager y haga referencia a ellas en Maven con ${env.VAR_NAME}.
  8. Almacene en déclencheur el componente de la aplicación que lee la configuración y compruebe que los registros muestran valores resueltos o secretos enmascarados en lugar de marcadores de posición literales.

Lectura relacionada

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