Documentación Commerce Guía de Commerce en la infraestructura en la nube

Configuración de rutas

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

Administrador
Desarrollador

El archivo routes.yaml del directorio .magento/routes.yaml define rutas para su Adobe Commerce en los entornos de integración, ensayo y producción de la infraestructura en la nube. Las rutas determinan cómo la aplicación procesa las solicitudes HTTP y HTTPS entrantes.

El archivo predeterminado routes.yaml especifica las plantillas de ruta para procesar solicitudes HTTP como HTTPS en proyectos que tienen un único dominio predeterminado y en proyectos configurados para varios dominios:

"http://{default}/":
    type: upstream
    upstream: "mymagento:http"
"http://{all}/":
    type: upstream
    upstream: "mymagento:http"

Utilice la CLI magento-cloud para ver una lista de las rutas configuradas:

magento-cloud environment:routes

+-------------------+----------+---------------+
| Route             | Type     | To            |
+-------------------+----------+---------------+
| http://{default}/ | upstream | mymagento     |
+-------------------+----------+---------------+

Actualizaciones de configuración para entornos Pro

WARNING

Algunos proyectos Pro requieren un vale de soporte técnico para actualizar la configuración de ruta en el archivo routes.yaml y la configuración de cron en el archivo .magento.app.yaml. El Adobe recomienda actualizar y probar los archivos de configuración de YAML en un entorno de integración y, a continuación, implementar los cambios en el entorno de ensayo. Si los cambios no se aplican a los sitios de ensayo después de volver a implementar y no hay mensajes de error relacionados en el registro, DEBE enviar un vale de soporte de Adobe Commerce que describa los cambios de configuración que se han intentado realizar. Incluya todos los archivos de configuración de YAML actualizados en el ticket.

Plantillas de ruta

El archivo routes.yaml es una lista de rutas con plantillas y sus configuraciones. Puede utilizar los siguientes marcadores de posición en las plantillas de ruta:

El marcador de posición {default} representa el nombre de dominio completo configurado como predeterminado para el proyecto.

Por ejemplo, un proyecto con el dominio predeterminado example.com y las siguientes plantillas de ruta:

code language-text
`https://www.{default}/ https://{default}/blog`

Estas plantillas se resuelven en las siguientes direcciones URL en un entorno de producción:

code language-text
`https://www.example.com/ https://example.com/blog`

El marcador {all} representa todos los nombres de dominio configurados para el proyecto.

Por ejemplo, un proyecto con example.com y example1.com dominios con las siguientes plantillas de ruta:

code language-text
`https://www.{all}/ https://{all}/blog`

Estas plantillas se resuelven en las siguientes rutas para todos los dominios del proyecto:

code language-text
`https://www.example.com/ https://www.example1.com/ https://example.com/blog https://example1.com/blog`

El marcador de posición {all} es útil para proyectos configurados para varios dominios. En una rama que no es de producción, {all} se reemplaza con el ID de proyecto y el ID de entorno de cada dominio.

Si un proyecto no tiene ningún dominio configurado, lo que es común durante el desarrollo, el marcador de posición {all} se comporta de la misma manera que el marcador de posición {default}.

Adobe Commerce también genera rutas para cada entorno de integración activo. Para entornos de integración, el marcador de posición {default} se reemplaza con el siguiente nombre de dominio:

[branch]-[per-environment-random-string]-[project-id].[region].magentosite.cloud

Por ejemplo, la rama refactorcss del proyecto mswy7hzcuhcjw alojado en el clúster us tiene el siguiente dominio:

https://refactorcss-oy3m2pq-mswy7hzcuhcjw.us.magentosite.cloud/

NOTE

Si el proyecto de Cloud admite varias tiendas, siga las instrucciones de configuración de ruta de varios sitios web o tiendas.

Barra final

Las definiciones de ruta contienen una barra diagonal para indicar una carpeta o directorio; sin embargo, el mismo contenido se puede proporcionar con o sin una barra diagonal. Las siguientes direcciones URL resuelven lo mismo, pero se pueden interpretar como dos direcciones URL diferentes:

https://www.example.com/blog/

https://www.example.com/blog

TIP

Se recomienda usar una barra diagonal para los directorios, pero sea cual sea el método que elija, es importante mantener la coherencia para evitar generar dos ubicaciones.

Protocolos de ruta

Todos los entornos admiten HTTP y HTTPS automáticamente.

Si la configuración solo especifica la ruta HTTP, las rutas HTTPS se crean automáticamente, lo que permite que el sitio se proporcione desde HTTP y HTTPS sin requerir redirecciones.

Por ejemplo, un proyecto con el dominio predeterminado example.com y la siguiente plantilla de ruta:

code language-text
`http://{default}/`

Esta plantilla responde a las siguientes direcciones URL:

code language-text
`http://example.com/ https://example.com/`

Si la configuración especifica solo la ruta HTTPS, todas las solicitudes HTTP se redirigen a HTTPS.

Por ejemplo, un proyecto con el dominio predeterminado example.com con la siguiente plantilla de ruta:

code language-text
`https://{default}/`

Esta plantilla responde a la siguiente URL:

code language-text
`https://example.com/`

También procesa la siguiente redirección:

http://example.com/ ==> https://example.com/

Enviar todas las páginas a través de TLS. Para esta configuración, debe configurar las redirecciones de todas las solicitudes sin cifrar al equivalente TLS mediante uno de los siguientes métodos:

