--- name: azion-shift-traffic-between-two-origins-by-weight description: >- Move a share of requests from one origin to another with Load Balancer weights, and take an origin out of rotation with one switch. --- # Shift traffic between two origins by weight You shift requests from one origin to another in steps, with the weights of the addresses of a [Load Balancer](/en/documentation/platform/connectors/#load-balancer) connector, from Azion Console, the API, or the Azion CLI. To keep a standby out of traffic until the primary fails instead, refer to [Add a backup origin to a connector](/en/documentation/guides/application-performance/availability/add-a-backup-origin-to-a-connector/). Under *Round Robin*, each address receives a share of the requests in proportion to its weight, a whole number from 1 to 100. The weight sets a proportion, not an exact split: each data center balances on its own, so the share an address receives varies around the one its weight asks for. A weight cannot be `0`, so an origin leaves the rotation through its **Active** switch, not through its weight. ```mermaid %%{init: {"layout": "dagre", "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 12, "rankSpacing": 12, "padding": 6, "wrappingWidth": 70, "minNodeWidth": 40, "useMaxWidth": true}}}%% flowchart TD Pool["Both origins on the connector, weighted"] --> Hold["Hold the current weights"] Hold --> Errors{"New errors on the new origin?"} Errors -->|"yes"| Back["Turn the new origin's address off"] Errors -->|"no"| Share{"Does the new origin carry the share you want?"} Share -->|"no"| Raise["Raise the new origin's weight"] Raise --> Hold Share -->|"yes"| Cut["Turn the old origin's address off"] ``` 1. Both origins sit on one connector as *Primary* addresses, and the new origin starts with a small weight. 2. Hold each set of weights until the new origin has served enough requests to show its errors. 3. When new errors appear, turn the new origin's address off to roll back. 4. When no new error appears, raise the new origin's weight, and hold again. 5. When the new origin carries the share you want, turn the old origin's address off to cut over. --- ## Prerequisites - A connector of type `http` that reaches the current origin, and a rule whose *Set Connector* behavior sends requests to it. To create both, refer to [Connectors quickstart](/en/documentation/platform/connectors/quickstart/). - A new origin that holds the same application as the current one. Every address of a connector receives the same `Host` header, so both origins must answer for the same name. - Access to Azion Console, for the Console procedure. Refer to [Access Azion Console](/en/documentation/guides/platform/account-and-billing/how-to-access-azion-console/). - A [personal token](/en/documentation/guides/platform/account-and-billing/personal-tokens/) and the ID of the connector, for the API procedure. - The [Azion CLI](/en/documentation/devtools/cli/) installed and authorized, and the ID of the connector, for the CLI procedure. The examples use `old-origin.example.com` for the current origin and `new-origin.example.com` for the new one. Replace them with yours. --- ## Put both origins on the connector The connector gets Load Balancer with *Round Robin*, and the new origin joins as a second *Primary* address. A weight of `9` on the current origin and `1` on the new one sends about one request in ten to the new origin. A connector holds up to 15 addresses with Load Balancer on. **Host** takes a name both origins answer for, such as `${host}`, which sends the host the client requested. A literal name of the current origin would reach the new origin under a name it may not answer for. The examples set **Max Retries**, **Connection Timeout**, and **Read/Write Timeout** to `3`, `30`, and `60`, the values the Console fills in. The API and the CLI give a key the body leaves out `0`, `60`, and `120`. **Console** To put both origins on the connector in Azion Console: 1. **Open the connector** Access [Azion Console](https://console.azion.com/) > **Connectors**, and select the connector of the current origin. 2. **Send a host both origins answer for** In **Host**, enter `${host}`. 3. **Turn on Load Balancer** In **Modules**, turn on **Load Balancer**. The form fills in **Max Retries**, **Connection Timeout**, and **Read/Write Timeout**. 4. **Select Round Robin** In **Load Balancer Configuration**, set **Method** to *Round Robin*. 5. **Weight the current origin** Under **Address Management**, on `old-origin.example.com`, set **Server Role** to *Primary* and enter `9` in **Weight**. 6. **Select Add Address** 7. **Enter the new origin** In the new **Address**, enter `new-origin.example.com`, without a protocol or a port. 8. **Weight the new origin** Set **Server Role** to *Primary* and enter `1` in **Weight**. 9. **Select Save** The Console shows `Connector has been updated`. **API** To put both origins on the connector with the API, send a `PATCH` request. `addresses` replaces the list of addresses, so the body carries the current origin as well: ```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 } } } } }' ``` The API answers `202` with `"state": "pending"`. A `PATCH` keeps the connection options the body leaves out. **CLI** The update command takes the whole connector from a file, with every field the connector keeps. To read the current settings of the connector: ```bash azion describe connector --connector-id --format json ``` The command prints the full object. On a connector of type `http`, `attributes` holds `addresses`, `connection_options`, and `modules`. Save the connector as `connector.json`, with both origins and Load Balancer on. Replace `name` and the other `connection_options` with the values the command printed: ```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 } } } } } ``` Update the connector from the file. The command needs `--type` even though the file names the type: ```bash azion update connector --connector-id --type http --file connector.json ``` The output confirms the update: ```text Updated Connector with ID ``` The connector holds two active addresses and sends about one request in ten to the new origin. A connector change reaches Azion's distributed infrastructure over several minutes, and until every data center holds it, some requests reach the current origin alone. --- ## Change the weights Each step changes only the weights. Hold a step long enough for the new origin to serve the requests that expose its faults before you take the next one. Each record of the *HTTP Requests* data source of [Real-Time Events](/en/documentation/platform/real-time-events/data-sources/#http-requests) carries **Upstream Status** and **Upstream Addr**, the status and the address of the origin that answered, so a filter on the new origin's address shows its errors. **Console** To change the weights in Azion Console: 1. **Open the connector** Access [Azion Console](https://console.azion.com/) > **Connectors**, and select the connector. 2. **Set the current origin's weight** Under **Address Management**, on `old-origin.example.com`, enter the new weight in **Weight**, such as `5`. 3. **Set the new origin's weight** On `new-origin.example.com`, enter the new weight in **Weight**, such as `5`. 4. **Select Save** The Console shows `Connector has been updated`. **API** To change the weights with the API, send both addresses with their new weights. A `PATCH` with only `addresses` keeps the Load Balancer configuration of the 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 } } } ] } }' ``` The API answers `202` with `"state": "pending"`. A weight of `0` is refused with `10050`, and a weight above `100` with `10068`. **CLI** To change the weights with the Azion CLI, edit the `weight` of both addresses in `connector.json`, such as `5` and `5`, and update the connector from the file: ```bash azion update connector --connector-id --type http --file connector.json ``` The output confirms the update: ```text Updated Connector with ID ``` The new origin receives the share of the new weights once the change reaches each data center. During the spread, some data centers still apply the previous weights, so judge a step only after it has spread. --- ## Take an origin out of rotation The **Active** switch of an address takes it out of rotation without deleting it. The address keeps its ports, role, and weight, so turning it back on restores the step it left. Turning the new origin's address off rolls back, and turning the current origin's address off cuts over. **Console** To take the new origin out in Azion Console: 1. **Open the connector** Access [Azion Console](https://console.azion.com/) > **Connectors**, and select the connector. 2. **Turn the address off** Under **Address Management**, on `new-origin.example.com`, turn off **Active**. 3. **Select Save** The Console shows `Connector has been updated`. To cut over instead, turn off **Active** on `old-origin.example.com`. **API** To take the new origin out with the API, send both addresses with `"active": false` on the new one: ```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 } } } ] } }' ``` The API answers `202` with `"state": "pending"`. To cut over instead, move `"active": false` to the current origin's address. **CLI** To take the new origin out with the Azion CLI, add `"active": false` to the `new-origin.example.com` address in `connector.json`, and update the connector from the file: ```bash azion update connector --connector-id --type http --file connector.json ``` The output confirms the update: ```text Updated Connector with ID ``` To cut over instead, move `"active": false` to the current origin's address. The address that is off receives no request once every data center holds the change. The change takes several minutes to spread, so keep the origin you turned off answering until no request reaches it. --- ## Next steps - [Balancing methods](/en/documentation/platform/connectors/load-balancer/balancing-methods.md#weight): How the weight, the method, and active addresses decide where each request goes. - [Add a backup origin to a connector](/en/documentation/guides/application-performance/availability/add-a-backup-origin-to-a-connector.md): Keep the old origin as a standby after the cutover, out of daily traffic. - [Migrate an application to a new origin without downtime](/en/documentation/use-cases/build-and-run-applications/migrate-an-application-to-a-new-origin-without-downtime.md): A weight schedule from one request in a hundred to the cutover, with the checks of each step. - [Load Balancer quickstart](/en/documentation/platform/connectors/load-balancer/quickstart.md): Enable Load Balancer on a first connector and see both addresses answer.