Primeiros passos com Connectors

Crie um connector para uma segunda origem, envie um caminho da sua aplicação para ele com uma regra e confira a resposta pelo seu workload.

Última atualização

Ver como Markdown Configurar agente

Este guia orienta você a enviar o seu primeiro caminho para uma segunda origem com um connector.

  • Crie um connector do tipo http que alcança uma segunda origem por HTTPS e envia o próprio header Host dessa origem.
  • Adicione uma regra que aponta um caminho da sua aplicação para o connector com o behavior Set Connector.
  • Envie uma requisição para esse caminho pelo seu workload e receba a resposta da segunda origem.

Quatro partes formam a cadeia, listadas na ordem em que este guia as usa:

  1. O connector guarda o endereço da segunda origem, o header Host que ele envia e o protocolo que ele usa para se conectar.
  2. A regra na sua aplicação corresponde a um caminho na fase de requisição. O behavior Set Connector dela nomeia o connector.
  3. O workload que já atende a sua aplicação recebe a requisição. O deployment dele não precisa de nenhuma mudança.
  4. A requisição para esse caminho encontra a regra, e o connector a envia para a segunda origem. Todos os outros caminhos continuam chegando à origem do seu primeiro connector.

Um connector não recebe tráfego até que uma regra o nomeie. Este guia usa httpbin.org como segunda origem, um serviço público que responde a toda requisição sob /anything com uma cópia em JSON da requisição que recebeu. Por isso, a resposta que você verifica no fim mostra o que o connector enviou. Para usar a sua própria origem, substitua httpbin.org pelo hostname dela e /anything pelo caminho dela, como /api/.

O connector que este guia deixa pronto é o ponto de partida dos produtos de Connectors. Load Balancer distribui as requisições entre até 15 endereços de um connector. Origin Shield protege a origem com um Origin IP ACL e com assinatura HMAC. Live Ingest recebe uma transmissão ao vivo por um connector do tipo live_ingest.

Os pré-requisitos e as três etapas mostram os passos de uma interface por vez. Selecione a sua:

Pré-requisitos

  • Uma aplicação atendida por um workload, com uma regra que envia toda requisição para um primeiro connector. Para criar os três, consulte Primeiros passos com Applications.
  • O workload domain desse workload, no formato <id>.map.azionedge.net. Este guia o escreve como <workload-domain>.
  • curl, para requisitar o caminho pelo seu workload.
  • A Azion CLI na sua máquina, autorizada com um personal token.
  • O ID da sua aplicação.
  • Um personal token para o header Authorization.
  • O ID da sua aplicação.

Crie um connector para a sua segunda origem

Um connector do tipo http guarda o endereço de uma origem e as configurações que a Azion usa para alcançá-la. Você o cria à parte, fora de qualquer aplicação. Este connector tem um endereço, httpbin.org, e se conecta a ele somente por HTTPS.

O header Host informa à origem para qual site é uma requisição. Por padrão, um connector envia o host que o cliente requisitou, que é o seu workload domain. Este connector envia httpbin.org no lugar, então a origem recebe o próprio nome. Para mais informações, consulte Header Host.

O connector mantém o caminho de cada requisição como o cliente o enviou. Para adicionar um diretório da origem na frente de todo caminho, consulte Prefixo de caminho. Para servir os objetos de um bucket no lugar de uma origem HTTP, consulte Use um bucket como origem de uma aplicação.

Para criar o connector com a Azion CLI, coloque-o primeiro em um arquivo JSON. Salve este corpo como connector.json:

JSON
01{
02 "name": "my-connector",
03 "active": true,
04 "type": "http",
05 "attributes": {
06 "addresses": [{ "address": "httpbin.org" }],
07 "connection_options": {
08 "transport_policy": "force_https",
09 "host": "httpbin.org"
10 }
11 }
12}

addresses lista os servidores de origem, e connection_options.host é o header Host que o connector envia. force_https faz toda conexão com a origem usar HTTPS.

Crie o connector a partir do arquivo. O comando precisa de --type, mesmo que o arquivo nomeie o tipo:

azion create connector --type http --file connector.json

A saída traz o ID do connector novo:

Created Connector with ID <connector-id>

Leia o connector de volta em JSON. Substitua <connector-id> pelo ID do comando anterior:

azion describe connector --connector-id <connector-id> --format json

