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 archivorewrite.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:
mod_access_compatmod_allowmethodsmod_authn_coremod_authn_filemod_authz_coremod_authz_groupfilemod_proxy_httpmod_reqtimeoutmod_securitymod_ssl (only the SSLProxyEngine directive)mod_substitutemod_include (no directives supported)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.