Cambie el protocolo a HTTPS en el archivo routes.yaml.

code language-yaml
`"https://{default}/": type: upstream upstream: "mymagento:http" "https://{all}/": type: upstream upstream: "mymagento:http"`

Para entornos de ensayo y producción, habilite la opción Forzar TLS en Fastly desde la interfaz de usuario de administración. Cuando utiliza esta opción, Fastly gestiona la redirección a HTTPS, por lo que no tiene que actualizar la configuración de routes.yaml.

Opciones de ruta

Configure cada ruta por separado con las siguientes propiedades:

Propiedad

Descripción

type: upstream

Sirve a una aplicación. Además, tiene una propiedad upstream que especifica el nombre de la aplicación (tal como se define en .magento.app.yaml) seguido del extremo :http.

type: redirect

Redirige a otra ruta. Le sigue la propiedad to, que es una redirección HTTP a otra ruta identificada por su plantilla.

cache:

Controla el almacenamiento en caché de para la ruta.

redirects:

Controla reglas de redireccionamiento.

ssi:

Controla la activación de Server Side Includes.

Rutas simples

En los ejemplos siguientes, la configuración de ruta enruta el dominio Apex y el subdominio www a la aplicación mymagento. Esta ruta no redirige las solicitudes HTTPS.

Ejemplo 1:

"http://{default}/":
    type: upstream
    upstream: "mymagento:http"

"http://www.{default}/":
    type: redirect
    to: "http://{default}/"

En este ejemplo, el enrutamiento de solicitud sigue estas reglas:

El servidor responde directamente a las solicitudes con el siguiente patrón de URL:

code language-text
`http://example.com/path`

El servidor emite un 301 redireccionamiento para las solicitudes con el siguiente patrón de URL:

code language-text
`http://www.example.com/mypath`

Estas solicitudes se redirigen al dominio Apex, por ejemplo:

code language-text
`http://example.com/mypath`

En el ejemplo siguiente, la configuración de ruta no redirige las direcciones URL del dominio www al dominio apex. En su lugar, las solicitudes se proporcionan desde el dominio www y Apex.

Ejemplo 2:

"http://{default}/":
    type: upstream
    upstream: "mymagento:http"

"http://www.{default}/":
    type: upstream
    upstream: "mymagento:http"

Rutas comodín

Adobe Commerce en la infraestructura de la nube admite rutas comodín, por lo que puede asignar varios subdominios a la misma aplicación. Esto funciona para rutas de redireccionamiento y de subida. La ruta se codifica con un asterisco (*). Por ejemplo, las siguientes rutas a la misma aplicación:

*.example.com
www.example.com
blog.example.com
us.example.com

Funciona como un dominio global en un entorno en directo.

Enrutamiento de un dominio no asignado

Puede enrutar a un sistema que no esté asignado a un dominio mediante un punto (.) para separar el subdominio.

Ejemplo:

Un proyecto con una rama add-theme enruta a la siguiente dirección URL:

http://add-theme-projectID.us.magento.com/

Si define la siguiente plantilla de ruta:

http://www.{default}/

La ruta responde a la siguiente URL:

http://www.add-theme-projectID.us.magento.com/

Puede insertar cualquier subdominio antes del punto y la ruta se resolverá.

Ejemplo:

Defina la siguiente plantilla de ruta:

http://*.{default}/

Esta plantilla resuelve las dos direcciones URL siguientes:

http://foo.add-theme-projectID.us.magentosite.cloud/
http://bar.add-theme-projectID.us.magentosite.cloud/

Puede ver el patrón de ruta de los dominios no asignados estableciendo una conexión SSH con el entorno y utilizando la CLI magento-cloud para enumerar las rutas:

web@mymagento.0:~$ vendor/bin/ece-tools env:config:show routes

Magento Cloud Routes:
+------------------------------------------+--------------------------------------------------------------+
| Route configuration                      | Value                                                        |
+------------------------------------------+--------------------------------------------------------------+
| http://www.add-theme-projectID.us.magento.com/:                                                         |
+------------------------------------------+--------------------------------------------------------------+
| primary                                  | false                                                        |
| id                                       | null                                                         |
| attributes                               |                                                              |
| type                                     | upstream                                                     |
| to                                       | mymagento                                                    |
| original_url                             | https:/{default}/                                            |
+------------------------------------------+--------------------------------------------------------------+
| https://*.add-theme-projectID.us.magentosite.cloud/:                                                    |
+------------------------------------------+--------------------------------------------------------------+
| primary                                  | false                                                        |
| id                                       | null                                                         |
| attributes                               |                                                              |
| type                                     | upstream                                                     |
| to                                       | mymagento                                                    |
| original_url                             | https://*.{default}/                                         |
+------------------------------------------+--------------------------------------------------------------+

Redirecciones y almacenamiento en caché

Como se describe con más detalle en Redirecciones, puede administrar reglas de redirección complejas, como redirecciones parciales, y especificar reglas para el almacenamiento en caché basado en rutas:

https://www.{default}/:
    type: redirect
    to: https://{default}/
https://{default}/:
    cache:
        cookies: [""]
        default_ttl: 0
        enabled: true
        headers:
            - Accept
            - Accept-Language
    ssi:
        enabled: false
    type: upstream
    upstream: mymagento:http

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26