Documentação Commerce Guia do Commerce na infraestrutura em nuvem

Configurar rotas

Last update: Wed Apr 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

Admin
Developer

A variável routes.yaml arquivo no .magento/routes.yaml O diretório define rotas para o Adobe Commerce em ambientes de integração, preparo e produção de infraestrutura em nuvem. As rotas determinam como o aplicativo processa solicitações HTTP e HTTPS recebidas.

O padrão routes.yaml O arquivo especifica os modelos de rota para processar solicitações HTTP como HTTPS em projetos que têm um único domínio padrão e em projetos configurados para vários domínios:

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

Use o magento-cloud CLI para exibir uma lista das rotas configuradas:

magento-cloud environment:routes

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

Atualizações de configuração para ambientes Pro

WARNING

Alguns Projetos Pro exigir um tíquete de suporte para atualizar a configuração de rota no routes.yaml e a configuração do cron no .magento.app.yaml arquivo. O Adobe recomenda atualizar e testar arquivos de configuração YAML em um ambiente de Integração e, em seguida, implantar alterações no ambiente de Preparo. Se suas alterações não forem aplicadas aos sites de Preparo após a reimplantação e não houver mensagens de erro relacionadas no log, você DEVE Enviar um tíquete de suporte da Adobe Commerce que descreve as tentativas de alteração de configuração. Inclua quaisquer arquivos de configuração YAML atualizados no ticket.

Modelos de roteiro

A variável routes.yaml file é uma lista de rotas com modelos e suas configurações. Você pode usar os seguintes espaços reservados em modelos de rota:

A variável {default} o espaço reservado representa o nome de domínio qualificado configurado como padrão para o projeto.

Por exemplo, um projeto com o domínio padrão example.com e os seguintes modelos de roteiro:

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

Esses modelos resolvem para os seguintes URLs em um ambiente de produção:

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

A variável {all} o espaço reservado representa todos os nomes de domínio configurados para o projeto.

Por exemplo, um projeto com example.com e example1.com domínios com os seguintes modelos de rota:

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

Esses modelos resolvem as seguintes rotas para todos os domínios no projeto:

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

A variável {all} o espaço reservado é útil para projetos configurados para vários domínios. Em uma ramificação de não produção, {all} é substituída pela ID do projeto e pela ID do ambiente para cada domínio.

Se um projeto não tiver domínios configurados, o que é comum durante o desenvolvimento, a variável {all} o espaço reservado se comporta da mesma maneira que a {default} espaço reservado.

O Adobe Commerce também gera rotas para cada ambiente de integração ativo. Para ambientes de integração, a variável {default} o espaço reservado é substituído pelo seguinte nome de domínio:

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

Por exemplo, a variável refactorcss ramificação para a mswy7hzcuhcjw projeto hospedado na us o cluster tem o seguinte domínio:

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

NOTE

Se o projeto na nuvem der suporte a vários armazenamentos, siga as instruções de configuração de rota para vários sites ou lojas.

Barra à direita

As definições de rota contêm uma barra à direita para indicar uma pasta ou diretório; no entanto, o mesmo conteúdo pode ser distribuído com ou sem uma barra à direita. Os seguintes URLs resolvem o mesmo, mas podem ser interpretados como dois diferentes URLs:

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

https://www.example.com/blog

TIP

É uma prática recomendada usar uma barra à direita para diretórios, mas seja qual for o método escolhido, é importante mantenha-se consistente para evitar a geração de dois locais.

Protocolos de rota

Todos os ambientes são compatíveis com HTTP e HTTPS automaticamente.

Se a configuração especificar apenas a rota HTTP, as rotas HTTPS serão criadas automaticamente, permitindo que o site seja distribuído a partir de HTTP e HTTPS sem exigir redirecionamentos.

Por exemplo, um projeto com o domínio padrão example.com e o seguinte modelo de roteiro:

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

Esse modelo resolve os seguintes URLs:

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

Se a configuração especificar apenas a rota HTTPS, todas as solicitações HTTP serão redirecionadas para HTTPS.

Por exemplo, um projeto com o domínio padrão example.com com o seguinte modelo de roteiro:

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

Esse modelo resolve para o seguinte URL:

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

Ele também processa o seguinte redirecionamento:

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

Servir todas as páginas por TLS. Para essa configuração, você deve configurar redirecionamentos para todas as solicitações não criptografadas para o equivalente TLS usando um dos seguintes métodos:

Altere o protocolo para HTTPS no routes.yaml arquivo.

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

Para ambientes de armazenamento temporário e produção, ative a opção Forçar TLS no Fastly na interface do usuário do Administrador. Quando você usa essa opção, o Fastly lida com o redirecionamento para HTTPS, para que você não precise atualizar o routes.yaml configuração.

Opções de roteiro

Configure cada rota separadamente usando as seguintes propriedades:

Propriedade

Descrição

type: upstream

Serve um aplicativo. Além disso, tem um upstream que especifica o nome do aplicativo (conforme definido na seção .magento.app.yaml) seguido pelo :http terminal.

type: redirect

Redireciona para outra rota. É seguido pelo to propriedade, que é um redirecionamento HTTP para outra rota identificada por seu template.

cache:

Controles armazenamento em cache para a rota.

redirects:

Controles regras de redirecionamento.

ssi:

Controles habilitando de O lado do servidor inclui.

Rotas simples

Nos exemplos a seguir, a configuração de rota roteia o domínio apex e o www subdomínio para o mymagento aplicação. Essa rota não redireciona solicitações HTTPS.

Exemplo 1:

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

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

Neste exemplo, o roteamento de solicitações segue estas regras:

O servidor responde diretamente às solicitações com o seguinte padrão de URL:

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

O servidor emite um erro redirecionamento 301 para solicitações com o seguinte padrão de URL:

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

Essas solicitações redirecionam para o domínio apex, por exemplo:

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

No exemplo a seguir, a configuração de rota não redireciona URLs do domínio www para o domínio apex. Em vez disso, as solicitações são atendidas nos domínios www e apex.

Exemplo 2:

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

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

Rotas curingas

O Adobe Commerce na infraestrutura em nuvem oferece suporte a rotas curingas, para que você possa mapear vários subdomínios para o mesmo aplicativo. Isso funciona para rotas de redirecionamento e upstream. Você coloca um asterisco (*) como prefixo na rota. Por exemplo, as seguintes rotas para o mesmo aplicativo:

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

Isso funciona como um domínio abrangente em um ambiente ativo.

Roteamento de um domínio não mapeado

Você pode rotear para um sistema que não esteja mapeado para um domínio usando um ponto (.) para separar o subdomínio.

Exemplo:

Um projeto com um add-theme A ramificação encaminha para o seguinte URL:

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

Se você definir o seguinte modelo de roteiro:

http://www.{default}/

A rota é resolvida para o seguinte URL:

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

Você pode inserir qualquer subdomínio antes do ponto e da rota ser resolvida.

Exemplo:

Defina o seguinte modelo de roteiro:

http://*.{default}/

Esse modelo resolve ambos os URLs a seguir:

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

Você pode visualizar o padrão de rota para domínios não mapeados estabelecendo uma conexão SSH com o ambiente e usando o magento-cloud CLI para listar as rotas:

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

Redirecionamentos e armazenamento em cache

Tal como analisado em mais pormenor no Redirecionamentos, é possível gerenciar regras de redirecionamento complexas, como redirecionamentos parciais e especificar regras para baseado em rota armazenamento em cache:

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