Configurare le route

Il file routes.yaml nella directory .magento/routes.yaml definisce le route per gli ambienti di integrazione dell'infrastruttura cloud, staging e produzione Adobe Commerce. Le route determinano il modo in cui l'applicazione elabora le richieste HTTP e HTTPS in ingresso.

Il file predefinito routes.yaml specifica i modelli di route per l'elaborazione delle richieste HTTP come HTTPS nei progetti con un singolo dominio predefinito e nei progetti configurati per più domini:

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

Utilizzare l'interfaccia della riga di comando magento-cloud per visualizzare un elenco delle route configurate:

magento-cloud environment:routes

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

Aggiornamenti alla configurazione degli ambienti Pro

Modelli di percorso

Il file routes.yaml è un elenco di route con modelli e relative configurazioni. Nei modelli di percorso è possibile utilizzare i segnaposto seguenti:

Adobe Commerce genera inoltre route per ogni ambiente di integrazione attivo. Per gli ambienti di integrazione, il segnaposto {default} è sostituito dal seguente nome di dominio:

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

Ad esempio, il ramo refactorcss per il progetto mswy7hzcuhcjw ospitato nel cluster us ha il seguente dominio:

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

Barra finale

Le definizioni di route contengono una barra finale per indicare una cartella o una directory; tuttavia, lo stesso contenuto può essere distribuito con o senza una barra finale. I seguenti URL vengono risolti nello stesso modo, ma possono essere interpretati come due URL diversi:

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

https://www.example.com/blog

Protocolli di route

Tutti gli ambienti supportano sia HTTP che HTTPS automaticamente.

Distribuisci tutte le pagine su TLS. Per questa configurazione, devi configurare i reindirizzamenti per tutte le richieste non crittografate all’equivalente TLS utilizzando uno dei seguenti metodi:

Opzioni ciclo di lavorazione

Configurare ogni route separatamente utilizzando le proprietà seguenti:

Percorsi semplici

Negli esempi seguenti, la configurazione della route indirizza il dominio apex e il sottodominio www all'applicazione mymagento. Questa route non reindirizza le richieste HTTPS.

Esempio 1:

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

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

In questo esempio, il ciclo di richieste segue le regole seguenti:

Nell’esempio seguente, la configurazione della route non reindirizza gli URL dal dominio www al dominio apex. Le richieste vengono invece gestite sia dal dominio www che da quello apex.

Esempio 2:

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

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

Route con caratteri jolly

Adobe Commerce su infrastruttura cloud supporta percorsi con caratteri jolly, in modo da poter mappare più sottodomini alla stessa applicazione. Questo funziona per le route di reindirizzamento e upstream. La route deve essere preceduta da un asterisco (*). Ad esempio, le seguenti route alla stessa applicazione:

Questo funziona come dominio onnicomprensivo in un ambiente live.

Indirizzare un dominio non mappato

È possibile indirizzare a un sistema non mappato a un dominio utilizzando un punto (.) per separare il sottodominio.

Esempio:

Un progetto con un ramo add-theme viene indirizzato al seguente URL:

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

Se si definisce il seguente modello di ciclo di lavorazione:

http://www.{default}/

La route viene risolta nel seguente URL:

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

Puoi inserire qualsiasi sottodominio prima che il punto e la route si risolvano.

Esempio:

Definire il seguente modello di ciclo di lavorazione:

http://*.{default}/

Questo modello risolve entrambi i seguenti URL:

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

È possibile visualizzare il pattern di route per i domini non mappati stabilendo una connessione SSH all'ambiente e utilizzando la CLI magento-cloud per elencare le route:

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

Reindirizzamenti e caching

Come descritto più dettagliatamente in Reindirizzamenti, puoi gestire regole di reindirizzamento complesse, ad esempio reindirizzamenti parziali, e specificare regole per il caching basato su route:

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