salt.modules.haproxyconn¶

Support for haproxy

New in version 2014.7.0.

salt.modules.haproxyconn.disable_server(name, backend, socket='/var/run/haproxy.sock')¶

Disable server in haproxy.

name: Server to disable
backend: haproxy backend, or all backends if "*" is supplied
socket: haproxy stats socket

CLI Example:

salt '*' haproxy.disable_server db1.example.com mysql

salt.modules.haproxyconn.enable_server(name, backend, socket='/var/run/haproxy.sock')¶

Enable Server in haproxy

name: Server to enable
backend: haproxy backend, or all backends if "*" is supplied
socket: haproxy stats socket

CLI Example:

salt '*' haproxy.enable_server web1.example.com www

salt.modules.haproxyconn.get_sessions(name, backend, socket='/var/run/haproxy.sock')¶

New in version Carbon.

Get number of current sessions on server in backend (scur)

name: Server name
backend: haproxy backend
socket: haproxy stats socket

CLI Example:

salt '*' haproxy.get_sessions web1.example.com www

salt.modules.haproxyconn.get_weight(name, backend, socket='/var/run/haproxy.sock')¶

Get server weight

name: Server name
backend: haproxy backend
socket: haproxy stats socket

CLI Example:

salt '*' haproxy.get_weight web1.example.com www

salt.modules.haproxyconn.list_servers(backend, socket='/var/run/haproxy.sock', objectify=False)¶

List servers in haproxy backend.

backend: haproxy backend
socket: haproxy stats socket

CLI Example:

salt '*' haproxy.list_servers mysql

salt.modules.haproxyconn.set_state(name, backend, state, socket='/var/run/haproxy.sock')¶

Force a server's administrative state to a new state. This can be useful to disable load balancing and/or any traffic to a server. Setting the state to "ready" puts the server in normal mode, and the command is the equivalent of the "enable server" command. Setting the state to "maint" disables any traffic to the server as well as any health checks. This is the equivalent of the "disable server" command. Setting the mode to "drain" only removes the server from load balancing but still allows it to be checked and to accept new persistent connections. Changes are propagated to tracking servers if any.

name: Server name
backend: haproxy backend
state: A string of the state to set. Must be 'ready', 'drain', or 'maint'

salt.modules.haproxyconn.set_weight(name, backend, weight=0, socket='/var/run/haproxy.sock')¶

Set server weight

name: Server name
backend: haproxy backend
weight: Server Weight
socket: haproxy stats socket

CLI Example:

salt '*' haproxy.set_weight web1.example.com www 13

salt.modules.haproxyconn.show_backends(socket='/var/run/haproxy.sock')¶

Show HaProxy Backends

socket: haproxy stats socket

CLI Example:

salt '*' haproxy.show_backends

salt.modules.haproxyconn.show_frontends(socket='/var/run/haproxy.sock')¶

Show HaProxy frontends

socket: haproxy stats socket

CLI Example:

salt '*' haproxy.show_frontends