Dispatcher en la nube Dispatcher-in-the-cloud

Introducción apache-and-dispatcher-configuration-and-testing

En esta página se describen las herramientas de Dispatcher y cómo descargarlas y extraerlas, los módulos Apache compatibles, y se proporciona una información general de alto nivel de los modos heredados y flexibles. Además, hay más referencias sobre validación y depuración, y migración de la configuración de Dispatcher desde AMS a AEM as a Cloud Service.

Herramientas de Dispatcher dispatcher-sdk

Las herramientas de Dispatcher forman parte del SDK de AEM as a Cloud Service y proporcionan lo siguiente:

  • Una estructura de archivos estándar que contiene los archivos de configuración que se van a incluir en un proyecto Maven para Dispatcher.
  • Herramientas para que los clientes validen que la configuración de Dispatcher incluye solo directivas de AEM as a Cloud Service compatibles. Además, la herramienta también valida que la sintaxis sea correcta para que Apache pueda iniciarse correctamente.
  • Una imagen de Docker que muestra Dispatcher localmente.

Descarga y extracción de las herramientas extracting-the-sdk

Las herramientas de Dispatcher, que forman parte del SDK de AEM as a Cloud Service, se pueden descargar desde un archivo .zip en el portal de distribución de software. Cualquier configuración disponible en esa nueva versión de las herramientas de Dispatcher se puede usar para implementar en entornos de nube que ejecuten esa versión de AEM en la nube o posterior.

Descomprima el SDK, que agrupa las herramientas de Dispatcher para macOS, Linux® y Windows.

Para macOS/Linux, haga que el artefacto de la herramienta Dispatcher sea ejecutable y ejecútelo. Extrae automáticamente los archivos de las herramientas de Dispatcher debajo del directorio en el que los almacenó (donde version es la versión de las herramientas de 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%

Para Windows, extraiga el archivo .zip de la herramienta Dispatcher.

Validación y depuración con las herramientas de Dispatcher validation-debug

Las herramientas de Dispatcher se utilizan para validar y depurar la configuración de su proyecto de Dispatcher. Obtenga más información sobre cómo utilizar estas herramientas en las páginas a las que se hace referencia a continuación, en función de si la configuración de Dispatcher de su proyecto está estructurada en modo flexible o en modo heredado.

  • Modo flexible: el modo recomendado y el valor predeterminado de AEM arquetipo 28 y superior, que también utiliza Cloud Manager para los nuevos entornos creados después de la versión 2021.7.0 de Cloud Manager. Los clientes pueden activar este modo añadiendo la carpeta y el archivo opt-in/USE_SOURCES_DIRECTLY. Al utilizar este modo más flexible, no hay limitaciones en la estructura de archivos de la carpeta de reescrituras que en el modo heredado requieren un único archivo rewrite.rules. Además, no hay limitación en el número de reglas que se pueden agregar. Para obtener más información sobre la estructura de carpetas y la validación local, consulte Validación y depuración con las herramientas de Dispatcher.

  • Modo heredado: para obtener más información sobre la estructura de carpetas y la validación local para el modo heredado de configuración de Dispatcher, consulte Validación y depuración con las herramientas de Dispatcher (heredadas).

Para obtener más información sobre cómo migrar del modelo de configuración heredado al más flexible, proporcionado con el arquetipo 28 en adelante de AEM, consulte esta documentación.

Disposición de contenido content-disposition

Para el nivel de publicación, el valor predeterminado para los blobs de servicio es como archivo adjunto. Esto se puede sobrescribir con el encabezado de disposición de contenido estándar en Dispatcher.

A continuación, se muestra un ejemplo de cómo debería ser la configuración:

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

Módulos Apache compatibles supported-directives

La siguiente tabla muestra los módulos Apache compatibles:

Nombre del módulo
Página de referencia
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

Los clientes no pueden añadir módulos arbitrarios; sin embargo, se puede considerar la inclusión de módulos adicionales en el futuro. Los clientes pueden encontrar la lista de directivas disponibles para una versión de Dispatcher determinada ejecutando el comando de la lista de permitidos del validador en el SDK.

Las directivas permitidas en los archivos de configuración de Apache se pueden enumerar ejecutando el comando de la lista de permitidos del validador:

$ validator allowlist
Cloud manager validator 2.0.4

Allowlisted directives:
  <Directory>
  ...

Estructura de carpetas folder-structure

La estructura de carpetas de Apache y Dispatcher del proyecto variará ligeramente según el modo que utilice el proyecto, tal como se describe en la sección anterior sobre Validación y depuración mediante las herramientas de Dispatcher.

Migración de la configuración de Dispatcher desde AMS ams-aem

Para obtener más información sobre cómo migrar la configuración de Dispatcher de AMS a AEM as a Cloud Service, consulte la página Migración de la configuración de Dispatcher de AMS a AEM as a Cloud Service.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab