설명서Experience Cloud KCS

AEM Cloud Manager: 콘텐츠 패키지의 잘못된 DocView XML 때문에 'Deploy to Dev’에서 전체 스택 파이프라인이 실패합니다

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

이 문서에서는 콘텐츠 패키지의 잘못된 DocView XML 형식으로 인해 ‘개발로 배포’ 단계 동안 Adobe Experience Manager Cloud 전체 스택 파이프라인의 지속적인 오류를 다룹니다.

설명 description

환경

Adobe Experience Manager(AEM) as a Cloud Service(모든 버전)

문제/증상

Dev에 배포 단계 동안 Cloud 전체 스택 파이프라인이 일관되게 실패합니다. 여러 파이프라인 실행은 동일한 동작을 나타내며, 진행 없이 배포 프로세스가 장시간(예: 1.5시간 이상) 실패하거나 중단됩니다. 실행 가능한 오류 정보가 배포 로그에 표시되지 않습니다.

  • 영향을 받는 환경에 대한 전체 스택 파이프라인을 트리거하여 문제를 재현할 수 있습니다.
  • 로그에 특정 오류 메시지가 표시되지 않습니다. 배포 단계에서 파이프라인이 자동으로 중단되거나 실패한 것으로 표시됩니다.

해결 방법 resolution

  1. 문제가 있는 콘텐츠 패키지 식별

    • 최근에 추가되거나 수정된 패키지를 중심으로 파이프라인에 포함된 콘텐츠 패키지를 검토합니다.
    • 잘못된 형식의 XML을 가져올 수 있는 자동화된 도구에서 생성된 패키지를 확인합니다.

  2. DocView XML 파일 유효성 검사

    • 콘텐츠 패키지를 추출하고 .content.xml개의 파일을 모두 찾습니다.
    • xmllint과(와) 같은 XML 유효성 검사 도구를 사용하여 각 .content.xml 파일의 형식을 확인하십시오.
    code language-none 
    find . -name '*.content.xml' -exec xmllint --noout {} \;
    • 유효성 검사기에서 보고한 모든 XML 구문 오류를 해결합니다.

  3. 향후 문제를 방지하기 위해 빌드 프로세스 업데이트

    • ui.content 모듈이 FileVault 패키지 Maven 플러그인을 사용하여 빌드되었는지 확인합니다.
    • 커밋하거나 배포하기 전에 패키지 구조 및 XML 정확성을 확인하려면 mvn clean verify을(를) 실행하십시오.
    • 참조: AEM 프로젝트 콘텐츠 패키지 구조

  4. CI 파이프라인에 XML 유효성 검사 추가

    • CI 프로세스에서 XML 유효성 검사 단계를 통합하여 배포 전에 모든 .content.xml 파일에 올바른 형식이 있는지 자동으로 검사합니다.

  5. 파이프라인 재실행

    • 잘못된 XML을 수정하고 빌드 프로세스를 업데이트한 후 파이프라인을 다시 트리거하여 성공적인 배포를 확인합니다.

원인

변경 가능한 콘텐츠 패키지에 잘못된 형식의 DocView XML 파일이 있어 파이프라인 오류가 발생했습니다. 이 문제는 Adobe의 분석기 또는 플러그인 툴의 변경 사항이 아니라 배포 단계 동안 문제가 있는 패키지가 처리된 경우에만 나타납니다.

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