이 페이지에서는 디스패처 도구 및 디스패처 도구를 다운로드하고 추출하는 방법에 대해 설명하고 지원되는 Apache 모듈과 기존 및 유연한 모드에 대한 높은 수준의 개요를 제공합니다. 또한 유효성 검사 및 디버깅과 Dispatcher 구성을 AMS에서 AEM as a Cloud Service으로 마이그레이션하는 것에 대한 추가 참조가 있습니다. 또한, 이 비디오 를 참조하십시오.
Dispatcher 도구는 전체 AEM as a Cloud Service SDK의 일부이며 다음을 제공합니다.
Dispatcher 도구이며 AEM as a Cloud Service SDK의 zip 파일에서 다운로드할 수 있습니다 소프트웨어 배포 포털. 이 새 Dispatcher 도구 버전에서 사용할 수 있는 모든 새 구성을 사용하여 클라우드 이상에서 해당 AEM 버전을 실행하는 클라우드 환경에 배포할 수 있습니다.
SDK의 압축을 해제합니다. SDK는 macOS, Linux 및 Windows용 Dispatcher 도구를 번들입니다.
macOS/Linux용를 사용하여 Dispatcher 도구 아티팩트를 실행 가능하게 하고 실행합니다. 저장한 디렉토리(여기서)에 있는 Dispatcher 도구 파일을 자동으로 추출합니다 version
는 Dispatcher 도구 버전입니다.)
$ chmod +x aem-sdk-dispatcher-tools-<version>-unix.sh
$ ./aem-sdk-dispatcher-tools-<version>-unix.sh
Verifying archive integrity... 100% All good.
Uncompressing aem-sdk-dispatcher-tools-<version>-unix.sh 100%
Windows용에서 Dispatcher 도구 zip 아카이브를 추출합니다.
디스패처 도구는 프로젝트의 Dispatcher 구성을 확인하고 디버깅하는 데 사용됩니다. 프로젝트의 Dispatcher 구성이 유연한 모드에서 구성되어 있는지 아니면 레거시 모드로 구성되어 있는지에 따라 아래 참조 페이지에서 이러한 도구를 사용하는 방법에 대해 자세히 알아보십시오.
유연한 모드 - 권장 모드 및 AEM 원형 28 및 그 이상. Cloud Manager 2021.7.0 릴리스 이후 작성된 새 환경에서도 Cloud Manager에서 사용됩니다. 고객은 폴더 및 파일을 추가하여 이 모드를 활성화할 수 있습니다 opt-in/USE_SOURCES_DIRECTLY
. 이 보다 유연한 모드를 사용하면 레거시 모드에서 단일 파일이 필요한 rewrites 폴더 아래에 파일 구조에 제한이 없습니다 rewrite.rules
파일. 또한 추가할 수 있는 규칙 수에는 제한이 없습니다. 폴더 구조 및 로컬 유효성 검사에 대한 자세한 내용은 Dispatcher 도구를 사용하여 유효성 검사 및 디버깅.
기존 모드 - 디스패처 구성 레거시 모드에 대한 폴더 구조 및 로컬 유효성 검사에 대한 자세한 내용은 Dispatcher 도구(기존)를 사용하여 유효성 검사 및 디버깅
AEM Archetype 28 이상에서 제공되는 레거시 구성 모델에서 보다 유연한 구성 모델로 마이그레이션하는 방법에 대한 자세한 내용은 다음을 참조하십시오 이 설명서.
아래 표에는 지원되는 Apache 모듈이 나와 있습니다.
고객은 임의의 모듈을 추가할 수 없지만, 추가 모듈은 나중에 포함할 수 있습니다. 고객은 SDK에서 유효성 검사기의 명령을 실행하여 주어진 Dispatcher 버전에 사용할 수 있는 허용 목록에 추가하다 지시어 목록을 찾을 수 있습니다.
유효성 검사기의 허용 목록에 추가하다 명령을 실행하여 Apache 구성 파일에서 허용되는 지시문을 나열할 수 있습니다.
$ validator allowlist
Cloud manager validator 2.0.4
Allowlisted directives:
<Directory>
...
다음에 설명된 대로 프로젝트의 apache 및 dispatcher 폴더 구조는 프로젝트가 사용 중인 모드에 따라 약간 다릅니다. Dispatcher 도구를 사용한 유효성 검사 및 디버깅 섹션에 있는 마지막 항목이 될 필요가 없습니다.
Dispatcher 구성을 AMS에서 AEM as a Cloud Service으로 마이그레이션하는 방법에 대한 자세한 내용은 를 참조하십시오. Dispatcher 구성을 AMS에서 AEM으로 마이그레이션 as a Cloud Service 페이지를 참조하십시오.