설명서Experience Cloud KCS

환경 변수는 Adobe Experience Manager의 OSGi 구성에서 보간되지 않습니다

마지막 업데이트: 2026년 7월 24일

Adobe Experience Manager as a Cloud Service(AEMaaCS), AEM Managed Services(AMS) 및 Adobe Developer App Builder에서 환경 변수가 표시되지 않거나 OSGi 구성으로 보간되지 않거나 null 값을 반환합니다. $[ env:VAR] 및 $[ secret:VAR]과(와) 같은 자리 표시자 값은 문자 그대로 로그에 표시되며, Cloud Manager에서는 AMS 환경에서 환경 변수를 구성할 수 없습니다. 이 문제를 해결하려면 AEM 변형을 식별하고 환경 변수 구성을 확인하고 OSGi 구현 요구 사항을 확인합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service (AEMaaCS)

문제/증상

  • 환경 변수 값은 로그에 $[ secret:ACCESS_KEY] 또는 $[ env:AEM_EXTERNALIZER_LIVE]과(와) 같은 리터럴 자리 표시자로 나타납니다.
  • Cloud Manager에서는 AMS 환경에서 환경 변수를 추가하거나 편집할 수 없습니다.
  • 환경 변수는 OSGi 구성에서 확인되지 않습니다.
  • 비밀 값이 null을 반환하거나 해결되지 않은 상태로 유지됩니다.
  • 부울 환경 변수 대체가 작동하지 않습니다.

해결 방법 resolution

이 문제를 해결하려면 다음 단계를 수행합니다.

  1. Cloud Manager에서 AEM 변형을 식별하고 프로그램이 AEM as a Cloud Service(AEMaaCS)인지 AEM Managed Services(AMS)인지 확인합니다.
  2. AEMaaCS 환경의 경우 Cloud Manager > 환경 > [ 환경 선택] > 구성을 엽니다.
  3. 필수 환경 변수 또는 비밀이 존재하고 OSGi 구성에 사용된 이름과 일치하는지 확인합니다.
  4. OSGi 구성을 검토하고 지원되는 자리 표시자 구문 $[ env:VAR] 또는 $[ secret:VAR]을(를) 사용하는지 확인하십시오.
  5. 부울 속성에서 환경 변수 대체를 사용하지 않는지 확인합니다. 환경별 구성에 부울 값을 저장하거나 고객 구현
  6. OSGi 구성에서 @ObjectClassDefinition 및 @Designate 주석을 사용하며 구성이 PID에 올바르게 매핑되었는지 확인하십시오.
  7. AMS 환경의 경우 Cloud Manager 런타임 환경 변수 대신 파이프라인 변수를 사용하고 ${env.VAR_NAME}을(를) 사용하여 Maven에서 참조합니다.
  8. 구성을 읽는 애플리케이션 구성 요소를 트리거하고 로그에 리터럴 자리 표시자 대신 확인된 값 또는 마스킹된 비밀이 표시되는지 확인합니다.

관련 읽기

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