설명서Experience Cloud KCS

미리보기 dispatcher가 준비되지 않은 경우 Cloud Manager 파이프라인이 중단되고 실패합니다

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

이 문서에서는 미리보기 Dispatcher가 제시간에 준비되지 않을 때 몇 시간 동안 시작 상태로 유지되었다가 실패하는 AEM as a Cloud Service 배포 파이프라인을 해결하는 방법에 대해 설명합니다.

설명 description

환경

  • Adobe Experience Manager (AEM) as a Cloud Service
  • 관리되는 재작성 맵과 함께 dispatcher 구성을 사용하는 Cloud Manager 배포 파이프라인

문제/증상

  • 배포 파이프라인은 실패하기 전에 오랜 기간 동안 시작 또는 준비 중 상태로 유지됩니다.
  • Dispatcher 시작 및 준비 검사 오류가 content/dam/rewrites/redirects과(와) 관련된 로그에 표시됩니다.
  • Cloud Manager은 오랜 지연 후에 일반 배포 실패 메시지를 표시합니다.
The deployment failed due to a system issue. Contact Adobe Support if the issue recurs.
  • 빌드 및 코드 품질 단계가 성공적으로 완료되지만 이후에 배포가 정상적으로 진행되지 않습니다.
  • 이 문제는 동일한 분기 또는 코드가 이전 실행에서 성공적으로 배포된 경우에도 발생할 수 있습니다.
  • 프로젝트에서 관리되는 다시 작성 맵을 사용하고 미리 보기 Dispatcher 시작이 지연될 때 이러한 문제가 발생할 수 있습니다.

재현 조건

  • Cloud Manager을 사용하여 개발 환경에 코드(이전의 성공한 코드)를 배포하려고 합니다.
  • 미리보기 디스패처 또는 관련 미리보기 서비스가 예상 기간 내에 정상이 되지 않습니다.
  • 긴 대기 후에 파이프라인이 실패하거나, 비정상적으로 긴 런타임으로 정상적으로 완료됩니다.

원인

미리보기 Dispatcher 컨테이너가 준비 상태에 도달하지 않아 Cloud Manager이 시간 초과가 발생할 때까지 기다리므로 배포 파이프라인이 중단되고 결국 실패합니다. Dispatcher YAML 구성을 업데이트하여 대기 플래그를 false로 설정하면 파이프라인을 차단하지 않고 미리보기 Dispatcher를 시작할 수 있습니다.

해결 방법 resolution

관리되는 재작성 맵에서 미리 보기 Dispatcher 시작 차단으로 인해 발생하는 파이프라인 지연 및 오류를 수정하려면 다음 단계를 수행합니다.

  1. Dispatcher를 포함한 모든 미리보기 서비스가 올바르게 구성되어 오류 없이 시작할 수 있는지 확인합니다. Cloud Manager 로그에서 미리보기 Dispatcher와 관련된 준비 또는 상태 확인 오류를 확인합니다.
  2. Dispatcher 구성 YAML 파일(예: rewrite-maps.yaml 또는 managed-rewrite-maps.yaml)을 편집합니다. 파일을 검토하여 시작을 차단할 수 있는 맵 항목을 확인하고 모든 맵 항목에 대해 wait 플래그가 false(으)로 설정되어 있는지 확인하십시오. 예:
maps:
        - name: redirects-301.map
        path: /content/dam/rewrites/redirects-301.txt
        ttl: 300
        wait: false
        - name: redirects-302.map
        path: /content/dam/rewrites/redirects-302.txt
        ttl: 300
        wait: false
  1. 변경 사항을 저장하고 저장소에 커밋한 다음 Cloud Manager에서 파이프라인을 다시 실행합니다.
  2. 파이프라인 실행을 모니터링하여 미리보기 디스패처 및 관련 서비스가 장기적인 시작 또는 준비 상태에 머무르지 않고 적시에 정상 상태에 도달하는지 확인합니다.
  3. 배포가 성공적으로 완료되면 Dispatcher 코드가 예상대로 배포되었는지 확인합니다.
  4. 파이프라인이 여전히 예상보다 오래 걸리거나 실패할 경우 Dispatcher 및 미리보기 서비스 로그에서 추가 준비, 상태 확인 또는 시작 문제를 검토하십시오.
recommendation-more-help
experience-cloud-kcs-help-kbarticles