Este trecho da saída mostra as opções de conexão, com um valor para cada opção que o arquivo deixou de fora:

JSON
01{
02 "active": true,
03 "attributes": {
04 "addresses": [
05 {
06 "active": true,
07 "address": "httpbin.org",
08 "http_port": 80,
09 "https_port": 443,
10 "modules": null
11 }
12 ],
13 "connection_options": {
14 "dns_resolution": "both",
15 "following_redirect": false,
16 "host": "httpbin.org",
17 "http_version_policy": "http1_1",
18 "path_prefix": "",
19 "real_ip_header": "X-Real-IP",
20 "real_port_header": "X-Real-PORT",
21 "transport_policy": "force_https"
22 },
23 …
24 },
25 …
26 "id": <connector-id>,
27 …
28 "name": "my-connector",
29 …
30 "type": "http",
31 …
32}

path_prefix está vazio, então o caminho chega à origem sem mudança. Anote o id: a regra o passa como <connector-id>. O connector existe na sua conta.

Para criar o connector com a API, envie uma requisição POST para o endpoint de connectors. Substitua [TOKEN VALUE] pelo seu personal token:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/connectors \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "name": "my-connector",
08 "type": "http",
09 "attributes": {
10 "addresses": [{ "address": "httpbin.org" }],
11 "connection_options": {
12 "transport_policy": "force_https",
13 "host": "httpbin.org"
14 }
15 }
16}

addresses lista os servidores de origem, e connection_options.host é o header Host que o connector envia. A API responde com 202. Este trecho da resposta mostra o connector, com um valor para cada configuração que a requisição deixou de fora:

JSON
01{
02 "state": "pending",
03 "data": {
04 …
05 "id": <connector-id>,
06 "name": "my-connector",
07 …
08 "active": true,
09 "product_version": "1.0",
10 "type": "http",
11 "attributes": {
12 "addresses": [
13 {
14 "active": true,
15 "address": "httpbin.org",
16 "http_port": 80,
17 "https_port": 443,
18 "modules": null
19 }
20 ],
21 "connection_options": {
22 "dns_resolution": "both",
23 "transport_policy": "force_https",
24 "http_version_policy": "http1_1",
25 "host": "httpbin.org",
26 "path_prefix": "",
27 "following_redirect": false,
28 "real_ip_header": "X-Real-IP",
29 "real_port_header": "X-Real-PORT"
30 },
31 "modules": {
32 "load_balancer": { "enabled": false, "config": null },
33 "origin_shield": { "enabled": false, "config": null }
34 }
35 },
36 …
37 }
38}

path_prefix está vazio, então o caminho chega à origem sem mudança. Anote o id: a regra o passa como <connector-id>. O connector existe na sua conta.

Para criar o connector no Azion Console:

Abra a página Connectors

Acesse Azion Console > Connectors.

Inicie um connector

A página Create Connector abre.

Nomeie o connector

Em General, digite my-connector em Name.

Selecione o tipo HTTP

Em Connector Type, selecione HTTP.

Digite o endereço da segunda origem

Em Address Management, digite httpbin.org em Address, sem protocolo e sem porta.

Envie o próprio nome da origem no header Host

Em Host, digite httpbin.org.

Conecte-se à origem somente por HTTPS

Em Transport Protocol Policy, selecione Force HTTPS.

Selecione Create

O connector existe na sua conta, e a regra que você adiciona à sua aplicação o seleciona.

Envie um caminho para o connector

Uma regra no Rules Engine para Applications combina critérios com behaviors. Esta regra roda na fase de requisição da sua aplicação. O critério dela, ${uri} começando com /anything, corresponde a toda requisição sob esse caminho. O behavior dela, Set Connector, envia cada requisição correspondente para o connector novo. Para mais informações, consulte Set Connector.

A regra dos primeiros passos com Applications corresponde a todo caminho, inclusive /anything. Quando várias regras correspondentes carregam Set Connector, somente a última roda. Mantenha esta regra depois da regra que corresponde a tudo, para que ela decida o connector de /anything. Na API, uma regra nova vai depois das regras que a aplicação já tem: a segunda regra de uma aplicação é armazenada com order definido como 1.

Para criar a regra com a Azion CLI, mantenha a regra em um arquivo: em uma linha de comando, o shell expandiria ${uri}. Salve este corpo como rule.json e substitua <connector-id> pelo ID do connector novo:

