Version information
Start using this module
Add this module to your Puppetfile:
mod 'puppetlabs-haproxy', '0.3.0'
Learn more about managing modules with a PuppetfileDocumentation
PuppetLabs Module for haproxy
HAProxy is an HA proxying daemon for load-balancing to clustered services. It can proxy TCP directly, or other kinds of traffic such as HTTP.
Basic Usage
This haproxy uses storeconfigs to collect and realize balancer member servers on a load balancer server. Currently Redhat family OSes are supported.
To install and configure HAProxy server listening on port 80
node 'haproxy-server' {
class { 'haproxy': }
haproxy::listen { 'puppet00':
ipaddress => $::ipaddress,
ports => '8140',
}
}
To add backend loadbalance members
node 'webserver01' {
@@haproxy::balancermember { $fqdn:
listening_service => 'puppet00',
server_names => $::hostname,
ipaddresses => $::ipaddress,
ports => '8140',
options => 'check'
}
}
Configuring haproxy options
The base haproxy
class can accept two parameters which will configure basic
behaviour of the haproxy server daemon:
global_options
to configure theglobal
section inhaproxy.cfg
defaults_options
to configure thedefaults
section inhaproxy.cfg
Configuring haproxy daemon listener
One haproxy::listen
defined resource should be defined for each HAProxy loadbalanced set of backend servers. The title of the haproxy::listen
resource is the key to which balancer members will be proxied to. The ipaddress
field should be the public ip address which the loadbalancer will be contacted on. The ports
attribute can accept an array or comma-separated list of ports which should be proxied to the haproxy::balancermember
nodes.
Configuring haproxy loadbalanced member nodes
The haproxy::balancermember
defined resource should be exported from each node
which is serving loadbalanced traffic. the listening_service
attribute will
associate it with haproxy::listen
directives on the haproxy node.
ipaddresses
and ports
will be assigned to the member to be contacted on. If an array of ipaddresses
and server_names
are provided then they will be added to the config in lock-step.
Dependencies
Tested and built on Ubuntu and CentOS
Copyright and License
Copyright (C) 2012 Puppet Labs Inc
Puppet Labs can be contacted at: info@puppetlabs.com
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
2013-05-25 - Version 0.3.0 Features:
- Add travis testing
- Add
haproxy::basancermember
define_cookies
parameter - Add array support to
haproxy::listen
ipaddress
parameter
Bugfixes:
- Documentation
- Listen -> Balancermember dependency
- Config line ordering
- Whitespace
- Add template lines for
haproxy::listen
mode
parameter
2012-10-12 - Version 0.2.0
- Initial public release
- Backwards incompatible changes all around
- No longer needs ordering passed for more than one listener
- Accepts multiple listen ips/ports/server_names
Dependencies
- ripienaar/concat (>= 0.1.0)