This is a little script to manage nginx upstreams.
The intention is to put upstream_manager.py, plus a config.yaml, into a directory somewhere that you'd like nginx to look for upstream definitions to be included from other configuration files.
For example, you might create /etc/nginx/upstreams/ for these files. Then in your server configs, you can include them before you use the upstream definitions.
Given a configuration file, the script creates and manages the appropriate nginx configurations.
Invoke the script via:
upstream_manager.py <cluster> <action> [...]
Available actions are:
- 'generate' which simply generates a file from the config for the provided cluster
- 'enable' and 'disable' which comment out a server or mark it as down, depending on whether or not you're using ip_hash. Requires another 'server' argument.
- 'weight' which changes the weight of a given server. Requires a server and a new value.
- 'rotate' which is designed for automated deployments; called subsequently, it will temporarily disable each of your upstream servers in order, printing out the IP of the server it disabled so you can hook into a deployment script. Once it's done all of them, it'll return 'Done' on the last invocation, and the next one will start another rotation.
See config.yaml.sample for a sample configuration, and fancycluster.conf.sample for the configuration that would generate.
