haproxy
: A Puppet module, using storeconfigs, to model an haproxy configuration. Currently VERY limited - assumes Redhat/CentOS setup. Pull requests ahaproxy::globals
: For global configuration options used by all haproxy instances.haproxy::params
: This is a container class holding default parameters for for haproxy class.
haproxy::backend
: This type will setup a backend service configuration block inside the haproxy.cfg file on an haproxy load balancer.haproxy::balancermember
: This type will setup a balancer member inside a listening service configuration block in /etc/haproxy/haproxy.cfg on the load balancer.haproxy::defaults
: This type will setup a additional defaults configuration block inside the haproxy.cfg file on an haproxy load balancer.haproxy::frontend
: This type will setup a frontend service configuration block inside the haproxy.cfg file on an haproxy load balancer.haproxy::instance
: Manages haproxy permitting multiple instances to run on the same machine.haproxy::instance_service
: Set up the environment for an haproxy service.haproxy::listen
: This type will setup a listening service configuration block inside the haproxy.cfg file on an haproxy load balancer.haproxy::mailer
: This type will set up a mailer entry inside the mailers configuration block in haproxy.cfg on the load balancer.haproxy::mailers
: This type will set up a mailers entry in haproxy.cfg on the load balancer.haproxy::mapfile
: Manage an HAProxy map file as documented in https://cbonte.github.io/haproxy-dconv/configuration-1.5.html#7.3.1-maphaproxy::mapfile::entry
: Manage an HAProxy map file as documented in https://cbonte.github.io/haproxy-dconv/configuration-1.5.html#7.3.1-maphaproxy::peer
: This type will set up a peer entry inside the peers configuration block in haproxy.cfg on the load balancer.haproxy::peer::collect_exported
: Private definehaproxy::peers
: This type will set up a peers entry in haproxy.cfghaproxy::resolver
: This type will setup resolvers configuration block inside the haproxy.cfg file on an haproxy load balancer.haproxy::userlist
: This type will set up a userlist configuration block inside the haproxy.cfg file on an haproxy load balancer.
haproxy::balancermember::collect_exported
haproxy::config
: HAProxy configurationhaproxy::install
: Install haproxyhaproxy::mailer::collect_exported
haproxy::service
: HAProxy service
haproxy::generate_error_message
: Function created to generate error message. Any string as error message can be passed and the function can be called in epp templates.haproxy::sort_bind
haproxy::validate_ip_addr
Haproxy::Ports
: Port or list of ports for haproxy. Supports,
seperated list of ports also.
A Puppet module, using storeconfigs, to model an haproxy configuration. Currently VERY limited - assumes Redhat/CentOS setup. Pull requests accepted!
Currently requires the puppetlabs/concat module on the Puppet Forge and uses storeconfigs on the Puppet Server to export/collect resources from all balancer members.
class { 'haproxy':
global_options => {
'log' => "${::ipaddress} local0",
'chroot' => '/var/lib/haproxy',
'pidfile' => '/var/run/haproxy.pid',
'maxconn' => '4000',
'user' => 'haproxy',
'group' => 'haproxy',
'daemon' => '',
'stats' => 'socket /var/lib/haproxy/stats'
},
defaults_options => {
'log' => 'global',
'stats' => 'enable',
'option' => 'redispatch',
'retries' => '3',
'timeout' => [
'http-request 10s',
'queue 1m',
'connect 10s',
'client 1m',
'server 1m',
'check 10s'
],
'maxconn' => '8000'
},
}
The following parameters are available in the haproxy
class:
package_ensure
package_name
service_ensure
service_manage
service_name
service_options
chroot_dir_manage
sysconfig_options
global_options
defaults_options
merge_options
restart_command
custom_fragment
config_dir
config_file
config_validate_cmd
manage_config_dir
manage_service
enable
Data type: Variant[Enum['present', 'absent', 'purged', 'disabled', 'installed', 'latest'], String[1]]
Ensure the package is present (installed), absent or a specific version. Defaults to 'present'
Default value: 'present'
Data type: String
The package name of haproxy. Defaults to 'haproxy' NOTE: haproxy::instance has a different default.
Default value: $haproxy::params::package_name
Data type: Variant[Enum['running', 'stopped'], Boolean]
Chooses whether the haproxy service should be running & enabled at boot, or stopped and disabled at boot. Defaults to 'running'
Default value: 'running'
Data type: Boolean
Chooses whether the haproxy service state should be managed by puppet at all. Defaults to true
Default value: true
Data type: String
The service name for haproxy. Defaults to 'haproxy' NOTE: haproxy::instance has a different default.
Default value: $haproxy::params::service_name
Data type: String
Contents for the /etc/defaults/haproxy
file on Debian. Defaults to "ENABLED=1\n" on Debian, and is ignored on other systems.
Default value: $haproxy::params::service_options
Data type: Boolean
Chooses whether the haproxy chroot directory should be managed by puppet at all. Defaults to true
Default value: true
Data type: String
Contents for the /etc/sysconfig/haproxy
file on RedHat(-based) systems.
Defaults to OPTIONS="" on RedHat(-based) systems and is ignored on others
Default value: $haproxy::params::sysconfig_options
Data type: Hash
A hash of all the haproxy global options. If you want to specify more than one option (i.e. multiple timeout or stats options), pass those options as an array and you will get a line for each of them in the resultant haproxy.cfg file.
Default value: $haproxy::params::global_options
Data type: Hash
A hash of all the haproxy defaults options. If you want to specify more than one option (i.e. multiple timeout or stats options), pass those options as an array and you will get a line for each of them in the resultant haproxy.cfg file.
Default value: $haproxy::params::defaults_options
Data type: Boolean
Whether to merge the user-supplied global_options
/defaults_options
hashes with their default values set in params.pp. Merging allows to change
or add options without having to recreate the entire hash. Defaults to
false, but will default to true in future releases.
Default value: $haproxy::params::merge_options
Data type: Optional[String]
Command to use when restarting the on config changes.
Passed directly as the 'restart'
parameter to the service resource.
Defaults to undef i.e. whatever the service default is.
Default value: undef
Data type: Optional[String]
Allows arbitrary HAProxy configuration to be passed through to support additional configuration not available via parameters, or to short-circute the defined resources such as haproxy::listen when an operater would rather just write plain configuration. Accepts a string (ie, output from the template() function). Defaults to undef
Default value: undef
Data type: Stdlib::Absolutepath
Path to the directory in which the main configuration file haproxy.cfg
resides. Will also be used for storing any managed map files (see
haproxy::mapfile
). Default depends on platform.
Default value: $haproxy::params::config_dir
Data type: Optional[Stdlib::Absolutepath]
Optional. Path to the haproxy config file. Default depends on platform.
Default value: $haproxy::params::config_file
Data type: Variant[Stdlib::Absolutepath, String]
Optional. Command used by concat validate_cmd to validate new config file concat is a valid haproxy config. Default /usr/sbin/haproxy -f % -c
Default value: $haproxy::params::config_validate_cmd
Data type: Boolean
Optional.
Default value: $haproxy::params::manage_config_dir
Data type: Optional[Boolean]
Deprecated
Default value: undef
Data type: Optional[Boolean]
Deprecated
Default value: undef
For global configuration options used by all haproxy instances.
The following parameters are available in the haproxy::globals
class:
Data type: Boolean
Sort options either alphabetic or custom like haproxy internal sorts them. Defaults to true.
Default value: true
This is a container class holding default parameters for for haproxy class.
- Note Currently, only the Redhat family is supported, but this can be easily extended by changing package names and configuration file paths.
=== Authors
Gary Larizza gary@puppetlabs.com Jeremy Kitchen jeremy@nationbuilder.com
- Note Each backend service needs one or more backend member servers (that can be declared with the haproxy::balancermember defined resource type). Using storeconfigs, you can export the haproxy::balancermember resources on all load balancer member servers and then collect them on a single haproxy load balancer server.
haproxy::backend { 'puppet00':
options => {
'option' => [
'tcplog',
'ssl-hello-chk'
],
'balance' => 'roundrobin'
},
}
The following parameters are available in the haproxy::backend
defined type:
section_name
mode
description
options
collect_exported
config_file
sort_options_alphabetic
defaults
instance
Data type: String[1]
This name goes right after the 'backend' statement in haproxy.cfg Default: $name (the namevar of the resource).
Default value: $name
Data type: Optional[Enum['tcp', 'http', 'health']]
The mode of operation for the backend service. Valid values are undef, 'tcp', 'http', and 'health'.
Default value: undef
Data type: Optional[String]
Allows to add a sentence to describe the related object in the HAProxy HTML stats page. The description will be printed on the right of the object name it describes. Usefull in huge environments
Default value: undef
Data type: Variant[Hash, Array[Hash]]
A hash of options that are inserted into the backend configuration block.
Default value:
{
'balance' => 'roundrobin',
}
Data type: Boolean
Boolean, default 'true'. True means 'collect exported @@balancermember resources' (for the case when every balancermember node exports itself), false means 'rely on the existing declared balancermember resources' (for the case when you know the full set of balancermember in advance and use haproxy::balancermember with array arguments, which allows you to deploy everything in 1 run)
Default value: true
Data type: Optional[Stdlib::Absolutepath]
Optional. Path of the config file where this entry will be added. Assumes that the parent directory exists. Default: $haproxy::params::config_file
Default value: undef
Data type: Boolean
Sort options either alphabetic or custom like haproxy internal sorts them. Defaults to true.
Default value: true
Data type: Optional[String]
Name of the defaults section this backend will use. Defaults to undef which means the global defaults section will be used.
Default value: undef
Data type: String
Optional. Defaults to 'haproxy'
Default value: 'haproxy'
This type will setup a balancer member inside a listening service configuration block in /etc/haproxy/haproxy.cfg on the load balancer.
- Note Currently it only has the ability to specify the instance name, ip address, port, and whether or not it is a backup. More features can be added as needed. The best way to implement this is to export this resource for all haproxy balancer member servers, and then collect them on the main haproxy load balancer.
Exporting the resource for a balancer member:
@@haproxy::balancermember { 'haproxy':
listening_service => 'puppet00',
ports => [8140],
server_names => $::hostname,
ipaddresses => $::ipaddress,
options => 'check',
}
Collecting the resource on a load balancer
Haproxy::Balancermember <<| listening_service == 'puppet00' |>>
Creating the resource for multiple balancer members at once
(for single-pass installation of haproxy without requiring a first
pass to export the resources if you know the members in advance):
haproxy::balancermember { 'haproxy':
listening_service => 'puppet00',
ports => 8140,
server_names => ['server01', 'server02'],
ipaddresses => ['192.168.56.200', '192.168.56.201'],
options => 'check',
}
Implemented in HAPROXY 1.8:
Set a template to initialize servers with shared parameters.
The names of these servers are built from <prefix> and <amount> parameters.
Initializes 5 servers with srv1, srv2, srv3, srv4 and srv5 as names,
myserver.example.com as FQDN, 8140 as port, and health-check enabled.
haproxy::balancermember { 'haproxy':
listening_service => 'puppet00',
type => 'server-template'
port => '8140',
prefix => 'srv',
amount => '1-5',
fqdn => 'myserver.example.com',
options => 'check',
}
(this resource can be declared anywhere)
The following parameters are available in the haproxy::balancermember
defined type:
listening_service
ports
port
server_names
ipaddresses
prefix
amount
fqdn
options
define_cookies
defaults
config_file
verifyhost
weight
instance
type
Data type: String
The haproxy service's instance name (or, the title of the haproxy::listen resource). This must match up with a declared haproxy::listen resource.
Data type: Optional[Haproxy::Ports]
An array or commas-separated list of ports for which the balancer member will accept connections from the load balancer. Note that cookie values aren't yet supported, but shouldn't be difficult to add to the configuration. If you use an array in server_names and ipaddresses, the same port is used for all balancermembers.
Default value: undef
Data type: Optional[Variant[String, Stdlib::Port]]
A port for server-template. It is an optional specification.
Default value: undef
Data type: Variant[String[1], Array]
The name of the balancer member server as known to haproxy in the listening service's configuration block. This defaults to the hostname. Can be an array of the same length as ipaddresses, in which case a balancermember is created for each pair of server_names and ipaddresses (in lockstep).
Default value: $facts['networking']['hostname']
Data type: Variant[String, Array]
The ip address used to contact the balancer member server. Can be an array, see documentation to server_names.
Default value: $facts['networking']['ip']
Data type: String
A prefix for the server-template for the server names to be built.
Default value: 'server'
Data type: String
If "amount" is provided, the server-template initializes servers with 1 up to as server name suffixes. A range of numbers <num_low>-<num_high> may also be used to use <num_low> up to <num_high> as server name suffixes.
Default value: '1'
Data type: Optional[String]
A FQDN for all the servers the server-template initializes.
Default value: undef
Data type: Optional[Variant[String, Array]]
An array of options to be specified after the server declaration in the listening service's configuration block.
Default value: undef
Data type: Boolean
If true, then add "cookie SERVERID" stickiness options. Default false.
Default value: false
Data type: Optional[String]
Name of the defaults section the backend or listener use. Defaults to undef.
Default value: undef
Data type: Optional[Stdlib::Absolutepath]
Optional. Path of the config file where this entry will be added. Assumes that the parent directory exists. Default: $haproxy::params::config_file
Default value: undef
Data type: Boolean
Optional. Will add the verifyhost option to the server line, using the specific host from server_names as an argument. Default: false
Default value: false
Data type: Optional[Variant[String, Integer]]
Optional. Will add the weight option to the server line Default: undef
Default value: undef
Data type: String
Optional. Defaults to 'haproxy'
Default value: 'haproxy'
Data type: Enum['server', 'default-server', 'server-template']
Optional. Defaults to 'server'
Default value: 'server'
This type will setup a additional defaults configuration block inside the haproxy.cfg file on an haproxy load balancer.
- Note A new default configuration block resets all defaults of prior defaults configuration blocks. Listener, Backends, Frontends and Balancermember can be configured behind a default configuration block by setting the defaults parameter to the corresponding defaults name.
The following parameters are available in the haproxy::defaults
defined type:
Data type: Hash
A hash of options that are inserted into the defaults configuration block.
Default value: {}
Data type: Boolean
Sort options either alphabetic or custom like haproxy internal sorts them. Defaults to true.
Default value: true
Data type: Boolean
Whether to merge the user-supplied options
hash with the
default_options
values set in params.pp. Merging allows to change
or add options without having to recreate the entire hash.
Default value: $haproxy::params::merge_options
Data type: String
Optional. Defaults to 'haproxy'.
Default value: 'haproxy'
=== Authors
Gary Larizza gary@puppetlabs.com
- Note Currently requires the puppetlabs/concat module on the Puppet Forge and uses storeconfigs on the Puppet Server to export/collect resources from all balancer members.
Exporting the resource for a balancer member:
haproxy::frontend { 'puppet00':
ipaddress => $::ipaddress,
ports => [18140],
mode => 'tcp',
bind_options => 'accept-proxy',
options => {
'option' => [
'tcplog',
'accept-invalid-http-request',
],
'timeout client' => '30s',
'balance' => 'roundrobin'
},
}
The following parameters are available in the haproxy::frontend
defined type:
section_name
ports
bind
ipaddress
mode
description
bind_options
options
sort_options_alphabetic
defaults
defaults_use_backend
config_file
collect_exported
instance
Data type: String[1]
This name goes right after the 'frontend' statement in haproxy.cfg Default: $name (the namevar of the resource).
Default value: $name
Data type: Optional[Haproxy::Ports]
Ports on which the proxy will listen for connections on the ip address specified in the ipaddress parameter. Accepts either a single comma-separated string or an array of strings which may be ports or hyphenated port ranges.
Default value: undef
Data type: Optional[Hash]
Set of ip addresses, port and bind options $bind = { '10.0.0.1:80' => ['ssl', 'crt', '/path/to/my/crt.pem'] }
Default value: undef
Data type: Optional[Variant[String, Array]]
The ip address the proxy binds to. Empty addresses, '*', and '0.0.0.0' mean that the proxy listens to all valid addresses on the system.
Default value: undef
Data type: Optional[Enum['tcp', 'http', 'health']]
The mode of operation for the frontend service. Valid values are undef, 'tcp', 'http', and 'health'.
Default value: undef
Data type: Optional[String]
Allows to add a sentence to describe the related object in the HAProxy HTML stats page. The description will be printed on the right of the object name it describes. Usefull in huge environments
Default value: undef
Data type: Optional[Array]
(Deprecated) An array of options to be specified after the bind declaration in the listening serivce's configuration block.
Default value: undef
Data type: Variant[Hash, Array[Hash]]
A hash of options that are inserted into the frontend service configuration block.
Default value:
{
'option' => [
'tcplog',
],
}
Data type: Boolean
Sort options either alphabetic or custom like haproxy internal sorts them. Defaults to true.
Default value: true
Data type: Optional[String]
Name of the defaults section this backend will use. Defaults to undef which means the global defaults section will be used.
Default value: undef
Data type: Boolean
If defaults are used and a default backend is configured use the backend name for ordering. This means that the frontend is placed in the configuration file before the backend configuration. Defaults to true.
Default value: true
Data type: Optional[Stdlib::Absolutepath]
Optional. Path of the config file where this entry will be added. Assumes that the parent directory exists. Default: $haproxy::params::config_file
Default value: undef
Data type: Boolean
Boolean. Default true
Default value: true
Data type: String
Optional. Defaults to 'haproxy'
Default value: 'haproxy'
template() function). Defaults to undef
- Note Normally users use the Class['haproxy'], which runs a single haproxy daemon on a machine.
A single instance of haproxy with all defaults
i.e. emulate Class['haproxy']
package{ 'haproxy': ensure => present }->haproxy::instance { 'haproxy': }->
haproxy::listen { 'puppet00':
instance => 'haproxy',
collect_exported => false,
ipaddress => $::ipaddress,
ports => '8140',
}
Multiple instances of haproxy:
haproxy::instance { 'group1': }
haproxy::instance_service { 'group1':
haproxy_init_source => "puppet:///modules/${module_name}/haproxy-group1.init",
}
haproxy::listen { 'puppet00':
instance => 'group1',
collect_exported => false,
ipaddress => $::ipaddress,
ports => '8800',
requires => Package['haproxy'],
}
haproxy::instance { 'group2': }
haproxy::instance_service { 'group2':
haproxy_init_source => "puppet:///modules/${module_name}/haproxy-group1.init",
}
haproxy::listen { 'puppet00':
instance => 'group2',
collect_exported => false,
ipaddress => $::ipaddress,
ports => '9900',
requires => Package['haproxy'],
}
Multiple instances of haproxy, one with a custom haproxy package:
haproxy::instance { 'group1': }
haproxy::instance_service { 'group1':
haproxy_init_source => "puppet:///modules/${module_name}/haproxy-group1.init",
}
haproxy::listen { 'puppet00':
instance => 'group1',
collect_exported => false,
ipaddress => $::ipaddress,
ports => '8800',
requires => Package['haproxy'],
}
haproxy::instance { 'group2': }
haproxy::instance_service { 'group2':
haproxy_package => 'custom_haproxy',
haproxy_init_source => "puppet:///modules/${module_name}/haproxy-group2.init",
}
haproxy::listen { 'puppet00':
instance => 'group2',
collect_exported => false,
ipaddress => $::ipaddress,
ports => '9900',
requires => Package['haproxy'],
}
The following parameters are available in the haproxy::instance
defined type:
package_ensure
package_name
service_ensure
service_manage
chroot_dir_manage
service_name
global_options
defaults_options
restart_command
custom_fragment
config_file
config_validate_cmd
config_dir
merge_options
service_options
sysconfig_options
Data type: Variant[Enum['present', 'absent', 'purged', 'disabled', 'installed', 'latest'], String[1]]
Ensure the package is present (installed), absent or a specific version. Defaults to 'present'
Default value: 'present'
Data type: Optional[String]
The package name of haproxy. Defaults to undef, and no package is installed. NOTE: Class['haproxy'] has a different default.
Default value: undef
Data type: Variant[Enum['running', 'stopped'], Boolean]
Chooses whether the haproxy service should be running & enabled at boot, or stopped and disabled at boot. Defaults to 'running'
Default value: 'running'
Data type: Boolean
Chooses whether the haproxy service state should be managed by puppet at all. Defaults to true
Default value: true
Data type: Boolean
Chooses whether the haproxy chroot directory should be managed by puppet at all. Defaults to true
Default value: true
Data type: Optional[String]
The service name for haproxy. Defaults to undef. If no name is given then the value computed for $instance_name will be used. NOTE: Class['haproxy'] has a different default.
Default value: undef
Data type: Optional[Hash]
A hash of all the haproxy global options. If you want to specify more than one option (i.e. multiple timeout or stats options), pass those options as an array and you will get a line for each of them in the resultant haproxy.cfg file.
Default value: undef
Data type: Optional[Hash]
A hash of all the haproxy defaults options. If you want to specify more than one option (i.e. multiple timeout or stats options), pass those options as an array and you will get a line for each of them in the resultant haproxy.cfg file.
Default value: undef
Data type: Optional[String]
Command to use when restarting the on config changes.
Passed directly as the 'restart'
parameter to the service
resource. # Defaults to undef i.e. whatever the service default is.
Default value: undef
Data type: Optional[String]
Allows arbitrary HAProxy configuration to be passed through to support additional configuration not available via parameters, or to short-circuit the defined resources such as haproxy::listen when an operater would rather just write plain configuration. Accepts a string (ie, output from the
Default value: undef
Data type: Optional[Stdlib::Absolutepath]
Allows arbitrary config filename to be specified. If this is used, it is assumed that the directory path to the file exists and has owner/group/permissions as desired. If set to undef, the name will be generated as follows: If $title is 'haproxy', the operating system default will be used. Otherwise, /etc/haproxy-$title/haproxy-$title.conf (Linux), or /usr/local/etc/haproxy-$title/haproxy-$title.conf (FreeBSD) The parent directory will be created automatically. Defaults to undef.
Default value: undef
Data type: Variant[Stdlib::Absolutepath, String]
Command used by concat validate_cmd to validate new config file concat is a valid haproxy config. Default /usr/sbin/haproxy -f % -c
Default value: $haproxy::params::config_validate_cmd
Data type: Optional[Stdlib::Absolutepath]
Optional. Default undef.
Default value: undef
Data type: Boolean
Default value: $haproxy::params::merge_options
Data type: String
Default value: $haproxy::params::service_options
Data type: String
Default value: $haproxy::params::sysconfig_options
Set up the environment for an haproxy service.
- Note * Associate an haproxy instance with the haproxy package it should use.
- Create the start/restart/stop functions needed by Service[]. In other words: sets things up so that Service[$instance_name] will work.
In particular:
- Create a link to the binary an instance will be using. This way each instance can link to a different binary. If you have an instance called "foo", you know "haproxy-foo" is a link to the binary it should be using.
- Create an init.d file named after the instance. This way Service[$instance] can start/restart the service.
The following parameters are available in the haproxy::instance_service
defined type:
Data type: String
The name of the package to be installed. This is useful if you package your own custom version of haproxy. Defaults to 'haproxy'
Default value: 'haproxy'
Data type: Stdlib::Absolutepath
Where to put symlinks to the binary used for each instance. Defaults to '/opt/haproxy'
Default value: '/opt/haproxy/bin'
Data type: Optional[String]
The init.d script that will start/restart/reload this instance.
Default value: undef
Data type: String
The template that will be used to create an unit file.
Default value: 'haproxy/instance_service_unit.epp'
=== Authors
Gary Larizza gary@puppetlabs.com
- Note Each listening service configuration needs one or more load balancer member server (that can be declared with the haproxy::balancermember defined resource type). Using storeconfigs, you can export the haproxy::balancermember resources on all load balancer member servers, and then collect them on a single haproxy load balancer server.
haproxy::listen { 'puppet00':
ipaddress => $::ipaddress,
ports => [18140],
mode => 'tcp',
options => {
'option' => [
'tcplog',
'ssl-hello-chk'
],
'balance' => 'roundrobin'
},
}
The following parameters are available in the haproxy::listen
defined type:
section_name
ports
ipaddress
bind
mode
description
options
bind_options
collect_exported
sort_options_alphabetic
defaults
config_file
instance
Data type: String[1]
This name goes right after the 'listen' statement in haproxy.cfg Default: $name (the namevar of the resource).
Default value: $name
Data type: Optional[Haproxy::Ports]
Ports on which the proxy will listen for connections on the ip address specified in the ipaddress parameter. Accepts either a single comma-separated string or an array of strings which may be ports or hyphenated port ranges.
Default value: undef
Data type: Optional[Variant[String, Array]]
The ip address the proxy binds to. Empty addresses, '*', and '0.0.0.0' mean that the proxy listens to all valid addresses on the system.
Default value: undef
Data type: Optional[Hash]
Set of ip addresses, port and bind options $bind = { '10.0.0.1:80' => ['ssl', 'crt', '/path/to/my/crt.pem'] }
Default value: undef
Data type: Optional[Enum['tcp', 'http', 'health']]
The mode of operation for the listening service. Valid values are undef, 'tcp', 'http', and 'health'.
Default value: undef
Data type: Optional[String]
Allows to add a sentence to describe the related object in the HAProxy HTML stats page. The description will be printed on the right of the object name it describes. Usefull in huge environments
Default value: undef
Data type: Variant[Hash, Array[Hash]]
A hash of options that are inserted into the listening service configuration block.
Default value:
{
'option' => [
'tcplog',
],
'balance' => 'roundrobin',
}
Data type: Optional[Array]
(Deprecated) An array of options to be specified after the bind declaration in the listening serivce's configuration block.
Default value: undef
Data type: Boolean
Boolean, default 'true'. True means 'collect exported @@balancermember resources' (for the case when every balancermember node exports itself), false means 'rely on the existing declared balancermember resources' (for the case when you know the full set of balancermembers in advance and use haproxy::balancermember with array arguments, which allows you to deploy everything in 1 run)
Default value: true
Data type: Boolean
Sort options either alphabetic or custom like haproxy internal sorts them. Defaults to true.
Default value: true
Data type: Optional[String]
Name of the defaults section this backend will use. Defaults to undef which means the global defaults section will be used.
Default value: undef
Data type: Optional[Stdlib::Absolutepath]
Optional. Path of the config file where this entry will be added. Assumes that the parent directory exists. Default: $haproxy::params::config_file
Default value: undef
Data type: String
Optional. Defaults to 'haproxy'
Default value: 'haproxy'
This type will set up a mailer entry inside the mailers configuration block in haproxy.cfg on the load balancer.
- Note Currently, it has the ability to specify the instance name, ip address, ports and server_names. Automatic discovery of mailer nodes may be implemented by exporting the mailer resource for all HAProxy balancer servers that are configured in the same HA block and then collecting them on all load balancers.
The following parameters are available in the haproxy::mailer
defined type:
Data type: String
Specifies the mailer in which this load balancer needs to be added.
Data type: Variant[String[1], Array]
Sets the name of the mailer server in the mailers configuration block. Defaults to the hostname. Can be an array. If this parameter is specified as an array, it must be the same length as the ipaddresses parameter's array. A mailer is created for each pair of server_names and ipaddresses in the array.
Default value: $facts['networking']['hostname']
Data type: Variant[String, Array]
Specifies the IP address used to contact the mailer member server. Can be an array. If this parameter is specified as an array it must be the same length as the server_names parameter's array. A mailer is created for each pair of address and server_name.
Default value: $facts['networking']['ip']
Data type: Variant[String, Stdlib::Port]
Sets the port on which the mailer is going to share the state.
Data type: String
The instance name of the mailer entry. Default value: 'haproxy'.
Default value: 'haproxy'
This type will set up a mailers entry in haproxy.cfg on the load balancer.
- Note This setting makes it possible to send emails during state changes.
The following parameters are available in the haproxy::mailers
defined type:
Data type: String
Optional. Defaults to 'haproxy'.
Default value: 'haproxy'
Data type: Boolean
Boolean. Defaults to true.
Default value: true
Manage an HAProxy map file as documented in https://cbonte.github.io/haproxy-dconv/configuration-1.5.html#7.3.1-map
- Note A map file contains one key + value per line. These key-value pairs are
specified in the
mappings
array or by additionalhaproxy::mapfile::entry
definitions.
The following parameters are available in the haproxy::mapfile
defined type:
The namevar of the defined resource type is the filename of the map file
(without any extension), relative to the haproxy::config_dir
directory.
A '.map' extension will be added automatically.
Data type: Array[Variant[String, Hash]]
An array of mappings for this map file. Array elements may be Hashes with a
single key-value pair each (preferably) or simple Strings. Default: []
Default value: []
Data type: Enum['present', 'absent']
The state of the underlying file resource, either 'present' or 'absent'. Default: 'present'
Default value: 'present'
Data type: String
The owner of the underlying file resource. Defaut: 'root'
Default value: 'root'
Data type: String
The group of the underlying file resource. Defaut: 'root'
Default value: 'root'
Data type: String
The mode of the underlying file resource. Defaut: '0644'
Default value: '0644'
Data type: Array
Array of managed HAproxy instance names to notify (restart/reload) when the
map file is updated. This is so that the same map file can be used with
multiple HAproxy instances. Default: [ 'haproxy' ]
Default value: ['haproxy']
Manage an HAProxy map file as documented in https://cbonte.github.io/haproxy-dconv/configuration-1.5.html#7.3.1-map
- Note A map file contains one key + value per line. These key-value pairs are
specified in the
mappings
array.
The following parameters are available in the haproxy::mapfile::entry
defined type:
The namevar of the defined resource type is the filename of the map file
(without any extension), relative to the haproxy::config_dir
directory.
A '.map' extension will be added automatically.
Data type: Array[Variant[String, Hash]]
An array of mappings for this map file. Array elements may be Hashes with a
single key-value pair each (preferably) or simple Strings. Default: []
Default value: [$title]
Data type: String
A string that specifies the name of the mapfile. Default value: ''.
Data type: Variant[String, Integer]
Defines the order for the mapfile. Accepts Integer or Strings. Default value: '10'.
Default value: '10'
This type will set up a peer entry inside the peers configuration block in haproxy.cfg on the load balancer.
- Note Currently, it has the ability to specify the instance name, ip address, ports and server_names.
The following parameters are available in the haproxy::peer
defined type:
Data type: String
Specifies the peer in which this load balancer needs to be added.
Data type: Variant[String[1], Array]
Sets the name of the peer server in the peers configuration block. Defaults to the hostname. Can be an array. If this parameter is specified as an array, it must be the same length as the ipaddresses parameter's array. A peer is created for each pair of server_names and ipaddresses in the array.
Default value: $facts['networking']['hostname']
Data type: Variant[String, Array]
Specifies the IP address used to contact the peer member server. Can be an array. If this parameter is specified as an array it must be the same length as the server_names parameter's array. A peer is created for each pair of address and server_name.
Default value: $facts['networking']['ip']
Data type: Variant[String, Stdlib::Port]
Sets the port on which the peer is going to share the state.
Data type: Optional[Stdlib::Absolutepath]
Optional. Path of the config file where this entry will be added. Assumes that the parent directory exists. Default: $haproxy::params::config_file
Default value: undef
Data type: String
The instance name of the mailer entry. Default value: 'haproxy'.
Default value: 'haproxy'
Private define
on the load balancer. This setting is required to share the current state of HAproxy with other HAproxy in High available configurations.
The following parameters are available in the haproxy::peers
defined type:
Sets the peers' name. Generally it will be the namevar of the defined resource type. This value appears right after the 'peers' statement in haproxy.cfg
Data type: Optional[Stdlib::Absolutepath]
Optional. Path of the config file where this entry will be added. Assumes that the parent directory exists. Default: $haproxy::params::config_file
Default value: undef
Data type: String
Optional. Defaults to 'haproxy'
Default value: 'haproxy'
Data type: Boolean
Boolean. Defaults to true
Default value: true
=== Authors
Gary Larizza gary@puppetlabs.com Ricardo Rosales missingcharacter@gmail.com
- Note Currently requires the puppetlabs/concat module on the Puppet Forge and uses storeconfigs on the Puppet Server to export/collect resources from all balancer members.
Exporting the resource for a balancer member:
haproxy::resolver { 'puppet00':
nameservers => {
'dns1' => '10.0.0.1:53',
'dns2' => '10.0.0.2:53'
},
hold => {
'nx' => '30s',
'valid' => '10s'
},
resolve_retries => 3,
timeout => {
'retry' => '1s'
},
accepted_payload_size => 512,
}
The following parameters are available in the haproxy::resolver
defined type:
section_name
nameservers
parse_resolv_conf
hold
resolve_retries
timeout
accepted_payload_size
collect_exported
config_file
sort_options_alphabetic
defaults
instance
Data type: String[1]
This name goes right after the 'resolvers' statement in haproxy.cfg Default: $name (the namevar of the resource).
Default value: $name
Data type: Hash
Set of id, ip addresses and port options. $nameservers = { 'dns1' => '10.0.0.1:53', 'dns2' => '10.0.0.2:53' } Either the 'nameservers' or the 'parse_resolv_conf' parameter must be specified in order for the resolver to work. Default: none specified.
Default value: {}
Data type: Boolean
If true, parse resolv.conf to retrieve an ordered set of nameservers. This can be used instead of (or in addition to) the 'nameservers' parameter. Default: false
Default value: false
Data type: Optional[Hash]
Defines during which the last name resolution should be kept based on last valid resolution status. $hold = { 'nx' => '30s', 'valid' => '10s' }
Default value: undef
Data type: Optional[Integer]
Defines the number of queries to send to resolve a server name before giving up. $resolve_retries = 3
Default value: undef
Data type: Optional[Hash]
Defines timeouts related to name resolution in the listening serivce's configuration block. $timeout = { 'retry' => '1s' }
Default value: undef
Data type: Optional[Integer[512, 8192]]
Defines the maximum payload size accepted by HAProxy and announced to all the name servers configured in this resolvers section. is in bytes. If not set, HAProxy announces 512. (minimal value defined by RFC 6891) Note: the maximum allowed value is 8192.
Default value: undef
Data type: Boolean
Boolean, default 'true'. True means 'collect exported @@balancermember resources' (for the case when every balancermember node exports itself), false means 'rely on the existing declared balancermember resources' (for the case when you know the full set of balancermember in advance and use haproxy::balancermember with array arguments, which allows you to deploy everything in 1 run)
Default value: true
Data type: Optional[Stdlib::Absolutepath]
Optional. Path of the config file where this entry will be added. Assumes that the parent directory exists. Default: $haproxy::params::config_file
Default value: undef
Data type: Boolean
Sort options either alphabetic or custom like haproxy internal sorts them. Defaults to true.
Default value: true
Data type: Optional[String]
Name of the defaults section this backend will use. Defaults to undef which means the global defaults section will be used.
Default value: undef
Data type: String
Optional. Defaults to 'haproxy'
Default value: 'haproxy'
=== Authors
Jeremy Kitchen jeremy@nationbuilder.com
- Note See http://cbonte.github.io/haproxy-dconv/configuration-1.4.html#3.4 for more info
The following parameters are available in the haproxy::userlist
defined type:
Data type: String[1]
This name goes right after the 'userlist' statement in haproxy.cfg Default: $name (the namevar of the resource).
Default value: $name
Data type: Optional[Array[Variant[String, Sensitive[String]]]]
An array of users in the userlist. See http://cbonte.github.io/haproxy-dconv/configuration-1.4.html#3.4-user
Default value: undef
Data type: Optional[Array[String]]
An array of groups in the userlist. See http://cbonte.github.io/haproxy-dconv/configuration-1.4.html#3.4-group
Default value: undef
Data type: Optional[Stdlib::Absolutepath]
Optional. Path of the config file where this entry will be added. Assumes that the parent directory exists. Default: $haproxy::params::config_file
Default value: undef
Data type: String
Optional. Defaults to 'haproxy'
Default value: 'haproxy'
Type: Ruby 4.x API
Function created to generate error message. Any string as error message can be passed and the function can be called in epp templates.
Function created to generate error message. Any string as error message can be passed and the function can be called in epp templates.
Returns: Any
Data type: String
Type: Ruby 4.x API
The haproxy::sort_bind function.
The haproxy::sort_bind function.
Returns: Array
Data type: Hash
Type: Ruby 4.x API
The haproxy::validate_ip_addr function.
The haproxy::validate_ip_addr function.
Returns: Boolean
Data type: String
Port or list of ports for haproxy. Supports ,
seperated list of ports also.
Alias of Variant[Array[Variant[Pattern[/^[0-9]+$/],Stdlib::Port],0], Pattern[/^[0-9,]+$/], Stdlib::Port]