설명서Experience Cloud KCS

잘못된 도커 컨텍스트 아카이브 패키징으로 인해 Cloud Manager에서 생략된 사용자 정의 UI 테스트를 위한 AEM 솔루션

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

테스트가 로컬에서 실행되더라도 Cloud Manager이 사용자 정의 UI 테스트를 건너뛸 경우, 생성된 UI 테스트 도커 컨텍스트 아카이브가 아카이브 루트가 아닌 상위 디렉토리 내에 필요한 파일과 함께 패키지될 수 있습니다. 아카이브 구조를 확인하고 Maven 어셈블리 구성을 업데이트하면 Cloud Manager에서 테스트 감지가 복원됩니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service

문제/증상

이 문제는 일반적으로 Cloud Manager이 생성된 도커 컨텍스트 보관 위치에서 UI 테스트 옵트인 파일을 감지할 수 없을 때 나타납니다.

  • 사용자 정의 UI 테스트 단계는 소스 코드 저장소에서 테스트를 찾을 수 없어 UI 테스트를 건너뛰었다는 것과 유사한 메시지를 표시합니다.
  • 극작가, Cypress, Selenium 또는 기타 지원되는 UI 테스트는 로컬에서 실행되지만 UI 테스트 실행은 Cloud Manager에 표시되지 않습니다.
  • testing.properties 파일이 저장소에 있지만 Cloud Manager에서 테스트를 건너뜁니다.
  • UI 테스트 모듈을 빌드하고 생성된 *-ui-test-docker-context.tar.gz 파일 내에 testing.properties이(가) 저장된 위치를 확인하여 문제를 확인할 수 있습니다. tar -tvf target/*-ui-test-docker-context.tar.gz | grep testing.properties 실행. 결과에 testing.properties이(가) 아닌 some-folder/testing.properties과(와) 같은 경로가 표시되면 보관 파일이 잘못 패키지됩니다.
  • testing.properties이(가) UI 테스트 모듈에서 pom.xml 파일 옆에 저장되어 있고 정확히 ui-tests.version=1을(를) 포함하는지 확인하여 구성을 확인할 수도 있습니다.

해결 방법 resolution

문제를 해결하려면 다음 단계를 수행하십시오.

  1. 파이프라인이 UI 테스트 모듈에 대해 올바른 Git 분기를 사용하고 있는지 확인합니다. 파이프라인은 ui.tests 모듈과 testing.properties이(가) 포함된 분기를 사용해야 합니다. 파이프라인 구성 및 다음 파이프라인 실행 요약에서 이를 확인합니다.
  2. UI 테스트 모듈 pom.xml 파일 옆에 testing.properties이(가) 있고 정확히 ui-tests.version=1을(를) 포함하는지 확인하십시오. 필요한 값이 있는 파일이 올바른 모듈에 표시됩니다. 저장소에서 직접 확인합니다.
  3. Docker 컨텍스트 아카이브가 생성되도록 UI 테스트 모듈을 로컬로 빌드합니다. target 모듈 디렉터리에 -ui-test-docker-context.tar.gz(으)로 끝나는 파일이 표시됩니다. 생성된 보관 파일에서 ui-test-docker-context 분류자를 사용하는지 확인하십시오.
  4. 생성된 보관 파일을 검사하고 tar -tvf target/*-ui-test-docker-context.tar.gz | grep testing.properties을(를) 실행하여 testing.properties이(가) 보관 루트에 저장되어 있는지 확인합니다. 상위 폴더 접두사가 없는 testing.properties만 표시됩니다. 출력에서 some-folder/testing.properties과(와) 같은 경로를 표시하는 경우 보관 파일이 잘못 패키지됩니다. 다음 단계로 진행합니다.
  5. Docker 컨텍스트가 보관 루트에 패키지되도록 assembly-ui-test-docker-context.xml을(를) 업데이트합니다. 어셈블리가 <includeBaseDirectory>false</includeBaseDirectory>을(를) 유지하고 Dockerfile 및 wait-for-grid.sh과(와) 같은 루트 수준 파일이 있는 testing.properties을(를) 포함하는지 확인하십시오. 래퍼 디렉터리 대신 아카이브의 최상위 수준에 저장된 필수 파일이 표시됩니다. 모듈을 다시 빌드하고 testing.properties이(가) 루트에 나타날 때까지 보관 검사를 반복하여 확인합니다.
  6. 패키징 변경 사항을 커밋하고 파이프라인에서 사용하는 분기에 푸시한 다음 파이프라인을 다시 실행합니다. 건너뛰기 메시지를 표시하지 않고 Custom UI Testing 단계를 실행해야 합니다. 파이프라인 실행 세부 정보에서 이를 확인하고 UI 테스트 로그를 사용할 수 있는지 확인합니다.
  7. 이제 테스트가 감지되었지만 실행 중에 실패한 경우 파이프라인 실행에서 UI 테스트 로그를 검토하고 테스트 또는 프레임워크별 오류를 수정합니다. Cloud Manager에서 테스트 이미지를 검색하여 성공적으로 실행해야 합니다. 파이프라인에 건너뛴 단계가 아닌 실제 UI 테스트 실행이 표시되는지 확인하여 이를 확인합니다.

다음 증상이 발생하고 문제 해결 단계에서 다음 결과를 생성하는 경우 Adobe 지원에 티켓을 제출하십시오. 보관 파일의 루트에 testing.properties이(가) 표시되고 파이프라인이 올바른 분기를 사용하고 있으며 Cloud Manager에서 UI 테스트가 발견되지 않았다고 보고합니다.

지원 센터에 문의할 때 보관 목록, assembly-ui-test-docker-context.xml 파일, UI 테스트 모듈 pom.xml 및 파이프라인 실행 URL을 포함합니다.

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