설명서

AEMaaCS의 오래된 캐시 및 오래된 frontend-maven-plugin 버전으로 인해 파이프라인 빌드가 실패합니다

Last update: Thu Nov 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

UI.frontend 모듈을 실행하는 동안 AEMaaCS(Adobe Experience Manager as a Cloud Service)에서 파이프라인 빌드가 실패합니다. 오래된 캐시 참조와 오래된 frontend-maven-plugin 버전에서 오류가 발생했습니다. 로컬 빌드는 성공하지만 되돌려진 파일에 대한 참조 및 오래된 frontend-maven-plugin 버전의 오류로 인해 파이프라인 오류가 발생합니다. 플러그인을 업그레이드하고 클린 빌드를 수행하면 문제가 해결됩니다.

설명 description

환경

  • 제품: Adobe Experience Manager as a Cloud Service(AEMaaCS)
  • 시나리오: UI.frontend 모듈에 대한 Cloud Manager 파이프라인 실행
  • 버전: Java 11, Node v16.20.2, frontend-maven-plugin 1.12.0

문제/증상

  • Cloud Manager 실행 중에 UI.frontend 모듈에서 파이프라인 빌드가 일관되게 실패합니다.
  • 오류 메시지: frontend-maven-plugin을(를) 통해 npm 실행 프로덕션을 실행하는 동안 오류를 보고합니다.
  • 빌드 로그에는 확인되지 않은 Maven 플러그인 버전 및 누락된 아티팩트 종속성이 표시됩니다.
  • 컴파일 오류가 삭제되거나 되돌린 SCSS 파일(예: pdplayoutcontainer.scss 및 pdpbutton.scss)을 참조합니다.
  • 부실 캐시는 저장소에 더 이상 존재하지 않는 오래된 파일에 대한 참조를 유지하므로 빌드가 일치하지 않습니다.

해결 방법 resolution

다음 단계에 따라 문제를 해결하십시오.

  1. pom.xml 모듈에 대한 UI.frontend 파일을 열고 frontend-maven-plugin 버전을 1.12.0에서 1.15.0 이상으로 업그레이드하십시오.

  2. Cloud Manager에서 파이프라인 변수 CM_DISABLE_BUILD_REUSE을(를) true(으)로 설정하여 이전 빌드 아티팩트의 재사용을 비활성화합니다.

  3. 기본 빌드가 시작되기 전에 파이프라인 구성에 정리 단계를 추가합니다.

    • ui.frontend/dist 디렉터리를 삭제합니다.
    • ui.frontend/target 디렉터리를 삭제합니다.
    • ui.frontend/node_modules/.cache 디렉터리를 삭제합니다.

  4. pom.xml의 모든 Maven 플러그인에 명시적 버전 번호가 있는지 확인하십시오.

  5. 참조된 모든 종속성을 Maven 저장소에서 사용 및 액세스할 수 있는지 확인합니다.

  6. 새 파이프라인 실행을 트리거하고 삭제된 파일에 대한 오류 또는 참조 없이 성공적으로 완료되었는지 확인합니다.

참고: 컴파일 오류가 계속되면 새 빌드를 트리거하기 전에 SCSS 가져오기 및 변수 정의에서 완성도 및 정확성을 검토하십시오.

관련 읽기

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f