Configuration des itinéraires

Le fichier routes.yaml dans le répertoire .magento/routes.yaml définit les itinéraires pour votre Adobe Commerce dans les environnements d’intégration, d’évaluation et de production de l’infrastructure cloud. Les itinéraires déterminent la manière dont l’application traite les requêtes HTTP et HTTPS entrantes.

Le fichier routes.yaml par défaut spécifie les modèles d’itinéraire pour le traitement des requêtes HTTP en tant que HTTPS sur les projets ayant un seul domaine par défaut et sur les projets configurés pour plusieurs domaines :

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

Utilisez l’interface de ligne de commande magento-cloud pour afficher la liste des itinéraires configurés :

magento-cloud environment:routes

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

Mises à jour de configuration des environnements Pro

Modèles d’itinéraire

Le fichier routes.yaml est une liste d’itinéraires modélisés et de leurs configurations. Vous pouvez utiliser les espaces réservés suivants dans les modèles d’itinéraire :

Adobe Commerce génère également des itinéraires pour chaque environnement d’intégration actif. Pour les environnements d’intégration, l’espace réservé {default} est remplacé par le nom de domaine suivant :

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

Par exemple, la branche refactorcss du projet mswy7hzcuhcjw hébergé dans le cluster us comporte le domaine suivant :

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

Barre oblique de fin

Les définitions d’itinéraire contiennent une barre oblique de fin pour indiquer un dossier ou un répertoire ; toutefois, le même contenu peut être diffusé avec ou sans barre oblique de fin. Les URL suivantes résolvent les mêmes problèmes, mais peuvent être interprétées comme deux URL différentes :

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

https://www.example.com/blog

Protocoles d'itinéraire

Tous les environnements prennent automatiquement en charge HTTP et HTTPS.

Diffuser toutes les pages via TLS. Pour cette configuration, vous devez configurer des redirections pour toute requête non chiffrée vers l’équivalent TLS à l’aide de l’une des méthodes suivantes :

Options d’itinéraire

Configurez chaque itinéraire séparément à l’aide des propriétés suivantes :

Itinéraires simples

Dans les exemples suivants, la configuration de l’itinéraire achemine le domaine apex et le sous-domaine www vers l’application mymagento. Cet itinéraire ne redirige pas les requêtes HTTPS.

Exemple 1:

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

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

Dans cet exemple, le routage des requêtes suit les règles suivantes :

Dans l’exemple suivant, la configuration de l’itinéraire ne redirige pas les URL du domaine www vers le domaine apex. Au lieu de cela, les requêtes sont diffusées à partir des domaines www et apex.

Exemple 2:

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

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

Itinéraires génériques

Adobe Commerce sur l’infrastructure cloud prend en charge les itinéraires de caractères génériques, ce qui vous permet de mapper plusieurs sous-domaines à la même application. Cela fonctionne pour les itinéraires de redirection et en amont. Vous faites précéder l’itinéraire d’un astérisque (*). Par exemple, les itinéraires suivants mènent à la même application :

Cela fonctionne comme un domaine fourre-tout dans un environnement en ligne.

Acheminement vers un domaine non mappé

Vous pouvez acheminer vers un système qui n’est pas mappé à un domaine à l’aide d’un point (.) pour séparer le sous-domaine.

Exemple:

Un projet avec une branche add-theme est acheminé vers l’URL suivante :

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

Si vous définissez le modèle d'itinéraire suivant :

http://www.{default}/

L’itinéraire est résolu sur l’URL suivante :

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

Vous pouvez insérer n’importe quel sous-domaine avant la résolution du point et de l’itinéraire.

Exemple:

Définissez le modèle d’itinéraire suivant :

http://*.{default}/

Ce modèle résout les deux URL suivantes :

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

Vous pouvez afficher le modèle d’itinéraire pour les domaines non mappés en établissant une connexion SSH à l’environnement et en utilisant l’interface de ligne de commande magento-cloud pour répertorier les itinéraires :

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}/                                         |
+------------------------------------------+--------------------------------------------------------------+

Redirections et mise en cache

Comme expliqué plus en détail dans la section Redirections, vous pouvez gérer des règles de redirection complexes, telles que les redirections partielles, et spécifier des règles pour la mise en cache basée sur les itinéraires :

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