remove site config from the load balancers

This block is part of the nginx group and was last modified in core v15.0.0.

remove site config from the load balancers condition v15.0.0

Remove a live site config and reload nginx, per node. The far side refuses when the remaining set would not validate without it, and archives rather than destroys.

In pins 2 + flow

flow
flow
Site required
value
The site to remove.
Load balancers required
array
Where to remove. ONE node on a shared-fs fleet; every node on an independent fleet.

Out pins 6 + flow

flow
flow
Success
condition
True when every target node removed the site.
Site
value
The site that was removed.
Results
array
Per node: name, host, ok, output, exit_code.
Applied count
number
How many nodes removed it.
Node count
number
How many nodes were asked.
Error
value
Why the removal was refused or incomplete.

Removes a live site config, per node, through the fleet's validated contract: the far side first proves the REMAINING live set still passes nginx -t without this file (a site another config depends on stays live, with the reason in the per-node output), then archives the file : nothing is destroyed : and reloads. On a shared-filesystem fleet pass exactly one node, same convergence rule as nginxsite_push: the other nodes' watchers pick the removal up within seconds. On an independent fleet, list every node.

remove nginx site

delete site config

A typical wiring for remove site config from the load balancers: a function trigger starts the flow; value feeds the site pin; with values feeds the nodes pin; the flow out pin feeds debug.

Version history

Introduced in v15.0.0.

Back to nginx Return to the main group to view all sub-groups Back to Load balancers Return to the group to view all blocks within this group