AEM 환경에서 패키지 설치 실패
패키지에 변경 불가능한 경로, 잘못된 ZIP 구조, 설치 후크 또는 영향을 받는 SDK 버전이 포함된 경우 AEM 패키지 설치가 실패합니다. 설치 오류를 진단하고 적절한 해결 단계에 따라 패키지를 설치합니다.
설명 description
환경
- Adobe Experience Manager as a Cloud Service
- AEM Managed Services
- Adobe Developer App Builder
문제/증상
- jcr_root가 누락되었기 때문에 아카이브가 유효한 컨텐츠 패키지가 아님을 나타내는 업로드 중 오류가 발생했습니다.
- 설치 중 패키지 유효성 검사 오류.
- 패키지에 변경할 수 없는 저장소 경로가 포함되어 있어 설치가 차단되었습니다.
- 모든 패키지 내에 임베드된 패키지는 자동으로 설치되지 않습니다.
- 잘못된 패키지 이름으로 인해 패키지 다운로드 오류가 발생했습니다.
- 설치 후크 클래스 누락과 관련된 설치 오류.
원인
설치 실패는 패키지 구조가 잘못되었거나, 패키지에 변경 불가능한 저장소 경로가 포함되어 있거나, 패키지 이름에 지원되지 않는 문자가 포함되어 있거나, 설치 후크가 지원되지 않는 곳에서 사용되거나, 배포가 회귀의 영향을 받는 SDK 버전을 사용하는 경우에 발생합니다.
해결 방법 resolution
이 문제를 해결하려면 다음 단계를 수행합니다.
- 패키지 관리자 메시지 또는 로그를 검토하여 설치 오류를 확인합니다.
- 패키지가 콘텐츠 패키지로 인식되지 않으면
META-INF및jcr_root이(가) ZIP 파일의 최상위 수준에 있는지 확인하십시오. 필요한 경우 패키지를 다시 만듭니다. - 패키지에 변경할 수 없는 저장소 경로가 포함된 경우 패키지 관리자를 통해 직접 설치하지 않고 적절한 배포 파이프라인을 통해 코드를 배포합니다.
- 임베드된 패키지가 자동으로 설치되지 않는 경우 SDK 버전을 확인하고 회귀 수정 사항이 포함된 SDK 버전으로 업그레이드하십시오.
- 설치 후크를 지원하지 않는 환경에 배포할 때 설치 후크를 제거합니다. 지원되는 환경의 경우 필요한 모든 종속성이 설치되어 있는지 확인하십시오.
- 패키지 이름을 업데이트하여 지원되지 않는 문자를 제거하고 다시 배포하기 전에 패키지를 다시 빌드합니다.
- 해당하는 경우 설치 오류가 더 이상 표시되지 않고 임베드된 패키지가 올바르게 설치되는지 확인하여 설치 유효성을 검사합니다.
experience-cloud-kcs-help-kbarticles