설명서Experience Cloud KCS

AEM Cloud Manager: ui.content 패키지 버전 충돌이 하위 환경에서의 배포를 차단합니다

마지막 업데이트: 2026년 8월 1일

이 문서에서는 정적 패키지 버전이 Adobe Experience Manager Cloud Manager 파이프라인의 하위 환경에서 ui.content 패키지 배포를 방지하는 방법을 설명합니다.

설명 description

환경

Adobe Experience Manager(AEM) Cloud Manager(모든 버전)

문제/증상

Cloud Manager 파이프라인을 통해 더 낮은 환경(예: Dev, E2E2 또는 PLRT)으로 배포할 때 동일한 버전의 패키지가 이미 있는 경우 ui.content 패키지가 업로드되지 않습니다. 배포 로그에 오류가 표시되지는 않지만 패키지가 다시 설치되거나 업데이트되지는 않습니다. 프로덕션 파이프라인에서는 각 빌드에 대해 고유한 타임스탬프가 지정된 버전이 생성되므로 동일한 패키지가 성공적으로 업로드됩니다.

프로덕션에서 샘플 로그 추출:

Set project version to 5.0.0.2025_0524_1104410_0008467799 from 5.0.0
Executing command mvn --batch-mode org.codehaus.mojo:versions-maven-plugin:2.6:set -DnewVersion=5.0.0.2025_0524_1104410_0008467799 ...

하위 환경에서 발췌한 샘플 로그:

Executing command mvn --batch-mode org.apache.maven.plugins:maven-dependency-plugin:3.1.2:resolve-plugins
  • 낮은 환경에 구축할 때 이 문제가 재현될 수 있습니다.
  • 종속성 관리 요구 사항으로 인해 프로젝트 버전이 수정되었습니다(예: 5.0.0).
  • 오류가 표시되지 않지만 버전이 변경되지 않으면 패키지가 업데이트되지 않습니다.

자세한 내용은 Cloud Manager의 프로젝트 버전 처리 및 비프로덕션 파이프라인의 SNAPSHOT 사용을 참조하십시오.

원인

패키지 버전이 변경되지 않고 이미 존재하는 경우 Cloud Manager은 낮은 환경에서 패키지 설치를 건너뜁니다. 프로덕션 파이프라인은 각 빌드에 대해 고유한 타임스탬프가 지정된 버전을 생성하여 이를 방지하지만, 하위 환경에서는 강제로 다시 설치하려면 SNAPSHOT 버전 또는 수동 버전 증분이 필요합니다.

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. Cloud Manager 버전 처리 이해

    • 프로덕션 파이프라인에서 Cloud Manager은 각 빌드에 대해 고유한 타임스탬프가 지정된 버전을 자동으로 생성하므로, 이전 버전이 있더라도 패키지를 다시 설치할 수 있습니다.
    • 낮은 환경에서는 Cloud Manager이 버전을 자동으로 증가시키지 않으며 프로젝트 버전이 개발자 빌드의 -SNAPSHOT이(가) 될 것으로 예상됩니다.

  2. 옵션 1: 낮은 환경에 -SNAPSHOT 사용

    • 하위 환경에서만 사용되는 분기의 경우 -SNAPSHOT을(를) 포함하도록 pom.xml 프로젝트 버전을 업데이트하십시오(예: <version>5.0.0-SNAPSHOT</version>).
    • 모든 모듈(예: ui.apps, ui.content)이 이 SNAPSHOT 버전을 상속하는지 확인하십시오.
    • 이렇게 하면 Cloud Manager은 버전이 변경되지 않은 경우에도 이러한 아티팩트를 변경 가능한 아티팩트로 처리하고 다시 설치할 수 있습니다.

  3. 옵션 2: 각 배포에 대해 버전을 수동으로 증가

    • 종속성 관리 또는 기타 정책으로 인해 정적 버전을 사용해야 하는 경우 낮은 환경으로 배포하기 위해 각 배포에 대해 pom.xml의 프로젝트 버전을 수동으로 증가시키십시오.
    • 이렇게 하면 Cloud Manager이 패키지를 새 버전으로 인식하고 설치합니다.

  4. 검토 및 테스트

    • 버전 관리를 변경한 후 새 파이프라인 배포를 트리거하여 ui.content 패키지가 예상대로 업로드되고 설치되었는지 확인합니다.
recommendation-more-help
experience-cloud-kcs-help-kbarticles