#######################################################################################################

❗ DEPRECATION ❗

This repository and the role associated are deprecated in favor of the Manala Ansible Collection

You will find informations on its usage on the collection repository

#######################################################################################################

Ansible Role: Keepalived

❗ Report issues and send Pull Requests in the main Ansible Role repository ❗

This role will deal with the setup and the configuration of Keepalived.

It's part of the Manala Ansible stack but can be used as a stand alone component.

Requirements

This role is made to work with the manala keepalived debian package, available on the manala debian repository. Please use the manala.apt role to handle it properly.

manala_apt_preferences:
  - keepalived@manala

Dependencies

None.

Installation

Ansible 2+

Using ansible galaxy cli:

ansible-galaxy install manala.keepalived

Using ansible galaxy requirements file:

- src: manala.keepalived

Role Handlers

Name	Type	Description
keepalived restart	Service	Restart keepalived
keepalived reload	Service	Reload keepalived

Role Variables

Name	Default	Type	Description
manala_keepalived_install_packages	~	Array	Dependency packages to install directives
manala_keepalived_install_packages_default	['keepalived']	Array	Default dependency packages to install directives
manala_keepalived_config_file	'/etc/keepalived/keepalived.conf'	Array	Configuration file path
manala_keepalived_config_template	'config/_default.j2'	String	Configuration base template path
manala_keepalived_config	~	Array/String	Configuration directives
manala_keepalived_environment_file	'/etc/default/keepalived'	Array	Environment file path
manala_keepalived_environment_template	'environment/_default.j2'	String	Environment base template path
manala_keepalived_environment	~	Array/String	Environment directives

Configuration example

Use raw main config:

manala_keepalived_config: |
  global_defs {
      router_id LVS_DEVEL
  }
  vrrp_instance VI_1 {
      virtual_router_id 50
      interface eth0
      state MASTER
      priority 100
      virtual_ipaddress {
          192.168.200.11/24 dev eth0
          192.168.200.12/24 dev eth0
      }
  }

Use custom template:

manala_keepalived_config_template: my_custom_keepalived.conf.j2
manala_keepalived_config:
  foo: bar

Use dict's array parameters (deprecated):

manala_keepalived_config:
  - global_defs:
    - router_id: LVS_DEVEL
  - vrrp_instance VI_1:
    - virtual_router_id: 50
    - interface: eth0
    - state: MASTER
    - priority: 100
    - virtual_ipaddress:
      - 192.168.200.11/24 dev eth0
      - 192.168.200.12/24 dev eth0

Start keepalived daemon with extra parameters...

...using debian default environment template (recommended):

manala_keepalived_environment_template: environment/debian/keepalived.j2
manala_keepalived_environment:
  DAEMON_ARGS: --log-console --log-detail
  FOO: bar

...using dict parameters:

manala_keepalived_environment:
  DAEMON_ARGS: --log-console --log-detail
  FOO: bar

...using raw main config:

manala_keepalived_environment: |
  DAEMON_ARGS="--log-console --log-detail"
  FOO="bar"

...using dict's array parameters (deprecated):

manala_keepalived_environment:
  - DAEMON_ARGS: --log-console --log-detail
  - FOO: bar

Example playbook

- hosts: all
  roles:
    - role: manala.keepalived

Licence

MIT

Author information

Manala (http://www.manala.io/)