XML 및 ClientLib 오류로 인해 AEM Cloud Manager 개발 배포가 실패합니다
이 문서에서는 XML 구문 오류 및 클라이언트 라이브러리 컴파일 문제로 인해 Adobe Experience Manager(AEM) Cloud Manager DEV 환경에서 배포 실패의 원인과 해결 단계에 대해 설명합니다.
설명 description
환경
- Adobe Experience Manager(AEM) Cloud Manager(모든 버전)
문제/증상
-
개발 배포는 평소보다 훨씬 오래(2시간 이상) 걸리고 배포 단계에서 결국 실패합니다.
-
배포 파이프라인은 유효성 검사, 빌드, 단위 테스트, 코드 스캔 및 이미지 빌드 단계를 통과하지만 DEV에 배포 단계에서 실패합니다.
-
배포 로그에는 다음과 같은 콘텐츠 패키지에 있는 누락된 XML 끝 태그와 관련된 오류가 표시됩니다.
요소 형식 "content"는 일치하는 end-tag "
</content>".에 의해 종료되어야 합니다.요소 형식 "header"는 일치하는 end-tag "
</header>".에 의해 종료되어야 합니다. -
XML 구문 분석 오류로 인해 배포 패키지를 가져오지 못했습니다.
-
정의되지 않은 변수(예: @white) 및 누락된 mixin과 같은 클라이언트 라이브러리(ClientLib) LESS 컴파일 오류가 발생합니다.
-
해결되지 않은 사용자 정의 모델 클래스에 대해 Java 컴파일 오류가 발생합니다.
-
이러한 오류는 이전에 존재했지만 배포 실패를 야기하지는 않았습니다. 이제 파이프라인 오류가 발생합니다.
원인
XML 구문 오류(최종 태그 누락), 해결되지 않은 클라이언트 라이브러리 변수 또는 mixin 및 사용자 지정 Java 모델 클래스 누락 때문에 배포 오류가 발생합니다. 최근 파이프라인 또는 환경 변경으로 인해 이전에 차단이 없었던 경우에도 이러한 문제가 배포에 실패할 수 있습니다.
해결 방법 resolution
다음 단계에 따라 문제를 해결하십시오.
- 실패한 배포에 대한 Cloud Manager 파이프라인 실행 로그에 액세스합니다.
- 모든 XML 구문 분석 오류 및 클라이언트 라이브러리 컴파일 오류를 식별합니다.
- 참조된 XML 파일(예:
/conf/.../settings/wcm/templates/아래)을 찾습니다. <content>및<header>과(와) 같은 모든 XML 요소에</content>및</header>과(와) 같은 일치하는 닫는 태그가 포함되어 있는지 확인하십시오.- 변경 내용을 커밋하기 전에 XML 유효성 검사기를 사용하여 XML 구조의 유효성을 검사합니다.
- LESS 및 CSS 파일에서 정의되지 않은 변수(예:
@white및@mid-blue)와 누락된 mixin(예:.label-small-style()및.media())을 검토하십시오. - 누락된 변수 및 mixin을 정의하거나 필요한 정의를 포함하도록 가져오기를 업데이트합니다.
- 클라이언트 라이브러리를 로컬로 다시 빌드하여 성공적으로 컴파일을 확인합니다.
- 구성 요소에서 참조하는 모든 사용자 지정 Sling 모델 클래스가 코드 베이스에 있고 올바르게 가져오는지 확인합니다.
- 누락된 종속성 또는 잘못된 패키지 참조를 해결합니다.
- 필요한 수정 사항을 완료한 후 변경 사항을 저장소에 커밋합니다.
- Cloud Manager에서 새 배포를 트리거하고 파이프라인을 모니터링하여 성공적으로 완료되었는지 확인합니다.