tripleo-image-elements/elements/haproxy/README.md
Dima Shulyak 498d7c9a02 Prevent duplication of net_binds per service
Almost for all services we will want to use same net_binds.
This is also fits nicely with current haproxy story
As example see this configuration:

{"haproxy": {
    "net_binds": [
        {"ip": "192.0.2.21"},
        {"ip": "198.10.0.32"}
    ],
    "services": [
        {"name" : "horizon",
         "port": 80}
    ],
    "nodes": [
        {"name": "controller0",
         "ip": "192.0.2.23"}
]}}

Which will result in config:

listen horizon
  bind 192.0.2.21:80
  bind 198.10.0.32:80
  mode tcp
  balance source
  option tcpka
  option tcplog
  server controller0 192.0.2.23:80 check inter 2000 rise 2 fall 5

Change-Id: I641fa90c4a34c26e5699cf7f5a6f9643792c7b16
2014-05-30 12:21:22 +03:00

2.9 KiB

Element to install haproxy. This element proxies services listed in haproxy.services and additionally enables ports in firewall.

Configuration

The following properties are supported for configuring haproxy

  • haproxy.services: A list of listen blocks. Also supports proxy_ip and proxy_port sub-properties.
  • haproxy.nodes: A list of server : lines. These are added to any haproxy.services which do not define this sub-property.

Each haproxy.services can define the following sub-properties

  • name: A name for the service.
  • haproxy.nodes: Same as above. This overrides the global haproxy.nodes list if it is set.
  • net_binds: A list of ip addresses and ports to bind to. Each element in the list must define a port and can define an IP. If no IP is defined then the service binds to all IP's.
  • balance: A balancing strategy for the service. Defaults to source.
  • port: Port to connect to for each of the haproxy.nodes.
  • proxy_ip: DEPRECATED IP address for a service to bind to. Defaults to all IP's (0.0.0.0).
  • proxy_port: DEPRECATED Port for a service to bind to.

Each haproxy.nodes can define the following sub-properties

  • name: A name for the node.
  • ip: IP address to connect to for the node.
  • port: Port to connect to for the node. This overrides any port value defined in haproxy.services.

If haproxy is configured to bind to a virtual IP with keepalived sysctl must be configured to use "net.ipv4.ip_nonlocal_bind = 1" This setting allows allows a program like HA-Proxy to create listening sockets on network interfaces that do not actually exist on the server.

  • This can be set in heat meatadata for node properties. EX: in overcloud-source.yaml for controllerConfig under properties: sysctl: net.ipv4.ip_nonlocal_bind: 1

Example Configurations

haproxy: nodes:

  • name: notcompute ip: 192.0.2.5
  • name: notcomputeSlave0 ip: 192.0.2.6 services:
  • name: dashboard_cluster net_binds:
    • ip: 192.0.2.3 port: 443
    • ip: 192.0.2.3 port: 444 balance: roundrobin
  • name: glance_api_cluster proxy_ip: 192.0.2.3 proxy_port: 9293 port:9292 balance: source

You can override set of nodes for a service by setting its own set of haproxy.nodes inside a service definition:

services:

  • name: dashboard_cluster net_binds:
    • ip: 192.0.2.3 port: 444
    • port: 443 balance: source haproxy: nodes:
      • name: foo0 ip: 10.0.0.1

You can provide net_binds only once, for example:

haproxy: nodes: - name: foo0 ip: 10.0.0.1 net_binds: - ip: 192.0.2.3 services: - name: keystone port: 5000 - name: dashboard_cluster port: 80 net_binds: - ip: 192.0.2.10

If there is no haproxy.services.net_binds.port defined - haproxy.services.port will be used.