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 as a Cloud Service. Consulte también este vídeo para obtener más información sobre la implementación de archivos de Dispatcher en un entorno de cloud service.

Herramientas de Dispatcher

Las herramientas de Dispatcher forman parte del SDK as a Cloud Service AEM general 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 directivas as a Cloud Service compatibles. 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 de la SDK as a Cloud Service AEM, se puede descargar desde un archivo zip en la Distribución de software portal. 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 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 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 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 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 requirieran una única rewrite.rules archivo. 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 (heredadas)

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
mod_macro https://httpd.apache.org/docs/2.4/mod/mod_macro.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 apache y dispatcher del proyecto diferirá ligeramente según el modo que utilice el proyecto, tal como se describe en la sección Validación y depuración mediante las herramientas de Dispatcher sección 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 as a Cloud Service, consulte Migración de la configuración de Dispatcher de AMS a AEM página as a Cloud Service.

En esta página