enix.ucarp for Ansible

This is a role for setting up and configuring ucarp on Unix systems using Ansible.

Requirements

Supported systems:

• Ubuntu 14.04 "Trusty"
• Ubuntu 16.04 "Xenial"
• Ubuntu 18.04 "Bionic"
• Debian 8 "Jessie"
• Debian 8 "Stretch"

Role Variables

This role includes many default settings. You can change these in your host or group variables, in your inventory, or directly in your playbook. For detailed configuration help, check defaults/main.yml. All variables start with ucarp__.

• ucarp__interface - required, the network interface for ucarp; it will fail if not set, default: none.
• ucarp__interface_configfile - the file containing the configuration for ucarp__interface, default: /etc/network/interfaces.
• ucarp__vid - the identifier for the ucarp setup, default: 10.
• ucarp__vip - required, the virtual IP address, default: none.
• ucarp__vip_netmask - the netmask for the virtual IP, default: 255.255.255.255.
• ucarp__vip_upaction - the action when the interface is up, default: none.
• ucarp__vip_downaction - the action when the interface is down, default: none.
• ucarp__password - required, the password for ucarp authentication, default: none.
• ucarp__advskew - the advskew parameter, default: 0.
• ucarp__advbase - the advbase parameter, default: 1.
• ucarp__master - set this host as the default master (preempt mode), default: no.

Dependencies

• The network interface used for ucarp communication must be statically configured. DHCP interfaces are not supported by ucarp's scripts, as they rely on a configured address to start the ucarp daemon.

Usage

To use this role, add it to your Ansible Galaxy requirements file:

# enix.ucarp galaxy role
- src: enix.ucarp
  name: ucarp

Then include it in your playbook:

- hosts: servers
  roles:
    - role: ucarp

You can also run the role as a playbook and specify which hosts to use with --extra-vars.

$ ansible-playbook -i inventory --extra-vars='{...}' main.yml

Still to do

• ...

Changelog

1.0

First version.

License

GPLv2

Author Information

Laurent Corbes laurent.corbes@enix.fr - enix.fr