설명서Experience Cloud KCS

AEM의 Dispatcher 구성 배포 오류 수정

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

잘못된 파일 구조, 지원되지 않는 패키징 또는 잘못된 파이프라인 및 캐시 구성 설정으로 인해 배포 또는 마이그레이션 도중 Dispatcher 구성이 실패합니다. 이러한 문제는 성공적인 배포를 방해하거나 AEM 환경 전반에서 예기치 않은 비헤이비어를 야기할 수 있습니다. 이 문제를 해결하려면 구성 구조를 수정하고, 파이프라인 동작을 검토하고, 설정을 확인합니다.

설명 description

환경

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Managed Services (AMS)
  • Dispatcher 구성 배포 및 마이그레이션 시나리오

문제/증상

  • Dispatcher 구성이 원시 폴더 대신 압축 아카이브로 업로드되면 배포가 실패합니다
  • 마이그레이션에 오류 EPERM​이(가) 표시됩니다. 작업이 허용되지 않습니다. Windows 시스템의 symlink
  • Dispatcher 전용 파이프라인은 구성을 예상대로 업데이트하지 않습니다
  • 구성 업데이트에도 불구하고 배포 후 캐시가 지워지지 않음

원인

Cloud Manager에는 압축된 아카이브가 아닌 원시 Dispatcher 폴더 구조가 필요하기 때문에 배포 오류가 발생합니다. AMS에서는 환경별 변수를 하드 코딩하지 않고 외부에서 정의해야 합니다. 마이그레이션 중에 Dispatcher 변환기는 운영 체제 제한이 차단할 수 있는 심볼 링크에 의존합니다.

해결 방법 resolution

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

  1. 저장소에 올바른 위치에 있는 conf.d 및 conf.dispatcher.d과(와) 같은 압축되지 않은 Dispatcher 폴더가 있는지 확인하고 수동으로 만든 모든 zip 파일을 제거하십시오.
  2. Cloud Manager에서 전용 웹 계층 파이프라인을 만들고 올바른 저장소 경로를 선택하여 전체 배포를 트리거하지 않고 독립적으로 Dispatcher 구성을 배포합니다.
  3. 배포 동작을 검토하고 Dispatcher 전용 파이프라인이 점진적으로 업데이트된다는 점에 주목하고 선택한 파이프라인이 Dispatcher 소스 구조를 포함하며 업데이트된 로그로 성공적으로 실행되는지 확인합니다.
  4. AEM as a Cloud Service용 플러시 끝점을 활성화하거나 AMS에서 사용자 지정 스크립트를 사용하여 지원되는 캐시 지우기 방법을 적용하고 Dispatcher 캐시 타임스탬프를 확인하여 캐시 업데이트를 확인합니다.
  5. 변수 파일을 사용하여 Managed Services에서 환경별 변수를 정의하고, 이를 가상 호스트 구성에 포함시킨 다음, 요청 중에 구성이 올바르게 확인되는지 확인하십시오.
  6. 필요한 경우 환경에서 Dispatcher 구성 패키지를 검색하고 추출된 파일이 예상 디렉터리 구조와 일치하는지 확인합니다.
  7. 적절한 시스템 권한으로 Dispatcher 변환을 실행하거나 지원되는 환경을 사용하여 symlink 오류를 방지하고 변환된 구조가 성공적으로 생성되는지 확인합니다.
  8. 파이프라인 실행 로그를 검토하고, Dispatcher 로그를 확인하고, 구성 업데이트가 올바로 적용되는지 확인하여 환경 간 배포를 확인합니다.
  9. 프로그래밍 방식의 캐시 지우기가 필요한 경우 Adobe 계정 팀에 문의하여 CDN 제거 API 자격 증명을 요청하십시오.

관련 읽기

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