Verbindingen vormen

Het bestand routes.yaml in de map .magento/routes.yaml definieert routes voor uw Adobe Commerce op omgevingen voor integratie, staging en productie van cloudinfrastructuur. Routes bepalen hoe de toepassing binnenkomende HTTP- en HTTPS-aanvragen verwerkt.

Het standaard routes.yaml dossier specificeert de routesjablonen voor de verwerking van HTTP- verzoeken als HTTPS op projecten die één enkel standaarddomein en op projecten hebben die voor veelvoudige domeinen worden gevormd:

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

Gebruik magento-cloud CLI om een lijst van de gevormde routes te bekijken:

magento-cloud environment:routes

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

Configuratie-updates voor Pro-omgevingen

Route templates

Het bestand routes.yaml is een lijst met sjabloonroutes en hun configuraties. U kunt de volgende placeholders in routesjablonen gebruiken:

Adobe Commerce genereert ook routes voor elke actieve integratieomgeving. Voor integratieomgevingen wordt de tijdelijke aanduiding {default} vervangen door de volgende domeinnaam:

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

De refactorcss -vertakking voor het mswy7hzcuhcjw -project dat wordt gehost in de us -cluster heeft bijvoorbeeld het volgende domein:

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

Sluitslash

De definities van de route bevatten een het slepen schuine streep om op een omslag of een folder te wijzen; nochtans, kan de zelfde inhoud met of zonder een het slepen schuine streep worden gediend. De volgende URLs lost het zelfde op maar kan als worden geïnterpreteerd twee verschillende URLs:

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

https://www.example.com/blog

Routeprotocollen

Alle omgevingen ondersteunen automatisch HTTP en HTTPS.

Geef alle pagina's weer via TLS. Voor deze configuratie, moet u redirects voor al unencrypted verzoek aan het equivalent TLS vormen gebruikend één van de volgende methodes:

Routopties

Vorm elke route afzonderlijk gebruikend de volgende eigenschappen:

Eenvoudige routes

In de volgende voorbeelden leidt de routeconfiguratie het apex-domein en het www -subdomein naar de mymagento -toepassing. Deze route leidt HTTPS- verzoeken niet om.

Voorbeeld 1:

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

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

In dit voorbeeld, volgt het verzoek die deze regels verplettert:

In het volgende voorbeeld, richt de routeconfiguratie geen URLs van het www domein aan het apex domein. In plaats daarvan, worden de verzoeken gediend van zowel www als apex domein.

Voorbeeld 2:

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

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

Jokerroutes

Adobe Commerce op cloudinfrastructuur ondersteunt jokertekenroutes, zodat u meerdere subdomeinen aan dezelfde toepassing kunt toewijzen. Dit werkt voor omleiding en stroomopwaartse routes. U voegt een sterretje (*) toe aan de route. Met de volgende routes naar bijvoorbeeld dezelfde toepassing:

Dit werkt als een 'catch-all'-domein in een live omgeving.

Het verpletteren van een niet in kaart gebracht domein

U kunt aan een systeem leiden dat niet aan een domein gebruikend een punt (.) in kaart wordt gebracht om subdomain te scheiden.

Voorbeeld:

Een project met een vertakking add-theme leidt naar de volgende URL:

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

Als u het volgende routesjabloon definieert:

http://www.{default}/

De route lost aan volgende URL op:

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

U kunt elk subdomein invoegen voordat de punt en de route worden omgezet.

Voorbeeld:

Bepaal het volgende routesjabloon:

http://*.{default}/

Deze sjabloon verhelpt beide volgende URL's:

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

U kunt het routepatroon voor niet in kaart gebrachte domeinen bekijken door een verbinding van SSH aan het milieu te vestigen, en magento-cloud CLI te gebruiken om van de routes een lijst te maken:

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

Omleiding en caching

Zoals besproken in meer detail in richtopnieuw, kunt u complexe redirection regels, zoals gedeeltelijke herleidingen beheren, en regels voor route-gebaseerd cachingspecificeren:

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