JSON
01{
02 "name": "send-path-to-connector",
03 "active": true,
04 "criteria": [
05 [
06 {
07 "variable": "${uri}",
08 "conditional": "if",
09 "operator": "starts_with",
10 "argument": "/anything"
11 }
12 ]
13 ],
14 "behaviors": [
15 {
16 "type": "set_connector",
17 "attributes": { "value": <connector-id> }
18 }
19 ]
20}

Crie a regra na fase de requisição da sua aplicação. Substitua <application-id> pelo ID da sua aplicação:

azion create rules-engine --application-id <application-id> --phase request --file rule.json

A saída traz o ID da regra nova:

Created Rules Engine with ID <rule-id>

A regra está ativa na sua aplicação e envia toda requisição sob /anything para o connector.

Para criar a regra com a API, mantenha o corpo da requisição em um arquivo: em uma linha de comando, o shell expandiria ${uri}. Salve este corpo como rule.json e substitua <connector-id> pelo ID do connector novo:

JSON
01{
02 "name": "send-path-to-connector",
03 "active": true,
04 "criteria": [
05 [
06 {
07 "variable": "${uri}",
08 "conditional": "if",
09 "operator": "starts_with",
10 "argument": "/anything"
11 }
12 ]
13 ],
14 "behaviors": [
15 {
16 "type": "set_connector",
17 "attributes": { "value": <connector-id> }
18 }
19 ]
20}

Envie uma requisição POST para as regras da fase de requisição da sua aplicação. Substitua <application-id> pelo ID da sua aplicação:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/applications/<application-id>/request_rules \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data @rule.json

A API responde com 202 e "state": "pending", e a resposta retorna a regra armazenada com o id e o order dela. A regra está ativa na sua aplicação e envia toda requisição sob /anything para o connector.

Para criar a regra no Azion Console:

Abra a aplicação

Acesse Azion Console > Applications e selecione a aplicação dos primeiros passos com Applications.

Selecione a aba Rules Engine
Selecione + Rule
Nomeie a regra

Em General, digite send-path-to-connector em Name.

Selecione a fase de requisição

Em Phase, selecione Request Phase. A fase de uma regra não pode mudar depois que você cria a regra.

Defina o critério

Em Criteria, selecione a variável ${uri} e o operador starts_with e digite /anything como argumento.

Selecione o behavior Set Connector

Em Behaviors, selecione Set Connector.

Selecione o seu connector

Em Connector, selecione my-connector, o connector que você criou para a segunda origem.

Selecione Save

A regra aparece na aba Rules Engine, sob o título Request.

Verifique a resposta

A verificação é a mesma, qualquer que seja a interface que criou o connector e a regra. No comando, substitua <workload-domain> pelo workload domain do seu workload.

Um connector novo e uma regra nova levam vários minutos para chegar à infraestrutura distribuída da Azion, e os data centers os aplicam em momentos diferentes. Até lá, uma requisição para /anything ainda pode chegar à origem do seu primeiro connector. Repita a requisição até a segunda origem responder. Para mais informações, consulte Propagação.

Envie uma requisição para o caminho a que a regra corresponde:

curl -s https://<workload-domain>/anything

httpbin.org responde com uma cópia em JSON da requisição que recebeu. Este trecho mantém o header Host e a URL:

JSON
01{
02 …
03 "headers": {
04 …
05 "Host": "httpbin.org",
06 …
07 },
08 …
09 "url": "https://httpbin.org/anything"
10}

Host é httpbin.org, o valor que o connector envia, e não o seu workload domain. url mostra que o caminho chegou à origem sem mudança. Uma requisição para qualquer outro caminho, como /, continua chegando à origem do seu primeiro connector. A sua aplicação envia um caminho para uma segunda origem por um connector próprio.

Próximos passos

Primeiros passos com Load BalancerAtive Load Balancer no connector, adicione um segundo endereço e distribua as requisições entre os dois.Origin IP ACL e HMACAtive Origin Shield no connector para permitir somente os endereços da Azion na sua origem e assinar requisições com HMAC.Ingestão e entregaComo um connector do tipo live_ingest recebe uma transmissão ao vivo para entrega.Configurações de connectorCada campo de um connector, com o tipo, o padrão, os valores permitidos e os erros que a API retorna.