Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/manala/ansible-role-keepalived
[READ-ONLY] Ansible role dealing with the setup of Keepalived
https://github.com/manala/ansible-role-keepalived
ansible keepalived
Last synced: about 2 months ago
JSON representation
[READ-ONLY] Ansible role dealing with the setup of Keepalived
- Host: GitHub
- URL: https://github.com/manala/ansible-role-keepalived
- Owner: manala
- Archived: true
- Created: 2016-06-23T06:48:46.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-12-16T10:49:41.000Z (about 3 years ago)
- Last Synced: 2024-08-01T19:33:07.883Z (5 months ago)
- Topics: ansible, keepalived
- Language: Makefile
- Homepage: https://galaxy.ansible.com/manala/keepalived/
- Size: 64.5 KB
- Stars: 0
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- awesome - ansible-role-keepalived
README
#######################################################################################################
# :exclamation: DEPRECATION :exclamation:
## This repository and the role associated are deprecated in favor of the [Manala Ansible Collection](https://galaxy.ansible.com/manala/roles)
## You will find informations on its usage on the [collection repository](https://github.com/manala/ansible-roles)
#######################################################################################################
# Ansible Role: Keepalived [](https://travis-ci.org/manala/ansible-role-keepalived)
:exclamation: [Report issues](https://github.com/manala/ansible-roles/issues) and [send Pull Requests](https://github.com/manala/ansible-roles/pulls) in the [main Ansible Role repository](https://github.com/manala/ansible-roles) :exclamation:
This role will deal with the setup and the configuration of [Keepalived](http://www.keepalived.org/).
It's part of the [Manala Ansible stack](http://www.manala.io) 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**](https://galaxy.ansible.com/manala/apt/) role to handle it properly.
```yaml
manala_apt_preferences:
- keepalived@manala
```
## Dependencies
None.
## Installation
### Ansible 2+
Using ansible galaxy cli:
```bash
ansible-galaxy install manala.keepalived
```
Using ansible galaxy requirements file:
```yaml
- 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:
```yaml
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:
```yaml
manala_keepalived_config_template: my_custom_keepalived.conf.j2
manala_keepalived_config:
foo: bar
```
Use dict's array parameters (deprecated):
```yaml
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):
```yaml
manala_keepalived_environment_template: environment/debian/keepalived.j2
manala_keepalived_environment:
DAEMON_ARGS: --log-console --log-detail
FOO: bar
```
...using dict parameters:
```yaml
manala_keepalived_environment:
DAEMON_ARGS: --log-console --log-detail
FOO: bar
```
...using raw main config:
```yaml
manala_keepalived_environment: |
DAEMON_ARGS="--log-console --log-detail"
FOO="bar"
```
...using dict's array parameters (deprecated):
```yaml
manala_keepalived_environment:
- DAEMON_ARGS: --log-console --log-detail
- FOO: bar
```
## Example playbook
```yaml
- hosts: all
roles:
- role: manala.keepalived
```
# Licence
MIT
# Author information
Manala [**(http://www.manala.io/)**](http://www.manala.io)