Roteie um caminho de API para um backend pelo azion.config

Envie cada requisição sob um prefixo de caminho a um backend fora da Azion, com um connector e uma primeira regra declarados no azion.config.

Última atualização

Ver como Markdown Configurar agente

Você envia cada requisição sob um prefixo de caminho, como /api/, a um backend que roda fora da Azion pelo arquivo azion.config de um projeto, que a Azion CLI aplica com azion deploy. Para definir o header Host e o prefixo de caminho de um connector pelo Azion Console ou pela API, consulte Defina o Host header e o path prefix de uma origem.

A rota são duas entradas do arquivo: um connector que alcança o backend e uma regra de requisição que envia o caminho a esse connector. azion deploy aplica à aplicação as regras que o arquivo declara, então a rota sai com cada deploy do projeto.

  1. A aplicação executa as suas regras de requisição em ordem, e a primeira regra verifica se o caminho começa com /api/.
  2. Uma requisição que corresponde recebe o connector api-backend, e Finish Request Phase encerra a fase, então nenhuma regra seguinte muda o seu connector, o seu caminho ou o seu cache setting.
  3. O backend responde a requisição.
  4. Qualquer outra requisição passa pela primeira regra sem corresponder, e as regras seguintes são executadas como antes.

Pré-requisitos

  • Uma pasta de projeto com um arquivo de configuração que azion deploy lê, como o arquivo azion.config.cjs ou azion.config.mjs que azion link ou azion init escreve. Para os nomes de arquivo que a CLI lê, consulte azion.config.js.
  • A Azion CLI, instalada e autenticada, nessa pasta de projeto.
  • Um backend que responde HTTPS na porta 443 com o seu próprio hostname.

Os exemplos enviam /api/ ao backend api.example.com por um connector chamado api-backend, e requisitam /api/health em <workload-domain>, o domínio que o deploy imprime. Substitua-os pelos seus valores.

Declare o connector do backend

O connector guarda o endereço do backend e como a Azion se conecta a ele. transportPolicy: 'force_https' conecta ao backend somente por HTTPS. host envia o próprio nome do backend no header Host: o padrão, ${host}, envia o host que o cliente requisitou, ao qual um backend que roteia requisições por nome pode não responder.

Para declarar o connector, adicione esta entrada ao array connectors do arquivo:

JavaScript
01{
02 name: 'api-backend',
03 active: true,
04 type: 'http',
05 attributes: {
06 addresses: [{ address: 'api.example.com' }],
07 connectionOptions: {
08 transportPolicy: 'force_https',
09 host: 'api.example.com'
10 },
11 modules: {
12 loadBalancer: { enabled: false, config: null },
13 originShield: { enabled: false, config: null }
14 }
15 }
16}

O build recusa um connector http sem o objeto modules, então a entrada o carrega com os dois recursos desativados. O arquivo agora declara o connector api-backend, que a regra da próxima seção nomeia.

Envie o caminho ao connector primeiro

A regra corresponde ao caminho com ${uri}, que não exige nenhum Produto na aplicação. Os seus behaviors são executados em ordem: set_connector nomeia o connector pelo name que o arquivo declara, e finish_request_phase encerra a Request Phase.

A regra vem primeiro porque uma aplicação executa as regras de uma fase em ordem, e somente o último Set Connector que corresponde é executado. Sem a parada, uma regra posterior que nomeia outro connector para todos os caminhos tiraria as requisições de /api/ do backend. Com ela, as regras depois desta nunca veem uma requisição de /api/.

Para declarar a regra, adicione esta entrada como o primeiro item do array rules.request da aplicação, antes de qualquer regra que já esteja lá:

JavaScript
01{
02 name: 'Send /api/ to the backend',
03 active: true,
04 criteria: [
05 [
06 {
07 variable: '${uri}',
08 conditional: 'if',
09 operator: 'starts_with',
10 argument: '/api/'
11 }
12 ]
13 ],
14 behaviors: [
15 { type: 'set_connector', attributes: { value: 'api-backend' } },
16 { type: 'finish_request_phase' }
17 ]
18}

A ordem do array é a ordem em que as regras são executadas na aplicação: depois de atualizar as regras, azion deploy --local ordena a request phase e imprime Rules Engine of Application with id <application-id> successfully ordered (request phase). O arquivo agora envia /api/ ao backend antes que qualquer outra regra seja executada.

Faça o deploy da rota

azion deploy aplica o arquivo à aplicação, com o connector e a regra. Para fazer o deploy, execute este comando na pasta do projeto:

azion deploy

O comando abre a página do Console que acompanha o deploy e termina com o domínio:

Texto
01Your Application was deployed successfully
02
03To visualize your application access the Domain: https://<workload-domain>
04Your application is being deployed to all Azion Locations and it might take a few minutes.

As requisições sob /api/ chegam a api.example.com com o seu próprio caminho, e todas as outras requisições mantêm as regras que vêm depois. Uma mudança de regra leva alguns minutos para chegar a todos os data centers.

Verifique se o caminho chega ao backend

Uma requisição sob o prefixo deve retornar a resposta do backend, e não uma resposta das regras seguintes. Para verificar, requisite um caminho do backend:

curl -s -D - https://<workload-domain>/api/health

A resposta é a própria resposta do backend para /api/health. Quando não for, a regra pode ainda estar em propagação, ou outra regra foi executada antes. Para ver quais regras foram executadas em uma requisição, ative Debug Rules.

Próximos passos

azion.config.jsTodos os campos de connector, regra e behavior que o arquivo de configuração aceita.Como Applications funcionaComo as regras são executadas em ordem, por que o último Set Connector vence e quais behaviors param o restante.Configurações de connectorTodas as opções de conexão de um connector, com o seu padrão e os seus limites.Implantar aplicações front-endUma single-page application cujas chamadas de API chegam a um backend existente no mesmo domínio.