Redirecciones de URL sin canalizaciones pipeline-free-redirects
Por varios motivos, las organizaciones reescriben las direcciones URL de forma que provocan un redireccionamiento 301 (o 302), lo que significa que el explorador se redirige a una página diferente.
Los escenarios incluyen:
- Se ha eliminado una página del HTML, por lo que se lleva al usuario a una página de reemplazo (a veces la página principal) en lugar de ver un error de
404 Page Not Found. - Una página de HTML renombrada.
- Optimización de SEO.
AEM as a Cloud Service ofrece varios enfoques para implementar redirecciones del lado del cliente, pero la estrategia descrita en este artículo, redirecciones sin canalización, es una buena opción cuando:
- Las personas que mantienen las redirecciones son usuarios empresariales, que no tienen el acceso necesario para confirmar los cambios de archivo en el control de código fuente o la posibilidad de ejecutar una canalización de configuración de nivel web de Cloud Manager.
- El número de redirecciones va de unas pocas a decenas de miles.
- Desea la opción de una interfaz de usuario, ya sea creada como un proyecto personalizado o usando el Administrador de mapas de redireccionamiento de ACS Commons o Administrador de redireccionamiento de ACS Commons.
AEM El núcleo de esta función es la capacidad de Apache/Dispatcher AEM para cargar (o volver a cargar) uno o más archivos de asignación de reescritura que se han colocado en una ubicación especificada del repositorio de publicación (de modo que se pueda descargar desde la publicación). Es importante mencionar que la forma en que los archivos llegan a ese punto está fuera del ámbito de esta función, pero puede considerar uno de los siguientes métodos:
- Ingesta de la asignación de reescritura como un recurso en la interfaz de usuario de creación y publicación.
- Instalando ACS Commons Redirect Map Manager (al menos la versión 6.7.0 o superior), que incluye una interfaz de usuario para administrar las asignaciones de URL y también puede publicar el archivo de asignación de reescritura.
- Instalando ACS Commons Redirect Manager (al menos la versión 6.10.0 o superior), que también incluye una interfaz de usuario para administrar las asignaciones de URL y también puede publicar el archivo de asignación de reescritura.
- Flexibilidad total al escribir una aplicación personalizada. AEM Por ejemplo, una interfaz de usuario o de línea de comandos para administrar las asignaciones de URL o, alternativamente, un formulario para cargar una asignación de reescritura, que luego utiliza las API de para publicar el archivo de asignación de reescritura.
El mapa de reescritura rewrite-map
El servidor HTTP Apache vuelve a cargar (si se cambia) el mapa de reescritura cada 300 segundos de forma predeterminada (el valor se puede configurar). El formato de archivo debe seguir el formato de archivo de mapa de clave-valor de texto sin formato RewriteMap descrito en la documentación de Apache.
Se debe crear un archivo con el nombre managed-rewrite-maps.yaml para especificar la ubicación del archivo de asignación de reescritura y se debe implementar una vez mediante la canalización de pila completa de Cloud Manager o la canalización de nivel web. El archivo debe crearse en la carpeta src/opt-in de la configuración de Dispatcher. Asegúrese de utilizar la estructura de archivos de modo flexible.
Puede configurarlo con el siguiente patrón:
maps:
- name: my.map
path: <path-in-publish-repository>/redirectmap.txt
AEM Si, por ejemplo, el método elegido para colocar el archivo de asignación de reescritura es introducirlo como un recurso denominado mysite-redirectmap.txt y, a continuación, publicarlo, puede especificar una carpeta en /content/dam:
maps:
- name: my.map
path: /content/dam/redirectmaps/mysite-redirectmap.txt
A continuación, en un archivo de configuración de Apache como rewrites/rewrite.rules o <yourfile>.vhost, debe configurar el archivo de asignación al que hace referencia la propiedad de nombre (my.map en el ejemplo anterior). Una vez cargado, este archivo de asignación se guarda en el almacenamiento local de Dispatcher en la ubicación fija /tmp/rewrites/.
La directiva RewriteMap debe indicar que los datos se almacenan en un formato de archivo de administrador de base de datos (DBM) utilizando el formato sdbm (DBM simple), y la ruta de acceso completa del archivo se deriva del prefijo de ubicación de almacenamiento y de la propiedad name.
El resto de la configuración depende del formato de redirectmap.txt. El formato más sencillo, que se muestra en el ejemplo siguiente, es una asignación individual entre la dirección URL original y la asignada:
# RewriteMap from managed rewrite maps
RewriteMap map.foo dbm=sdbm:/tmp/rewrites/my.map
RewriteCond ${map.foo:$1} !=""
RewriteRule ^(.*)$ ${map.foo:$1|/} [L,R=301]
Consideraciones considerations
Tenga en cuenta lo siguiente:
- De forma predeterminada, al cargar un mapa de reescritura, Apache se inicia sin esperar a que se carguen los archivos de mapa completos y, por lo tanto, puede haber incoherencias temporales hasta que se carguen los mapas completos. Esta configuración se puede cambiar para que Apache espere a que se cargue todo el contenido del mapa, pero Apache tardará más en iniciarse. Para cambiar este comportamiento para que Apache espere, agregue
wait:trueal archivomanaged-rewrite-maps.yaml. - Para cambiar la frecuencia entre cargas, agregue
ttl: <integer>al archivomanaged-rewrite-maps.yaml. Por ejemplo:ttl: 120. - Apache tiene un límite de longitud de 1024 para las entradas únicas de RewriteMap.