클라우드의 디스패처

소개

이 페이지에서는 디스패처 도구 및 디스패처 도구를 다운로드하고 추출하는 방법에 대해 설명하고 지원되는 Apache 모듈과 기존 및 유연한 모드에 대한 높은 수준의 개요를 제공합니다. 또한 유효성 검사 및 디버깅과 Dispatcher 구성을 AMS에서 AEM as a Cloud Service으로 마이그레이션하는 것에 대한 추가 참조가 있습니다. 또한, 이 비디오 를 참조하십시오.

Dispatcher 도구

Dispatcher 도구는 전체 AEM as a Cloud Service SDK의 일부이며 다음을 제공합니다.

  • Dispatcher용 maven 프로젝트에 포함할 구성 파일이 포함된 vanilla 파일 구조입니다.
  • 고객이 Dispatcher 구성에 AEM as a Cloud Service 지원 지시문만 포함하는지 확인할 수 있도록 툴을 제공합니다. 또한 도구에서 구문이 올바른지 확인하여 apache가 성공적으로 시작될 수 있습니다.
  • 로컬에서 Dispatcher를 표시하는 Docker 이미지입니다.

도구 다운로드 및 추출

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 구성을 확인하고 디버깅하는 데 사용됩니다. 프로젝트의 Dispatcher 구성이 유연한 모드에서 구성되어 있는지 아니면 레거시 모드로 구성되어 있는지에 따라 아래 참조 페이지에서 이러한 도구를 사용하는 방법에 대해 자세히 알아보십시오.

  • 유연한 모드 - 권장 모드 및 AEM 원형 28 및 그 이상. Cloud Manager 2021.7.0 릴리스 이후 작성된 새 환경에서도 Cloud Manager에서 사용됩니다. 고객은 폴더 및 파일을 추가하여 이 모드를 활성화할 수 있습니다 opt-in/USE_SOURCES_DIRECTLY. 이 보다 유연한 모드를 사용하면 레거시 모드에서 단일 파일이 필요한 rewrites 폴더 아래에 파일 구조에 제한이 없습니다 rewrite.rules 파일. 또한 추가할 수 있는 규칙 수에는 제한이 없습니다. 폴더 구조 및 로컬 유효성 검사에 대한 자세한 내용은 Dispatcher 도구를 사용하여 유효성 검사 및 디버깅.

  • 기존 모드 - 디스패처 구성 레거시 모드에 대한 폴더 구조 및 로컬 유효성 검사에 대한 자세한 내용은 Dispatcher 도구(기존)를 사용하여 유효성 검사 및 디버깅

AEM Archetype 28 이상에서 제공되는 레거시 구성 모델에서 보다 유연한 구성 모델로 마이그레이션하는 방법에 대한 자세한 내용은 다음을 참조하십시오 이 설명서.

컨텐츠 처리

게시 계층의 경우 BLOB 제공 기본값은 첨부 파일로 사용됩니다. 이 값은 표준을 사용하여 대체할 수 있습니다 콘텐츠 처리 헤더 참조하십시오.

다음은 구성이 어떻게 표시되어야 하는지에 대한 예입니다.

<LocationMatch "^\/content\/dam.*\.(pdf).*">
 Header unset Content-Disposition
 Header set Content-Disposition inline
</LocationMatch>

지원되는 Apache 모듈

아래 표에는 지원되는 Apache 모듈이 나와 있습니다.

모듈 이름 참조 페이지
core https://httpd.apache.org/docs/2.4/mod/core.html
mod_access_compat https://httpd.apache.org/docs/2.4/mod/mod_access_compat.html
mod_alias https://httpd.apache.org/docs/2.4/mod/mod_alias.html
mod_allowmethods https://httpd.apache.org/docs/2.4/mod/mod_allowmethods.html
mod_authn_core https://httpd.apache.org/docs/2.4/mod/mod_authn_core.html
mod_authn_file https://httpd.apache.org/docs/2.4/mod/core.html
mod_authz_core https://httpd.apache.org/docs/2.4/mod/core.html
mod_authz_groupfile https://httpd.apache.org/docs/2.4/mod/mod_authz_groupfile.html
mod_deflate https://httpd.apache.org/docs/2.4/mod/mod_deflate.html
mod_dir https://httpd.apache.org/docs/2.4/mod/mod_dir.html
mod_env https://httpd.apache.org/docs/2.4/mod/mod_env.html
mod_filter https://httpd.apache.org/docs/2.4/mod/mod_filter.html
mod_headers https://httpd.apache.org/docs/2.4/mod/mod_headers.html
mod_mime https://httpd.apache.org/docs/2.4/mod/mod_mime.html
mod_proxy https://httpd.apache.org/docs/2.4/mod/mod_proxy.html
mod_proxy_http https://httpd.apache.org/docs/2.4/mod/mod_proxy_http.html
mod_remoteip https://httpd.apache.org/docs/2.4/mod/mod_remoteip.html
mod_reqtimeout https://httpd.apache.org/docs/2.4/mod/mod_reqtimeout.html
mod_rewrite https://httpd.apache.org/docs/2.4/mod/mod_rewrite.html
mod_security https://modsecurity.org/
mod_setenvif https://httpd.apache.org/docs/2.4/mod/mod_setenvif.html
mod_ssl (only the SSLProxyEngine directive) https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslproxyengine
mod_substitute https://httpd.apache.org/docs/2.4/mod/mod_substitute.html
mod_userdir https://httpd.apache.org/docs/2.4/mod/mod_userdir.html
mod_macro https://httpd.apache.org/docs/2.4/mod/mod_macro.html
mod_include (no directives supported) https://httpd.apache.org/docs/2.4/mod/mod_include.html

고객은 임의의 모듈을 추가할 수 없지만, 추가 모듈은 나중에 포함할 수 있습니다. 고객은 SDK에서 유효성 검사기의 명령을 실행하여 주어진 Dispatcher 버전에 사용할 수 있는 허용 목록에 추가하다 지시어 목록을 찾을 수 있습니다.

유효성 검사기의 허용 목록에 추가하다 명령을 실행하여 Apache 구성 파일에서 허용되는 지시문을 나열할 수 있습니다.

$ validator allowlist
Cloud manager validator 2.0.4

Allowlisted directives:
  <Directory>
  ...

폴더 구조

다음에 설명된 대로 프로젝트의 apache 및 dispatcher 폴더 구조는 프로젝트가 사용 중인 모드에 따라 약간 다릅니다. Dispatcher 도구를 사용한 유효성 검사 및 디버깅 섹션에 있는 마지막 항목이 될 필요가 없습니다.

AMS에서 Dispatcher 구성 마이그레이션

Dispatcher 구성을 AMS에서 AEM as a Cloud Service으로 마이그레이션하는 방법에 대한 자세한 내용은 를 참조하십시오. Dispatcher 구성을 AMS에서 AEM으로 마이그레이션 as a Cloud Service 페이지를 참조하십시오.

이 페이지에서는