사용자 지정 Oak/Lucene 인덱스 문제로 인해 AEM as a Cloud Service 파이프라인이 실행 중 상태에서 중단됨
이 문서에서는 사용자 지정 Oak/Lucene 인덱스 문제로 인해 Adobe Experience Manager(AEM) as a Cloud Service 배포 파이프라인이 실행 중 상태로 유지되는 상황을 해결하는 방법을 설명합니다.
설명 description
환경
Adobe Experience Manager as a Cloud Service(AEMaaCS), Cloud Manager 파이프라인을 사용하는 모든 버전.
문제/증상
- Cloud Manager 배포 파이프라인은 장기간 실행 중 상태로 유지되며 완료되지 않습니다.
- 환경 준비 검사가 차단되어 파이프라인이 진행되지 않습니다.
- 인덱싱 작업 로그에 다음과 같은 오류가 표시됩니다.
Error while processing an index write operation java.io.IOException: Invalid byte range request for [ /oak:index/cqPageLucene-custom-1] ...
- 파일 시스템 오류:
java.nio.file.NoSuchFileException
/oak:index/cqPageLucene-custom-1및/oak:index/damAssetLucene-11-custom-4과(와) 같은 사용자 지정 인덱스 노드는 현재 코드 베이스에 없는 경우에도 저장소에 표시됩니다.- 이러한 인덱스 노드를 CRXDE에서 수동으로 삭제하는 것은 재배포 후 다시 나타날 수 있기 때문에 일시적일 뿐입니다.
원인
사용자 지정 Oak/Lucene 색인이 손상되었거나 일관되지 않아 환경 준비 검사를 완료할 수 없으므로 파이프라인이 차단됩니다. 이렇게 하면 색인화 작업이 완료되지 않고 파이프라인이 실행 중 상태로 남아 있습니다. 인덱스 노드를 수동으로 삭제하는 것은 영구적이지 않습니다. 제대로 제거하려면 코드베이스를 업데이트하고 지원되는 인덱스 관리 접근 방식을 사용해야 합니다.
해결 방법 resolution
아래 단계에 따라 문제를 해결하십시오.
- 인덱싱 작업 로그를 검토하고
/oak:index/cqPageLucene-custom-1과(와) 같은 사용자 지정 인덱스와 관련된 오류를 식별하십시오. 인덱스 노드가ui.apps/src/main/content/jcr_root/_oak_index/의 코드 베이스에 있는지diff.json파일에 있는지 확인합니다. cqPageLucene-custom-1또는damAssetLucene-11-custom-4과(와) 같이 문제가 있는 인덱스에 대한 정의를 리포지토리에서 검색합니다._oak_index또는 인덱스 콘텐츠 패키지에서 이러한 정의를 삭제한 다음 변경 내용을 커밋하십시오.- 간소화된 색인 관리 모델을 사용하여
/oak:index/diff.index/diff.json의 모든 사용자 지정 색인 변경 사항을 표현합니다. Cloud Manager을 통해 업데이트된 코드를 배포합니다. - 코드베이스를 정리하고
diff.json에 의도한 사용자 지정만 있는지 확인한 후 Cloud Manager을 통해 다시 배포하십시오. 색인 손상이 남아 있지 않은 경우 파이프라인이 정상적으로 완료되어야 합니다. - 문제가 지속되면 로그에서 파일 시스템 오류 또는 Lucene 세그먼트 손상을 검토하십시오. 문제가 있는 런타임 노드를 제거하고 다시 배포하여 영향을 받는 인덱스를 다시 빌드합니다.
- 재배포 후 파이프라인이 정상적으로 완료되고 환경이 준비됨으로 표시되어야 합니다.
참고
- 플랫폼은 필요에 따라 새
*-custom-*노드를 생성하고 시간이 지남에 따라 사용하지 않은 이전 버전을 자동으로 삭제합니다. - 코드베이스 또는
diff.json이(가) 계속 참조하는 경우 노드를 나중에 배포하는 동안 다시 만들 수 있으므로 영구 솔루션으로 CRXDE에서 인덱스 노드를 수동으로 삭제하지 마십시오.
experience-cloud-kcs-help-kbarticles