19 releases (12 breaking)
Uses old Rust 2015
0.13.0 | Jul 8, 2021 |
---|---|
0.11.59 | Apr 19, 2021 |
0.11.52 | Jan 14, 2021 |
0.11.50 | Oct 22, 2020 |
0.2.0 | Apr 20, 2017 |
#5 in #proxy-config
520KB
12K
SLoC
sozuctl, a command line interface for the sozu proxy
Sozuctl is a command line interface for the proxy. You can send configuration orders (e.g. Add a new worker) or reclaim some metrics at the proxy with this executable. Sozuctl talks to the proxy through a unix socket.
You can specify its path by adding to your config.toml
:
command_socket = "path/to/your/command_folder/sock"
Add application with http frontend
First you need to create a new application with an id and a load balancing policy (roundrobin or random):
sozuctl --config /etc/sozu/config.toml application add --id <my_application_id> --load-balancing-policy roundrobin
It won't show anything but you can verify that the application has been added successfully by querying sozu:
sozuctl --config /etc/sozu/config.toml query applications
Then you need to add a backend:
sozuctl --config /etc/sozu/config.toml backend add --address 127.0.0.1:3000 --backend-id <my_backend_id> --id <my_application_id>
Finally you have to create a frontend to allow sozu to send traffic from the listener to your backend:
sozuctl --config /etc/sozu/config.toml frontend http add --address 0.0.0.0:80 --hostname <my_application_hostname> --id <my_application_id>
Check the status of sozu
It shows a list of workers and show informations about their statuses.
sozuctl --config /etc/sozu/config.toml status
Get metrics and statistics
It will show global statistics about sozu, workers and applications metrics.
sozuctl --config /etc/sozu/config.toml metrics
Dump and restore state
If sozu configurations (applications, frontends & backends) are not written in the config file, you can save sozu state to restore it later.
sozuctl --config /etc/sozu/config.toml state save --file state.json
Then shutdown gracefully sozu:
sozuctl --config /etc/sozu/config.toml shutdown
Restart sozu and restore its state:
sozuctl --config /etc/sozu/config.toml state load --file state.json
You should be able to request your application like before the shutdown.
Dependencies
~13MB
~225K SLoC