Applying changes
7 answers
Making things live, and putting them back.
Looking for something specific
The searchable index covers all 326 answers at once and filters as you type.
281 Make my changes live
Press Apply config. Everything you have saved is built into a full configuration, staged on every node, tested with each node's own nginx binary, and only then swapped in.
If any node refuses, every node keeps what it had and you are told exactly what was wrong.
282 I changed something and nothing happened
You saved it and did not apply it. Saving changes nothing for your visitors, which is the point: you can save as often as you like and apply when you are ready. The banner at the top of every page says when something is saved and not live.
283 See what is about to change before I apply
The Changes page shows what is saved and not yet live, and what it changes. Read it before applying, particularly if somebody else has been working on the same thing, because you are about to make their changes live along with your own.
284 Undo a change I just made
Changes page, look at the history, and put an earlier version back. It applies the same way any other change is applied: built, checked, staged on every node, tested, then swapped in. So a rollback cannot break the fleet either.
285 Why did my apply get a warning?
The most common one is a pool with no healthy servers in it, which means the site would serve errors. A warning is not a refusal: sometimes serving an error page from a pool you are about to fill is exactly what you meant to do.
286 What if a node was switched off during an apply?
It does not block the change. The change goes into that node's queue and is replayed when it comes back, so it catches up rather than quietly drifting.
287 Does applying drop connections?
No. An nginx reload is graceful: the master starts new workers with the new config, hands them the new connections, and lets the old workers finish what they were doing before they stop. Nobody is disconnected and no request is dropped.
The one thing to know is that very long lived connections, such as WebSockets, keep old workers around until they close.