설명서Experience Cloud KCS

AEM Cloud 환경 간의 OSGi 구성 로드 및 상속 문제

마지막 업데이트: 2026년 6월 21일

Adobe Experience Manager as a Cloud Service(AEMaaCS)는 환경 간에 값이 누락, 중복 또는 일관되지 않은 경우 OSGi 구성 문제가 발생합니다. 이 문제는 엄격한 실행 모드 기반 해결, Git 기반 배포 및 Pod 수준 구성 로드로 인해 발생합니다. 이 문제를 해결하려면 OSGi 폴더 구조를 수정하고, 실행 모드 이름 지정을 확인하고, 구성을 재배포하여 pod 간에 일관된 동작이 보장되도록 합니다.

설명 description

환경

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

문제/증상

  • OSGi 구성 값은 배포 후 vDeveloper Console에 표시되지 않습니다.
  • 동일한 PID의 여러 인스턴스가 나타납니다(예: com.day.cq.mailer.DefaultMailService, Pod당 하나).
  • 구성은 실행 모드에 따라 작성자에만 로드되거나 게시에만 로드됩니다.
  • 미리보기 값은 기본적으로 상속되지만 게시 값과 일치하지 않습니다.
  • 새 Developer Console UI에 오래된 값이 표시되지만 기본 보기에는 올바른 값이 표시됩니다.

근본 원인

AEMaaCS는 필수 저장소 경로 아래에서 엄격한 실행 모드 기반 폴더 이름 지정을 사용하여 Git에서 OSGi 구성을 확인합니다. 잘못된 폴더, 잘못된 실행 모드 이름 또는 깊은 중첩으로 인해 구성이 검색되지 않습니다. 구성은 Sling JCR 설치 관리자를 통해 pod당 로드되며, 미리보기는 게시 값을 상속합니다. 알려진 제한으로 인해 새 Developer Console UI에 오래된 값이 표시될 수 있습니다.

해결 방법 resolution

다음 단계에 따라 올바른 OSGi 구성 동작 및 배포를 확인합니다.

  1. Git 저장소로 이동하여 OSGi 구성이 ui.config/src/main/content/jcr_root/apps/<project>/osgiconfig에 저장되어 있는지 확인합니다.
  2. 구성 폴더가 config.publish, config.publish.stage 또는 config.author.dev과(와) 같은 올바른 실행 모드 패턴을 따르는지 확인하십시오.
  3. apps/project/test1/test2/config.author과(와) 같이 깊게 중첩된 구성 폴더를 pps/<project>/osgiconfig/config.<runmode>(으)로 이동하여 검색하십시오.
  4. 대상 환경을 식별하고 가장 구체적인 실행 모드가 적용되는지 확인하십시오(예: config.publish.stage 재정의 config.publish).
  5. config.stg.public과(와) 같이 일치하지 않는 실행 모드 이름을 config.publish.stage과(와) 같은 올바른 패턴으로 수정하십시오.
  6. ui.config 모듈과 연결된 Cloud Manager 파이프라인을 실행하여 구성 변경 내용을 배포합니다.
  7. 최신 UI에 부실 데이터가 표시될 수 있으므로 Developer Console 클래식 보기에서 구성 값을 확인하십시오.
  8. 모든 작성자 또는 모든 게시자에 대한 구성 보기를 열고 값이 pod별로 그룹화되어 표시되는지 확인하십시오.
  9. 임시 pod 수준 드리프트가 발생할 수 있으므로 하나의 pod에만 업데이트된 값이 표시되는 경우 파이프라인을 재배포합니다.
  10. 미리 보기가 게시에서 값을 상속하도록 config.preview.* 폴더를 제거하십시오.
  11. 미리 보기별 차이가 필요한 경우 서비스 세트와 함께 환경 변수를 사용하여 미리 봅니다.
  12. Git에서 .cfg.json 파일을 제거하고 파이프라인을 다시 배포하여 구성을 삭제하고 기본값으로 다시 설정합니다.
  13. 삭제 후에도 구성이 지속되면 filter.xml에 mode="replace"을(를) 추가하십시오.
  14. 지정되지 않은 값이 기본값으로 대체되도록 구성 파일에 필수 속성만 포함하는지 확인합니다.
  15. Developer Console Classic 보기의 모든 포드에 모든 유효 구성 값이 올바르게 표시되는지 확인합니다.

에스컬레이션 시기:

  • 폴더 구조의 유효성을 검사하고 파이프라인을 재배포한 후에는 구성 값이 표시되지 않습니다.
  • 올바른 폴더 이름 지정에도 불구하고 실행 모드 확인에 필요한 구성 값이 적용되지 않습니다.
  • 여러 배포 후 업데이트된 구성 값은 일부 pod에만 반영됩니다.
  • 미리 보기별 구성 폴더를 제거한 후 미리 보기는 게시 값을 상속하지 않습니다.
  • 파일을 제거하고 다시 배포한 후에는 구성 삭제가 적용되지 않습니다.
  • Sling 설치 관리자가 구성 리소스를 예상대로 처리하지 않습니다.

관련 읽기

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