설명서Experience Cloud KCS

색인 업데이트 중 AEM as a Cloud Service 파이프라인 오류 해결

마지막 업데이트: 2026년 8월 27일

이 문서에서는 사용자 지정 또는 확장된 색인 정의를 배포한 후 색인 업데이트 단계 중에 발생하는 AEM as a Cloud Service Cloud Manager 파이프라인의 오류를 해결하는 방법에 대해 설명합니다. 이 지침에서는 성공적인 배포를 보장하는 일반적인 원인과 실행 가능한 단계를 다룹니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service (AEMaaCS)

문제/증상

  • 새 색인 정의를 검색하는 데 문제가 있음을 나타내는 오류가 있는 파이프라인 오류
  • 인덱스 구성 파일과 관련된 유효성 검사 경고

원인

근본 원인에는 종종 사용자 정의 색인 정의와 대상 환경의 기본 제공(OOTB) 색인 버전 간의 불일치, 불완전하거나 잘못된 Tika 구성, 부적절한 색인 이름 지정 및 버전 관리 사례 등이 포함됩니다.

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. 사용자 정의 인덱스 정의를 대상 환경의 OOTB 인덱스 정의와 비교합니다. 대상 환경과 동일하거나 최신 릴리스를 실행하는 AEM as a Cloud Service 환경에서 최신 OOTB 인덱스 정의(예: damAssetLucene-14)를 가져옵니다.
  2. 사용자 지정 변경 내용을 최신 OOTB 정의에 병합하고 적절한 버전이 지정된 사용자 지정 이름(예: damAssetLucene-14-custom-2)을 지정합니다. 개발 환경의 OOTB 버전이 다른 환경의 버전과 일치한다고 가정하지 마십시오.
  3. 사용자 지정 색인 정의에서 Tika 구성의 유효성을 검사합니다. application/xml로 설정된 tika/ 폴더, config.xml, jcr:content, jcr:data 및 jcr:mimeType을 포함하여 전체 Tika 하위 트리가 있고 유효한지 확인하십시오. 부분 재정의 또는 빈 config.xml 노드를 사용하지 마십시오.
  4. 사용자 지정 색인에 대한 AEM as a Cloud Service 이름 지정 규칙을 따르십시오. 완전히 맞춤화된 색인의 경우 고유한 사용자 지정 이름 및 버전을 사용하십시오(예: -custom-1). OOTB 인덱스 확장의 경우 OOTB 이름 지정 및 버전 지정 패턴을 사용합니다. 배포된 인덱스 노드의 이름을 클라우드 환경에서 바로 바꾸거나 삭제하지 마십시오.
  5. 모든 인덱스 정의가 ui.apps/src/main/content/jcr_root/_oak_index 아래에 있으며 변경할 수 있는 콘텐츠 패키지가 아니라 애플리케이션 코드 패키지에 포함되어 있는지 확인합니다. 패키지 메타데이터에 allowIndexDefinitions=true 및 noIntermediateSaves=true가 포함되어 있는지 확인합니다. 모든 인덱스 정의는 클라우드 호환 Lucene 구성 및 지원되는 비동기 설정(예: [ async] , [ async,nrt] 또는 [ fulltext-async] )을 사용해야 합니다.
  6. 수정된 패키지를 더 낮은 환경에 배포하고 배포가 성공적으로 완료되었는지, 예상 인덱스 정의가 있는지, 쿼리에서 의도한 인덱스를 사용하는지 확인합니다.
  7. 이전 인덱스 정의를 폐기하려면 인덱스 노드의 이름을 직접 바꾸거나 삭제하지 마십시오. 대신 Cloud Manager을 통해 별도의 코드 변경으로 퇴직을 처리합니다. filter.xml에서만 항목을 제거해도 배포된 인덱스 데이터가 제거되지 않습니다. 후속 규격 색인 정의를 사용하여 이전 색인을 비활성화하고 주기적 정리에 적합하도록 만듭니다.

이러한 단계를 완료한 후 파이프라인을 다시 실행하고 배포가 성공하고 의도한 색인이 활성 상태인지 확인합니다.

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