Dispatcher en la nube

Introducción

En esta página se describen las herramientas de Dispatcher y cómo descargarlas y extraerlas, los módulos Apache admitidos, y se proporciona una descripció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 de AMS a AEM como Cloud Service

Herramientas de Dispatcher

Las herramientas de Dispatcher forman parte del AEM general como SDK de Cloud Service y proporcionan:

  • Una estructura de archivos vainilla 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 AEM como directivas admitidas por el Cloud Service. Además, la herramienta también valida que la sintaxis es correcta para que Apache pueda iniciarse correctamente.
  • Imagen de Docker que muestra Dispatcher localmente.

Descarga y extracción de las herramientas

Las herramientas de Dispatcher, que forman parte del AEM as a Cloud Service SDK, se pueden descargar desde un archivo zip en el portal Software Distribution. Cualquier configuración nueva 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 ejecutable el artefacto de la herramienta Dispatcher y ejecútelo. Extraerá los archivos de 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 mediante las herramientas de Dispatcher

Las herramientas de Dispatcher se utilizan para validar y depurar la configuración de Dispatcher de su proyecto. 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 del proyecto está estructurada en modo flexible o en modo heredado:

  • Modo flexible : el modo recomendado y el predeterminado para AEM tipo de archivo 28 y posteriores, que también utiliza Cloud Manager para nuevos entornos creados después de la versión Cloud Manager 2021.7.0. 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, requería un solo 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 mediante 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 mediante las herramientas de Dispatcher (heredado)

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

Módulos Apache compatibles

La tabla siguiente muestra los módulos Apache admitidos:

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

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 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 lista de permitidos del validador:

$ validator allowlist
Cloud manager validator 2.0.4
 
Allowlisted directives:
  <Directory>
  ...
  

Estructura de carpetas

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 Validación y depuración utilizando las herramientas de Dispatcher anterior.

Migración de la configuración de Dispatcher desde AMS

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

En esta página