--- name: azion-mova-o-trafego-entre-duas-origens-por-peso description: >- Mova uma parte das requisições de uma origem para outra com os pesos de Load Balancer e tire uma origem da rotação com um switch. --- # Mova o tráfego entre duas origens por peso Você move requisições de uma origem para outra em etapas, com os pesos dos endereços de um connector com [Load Balancer](/pt-br/documentacao/plataforma/connectors/#load-balancer), pelo Azion Console, pela API ou pela Azion CLI. Para manter uma origem de reserva fora do tráfego até que a primária falhe, consulte [Adicione uma origem de backup a um connector](/pt-br/documentacao/guias/performance-e-confiabilidade/disponibilidade/adicionar-uma-origem-de-backup-a-um-connector/). Com *Round Robin*, cada endereço recebe uma parte das requisições proporcional ao seu peso, um número inteiro de 1 a 100. O peso define uma proporção, não uma divisão exata: cada data center balanceia por conta própria, então a parte que um endereço recebe varia em torno da que o seu peso pede. Um peso não pode ser `0`, então uma origem sai da rotação pelo switch **Active**, não pelo peso. ```mermaid %%{init: {"layout": "dagre", "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 12, "rankSpacing": 12, "padding": 6, "wrappingWidth": 70, "minNodeWidth": 40, "useMaxWidth": true}}}%% flowchart TD Pool["As duas origens no connector, com pesos"] --> Hold["Mantenha os pesos atuais"] Hold --> Errors{"Novos erros na nova origem?"} Errors -->|"sim"| Back["Desative o endereço da nova origem"] Errors -->|"não"| Share{"A nova origem recebe a parte que você quer?"} Share -->|"não"| Raise["Aumente o peso da nova origem"] Raise --> Hold Share -->|"sim"| Cut["Desative o endereço da origem antiga"] ``` 1. As duas origens ficam em um connector como endereços *Primary*, e a nova origem começa com um peso pequeno. 2. Mantenha cada conjunto de pesos até que a nova origem tenha atendido requisições suficientes para mostrar os seus erros. 3. Quando aparecem novos erros, desative o endereço da nova origem para fazer o rollback. 4. Quando nenhum erro novo aparece, aumente o peso da nova origem e mantenha de novo. 5. Quando a nova origem recebe a parte que você quer, desative o endereço da origem antiga para fazer o cutover. --- ## Pré-requisitos - Um connector do tipo `http` que alcança a origem atual e uma regra cujo comportamento *Set Connector* envia requisições a ele. Para criar os dois, consulte [Primeiros passos com Connectors](/pt-br/documentacao/plataforma/connectors/primeiros-passos/). - Uma nova origem que guarda a mesma aplicação da atual. Todo endereço de um connector recebe o mesmo header `Host`, então as duas origens devem responder pelo mesmo nome. - Acesso ao Azion Console, para o procedimento pelo Console. Consulte [Como acessar o Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). - Um [personal token](/pt-br/documentacao/guias/plataforma/conta-e-billing/personal-tokens/) e o ID do connector, para o procedimento pela API. - A [Azion CLI](/pt-br/documentacao/devtools/cli/) instalada e autorizada, e o ID do connector, para o procedimento pela CLI. Os exemplos usam `old-origin.example.com` para a origem atual e `new-origin.example.com` para a nova. Substitua-os pelos seus. --- ## Coloque as duas origens no connector O connector recebe Load Balancer com *Round Robin*, e a nova origem entra como um segundo endereço *Primary*. Um peso `9` na origem atual e `1` na nova envia cerca de uma requisição em dez para a nova origem. Um connector guarda até 15 endereços com Load Balancer ativado. **Host** recebe um nome pelo qual as duas origens respondem, como `${host}`, que envia o host que o cliente requisitou. Um nome literal da origem atual chegaria à nova origem com um nome pelo qual ela pode não responder. Os exemplos definem **Max Retries**, **Connection Timeout** e **Read/Write Timeout** como `3`, `30` e `60`, os valores que o Console preenche. A API e a CLI dão a uma chave que o corpo deixa de fora os valores `0`, `60` e `120`. **Console** Para colocar as duas origens no connector pelo Azion Console: 1. **Abra o connector** Acesse [Azion Console](https://console.azion.com/) > **Connectors** e selecione o connector da origem atual. 2. **Envie um host pelo qual as duas origens respondem** Em **Host**, insira `${host}`. 3. **Ative Load Balancer** Em **Modules**, ative **Load Balancer**. O formulário preenche **Max Retries**, **Connection Timeout** e **Read/Write Timeout**. 4. **Selecione Round Robin** Em **Load Balancer Configuration**, defina **Method** como *Round Robin*. 5. **Defina o peso da origem atual** Em **Address Management**, em `old-origin.example.com`, defina **Server Role** como *Primary* e insira `9` em **Weight**. 6. **Selecione Add Address** 7. **Insira a nova origem** No novo **Address**, insira `new-origin.example.com`, sem protocolo nem porta. 8. **Defina o peso da nova origem** Defina **Server Role** como *Primary* e insira `1` em **Weight**. 9. **Selecione Save** O Console mostra `Connector has been updated`. **API** Para colocar as duas origens no connector pela API, envie uma requisição `PATCH`. `addresses` substitui a lista de endereços, então o corpo também carrega a origem atual: ```bash curl --request PATCH \ --url https://api.azion.com/v4/workspace/connectors/ \ --header 'Accept: application/json' \ --header 'Authorization: Token ' \ --header 'Content-Type: application/json' \ --data '{ "attributes": { "addresses": [ { "address": "old-origin.example.com", "modules": { "load_balancer": { "server_role": "primary", "weight": 9 } } }, { "address": "new-origin.example.com", "modules": { "load_balancer": { "server_role": "primary", "weight": 1 } } } ], "connection_options": { "host": "${host}" }, "modules": { "load_balancer": { "enabled": true, "config": { "method": "round_robin", "max_retries": 3, "connection_timeout": 30, "read_write_timeout": 60 } } } } }' ``` A API responde `202` com `"state": "pending"`. Um `PATCH` mantém as opções de conexão que o corpo deixa de fora. **CLI** O comando de atualização recebe o connector inteiro de um arquivo, com todos os campos que o connector mantém. Para ler as configurações atuais do connector: ```bash azion describe connector --connector-id --format json ``` O comando imprime o objeto completo. Em um connector do tipo `http`, `attributes` contém `addresses`, `connection_options` e `modules`. Salve o connector como `connector.json`, com as duas origens e Load Balancer ativado. Substitua `name` e as outras `connection_options` pelos valores que o comando imprimiu: ```json { "name": "", "active": true, "type": "http", "attributes": { "addresses": [ { "address": "old-origin.example.com", "modules": { "load_balancer": { "server_role": "primary", "weight": 9 } } }, { "address": "new-origin.example.com", "modules": { "load_balancer": { "server_role": "primary", "weight": 1 } } } ], "connection_options": { "dns_resolution": "both", "transport_policy": "preserve", "host": "${host}" }, "modules": { "load_balancer": { "enabled": true, "config": { "method": "round_robin", "max_retries": 3, "connection_timeout": 30, "read_write_timeout": 60 } } } } } ``` Atualize o connector a partir do arquivo. O comando precisa de `--type`, mesmo que o arquivo nomeie o tipo: ```bash azion update connector --connector-id --type http --file connector.json ``` A saída confirma a atualização: ```text Updated Connector with ID ``` O connector guarda dois endereços ativos e envia cerca de uma requisição em dez para a nova origem. Uma alteração de connector chega à infraestrutura distribuída da Azion em vários minutos e, até que todos os data centers a recebam, algumas requisições chegam só à origem atual. --- ## Altere os pesos Cada etapa altera só os pesos. Mantenha uma etapa por tempo suficiente para que a nova origem atenda as requisições que revelam as suas falhas antes de passar à próxima. Cada registro da fonte de dados *HTTP Requests* de [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/fontes-de-dados/#http-requests) traz **Upstream Status** e **Upstream Addr**, o status e o endereço da origem que respondeu, então um filtro pelo endereço da nova origem mostra os erros dela. **Console** Para alterar os pesos pelo Azion Console: 1. **Abra o connector** Acesse [Azion Console](https://console.azion.com/) > **Connectors** e selecione o connector. 2. **Defina o peso da origem atual** Em **Address Management**, em `old-origin.example.com`, insira o novo peso em **Weight**, como `5`. 3. **Defina o peso da nova origem** Em `new-origin.example.com`, insira o novo peso em **Weight**, como `5`. 4. **Selecione Save** O Console mostra `Connector has been updated`. **API** Para alterar os pesos pela API, envie os dois endereços com os novos pesos. Um `PATCH` só com `addresses` mantém a configuração de Load Balancer do connector: ```bash curl --request PATCH \ --url https://api.azion.com/v4/workspace/connectors/ \ --header 'Accept: application/json' \ --header 'Authorization: Token ' \ --header 'Content-Type: application/json' \ --data '{ "attributes": { "addresses": [ { "address": "old-origin.example.com", "modules": { "load_balancer": { "server_role": "primary", "weight": 5 } } }, { "address": "new-origin.example.com", "modules": { "load_balancer": { "server_role": "primary", "weight": 5 } } } ] } }' ``` A API responde `202` com `"state": "pending"`. Um peso `0` é recusado com `10050`, e um peso acima de `100` com `10068`. **CLI** Para alterar os pesos pela Azion CLI, edite o `weight` dos dois endereços em `connector.json`, como `5` e `5`, e atualize o connector a partir do arquivo: ```bash azion update connector --connector-id --type http --file connector.json ``` A saída confirma a atualização: ```text Updated Connector with ID ``` A nova origem recebe a parte dos novos pesos quando a alteração chega a cada data center. Durante a propagação, alguns data centers ainda aplicam os pesos anteriores, então avalie uma etapa só depois que ela se propagou. --- ## Tire uma origem da rotação O switch **Active** de um endereço o tira da rotação sem excluí-lo. O endereço mantém as portas, a função e o peso, então ativá-lo de novo restaura a etapa que ele deixou. Desativar o endereço da nova origem faz o rollback, e desativar o endereço da origem atual faz o cutover. **Console** Para tirar a nova origem pelo Azion Console: 1. **Abra o connector** Acesse [Azion Console](https://console.azion.com/) > **Connectors** e selecione o connector. 2. **Desative o endereço** Em **Address Management**, em `new-origin.example.com`, desative **Active**. 3. **Selecione Save** O Console mostra `Connector has been updated`. Para fazer o cutover, desative **Active** em `old-origin.example.com`. **API** Para tirar a nova origem pela API, envie os dois endereços com `"active": false` na nova: ```bash curl --request PATCH \ --url https://api.azion.com/v4/workspace/connectors/ \ --header 'Accept: application/json' \ --header 'Authorization: Token ' \ --header 'Content-Type: application/json' \ --data '{ "attributes": { "addresses": [ { "address": "old-origin.example.com", "modules": { "load_balancer": { "server_role": "primary", "weight": 5 } } }, { "address": "new-origin.example.com", "active": false, "modules": { "load_balancer": { "server_role": "primary", "weight": 5 } } } ] } }' ``` A API responde `202` com `"state": "pending"`. Para fazer o cutover, mova `"active": false` para o endereço da origem atual. **CLI** Para tirar a nova origem pela Azion CLI, adicione `"active": false` ao endereço `new-origin.example.com` em `connector.json` e atualize o connector a partir do arquivo: ```bash azion update connector --connector-id --type http --file connector.json ``` A saída confirma a atualização: ```text Updated Connector with ID ``` Para fazer o cutover, mova `"active": false` para o endereço da origem atual. O endereço desativado não recebe nenhuma requisição quando todos os data centers recebem a alteração. A alteração leva vários minutos para se propagar, então mantenha a origem que você desativou respondendo até que nenhuma requisição chegue a ela. --- ## Próximos passos - [Métodos de balanceamento](/pt-br/documentacao/plataforma/connectors/load-balancer/metodos-de-balanceamento.md#peso): Como o peso, o método e os endereços ativos decidem para onde vai cada requisição. - [Adicione uma origem de backup a um connector](/pt-br/documentacao/guias/performance-e-confiabilidade/disponibilidade/adicionar-uma-origem-de-backup-a-um-connector.md): Mantenha a origem antiga como reserva depois do cutover, fora do tráfego diário. - [Migrar uma aplicação para uma nova origem sem downtime](/pt-br/documentacao/casos-de-uso/construir-e-executar-aplicacoes/migrar-uma-aplicacao-para-uma-nova-origem-sem-downtime.md): Um cronograma de pesos de uma requisição em cem até o cutover, com as verificações de cada etapa. - [Primeiros passos com Load Balancer](/pt-br/documentacao/plataforma/connectors/load-balancer/primeiros-passos.md): Ative Load Balancer em um primeiro connector e veja os dois endereços responderem.