keepalived/readme.md
Simon Cornet db70ae436a
All checks were successful
ci/woodpecker/push/linting Pipeline was successful
ci: migrate from gitlab ci to woodpecker
2026-05-15 14:31:01 +02:00

37 lines
2.2 KiB
Markdown

# Ansible Role: Keepalived
Install and configure [Keepalived](https://www.keepalived.org/) for VRRP high availability.
## Variables
| Variable | Required | Default | Description |
| ---------------------------------------- | -------- | --------------------- | ---------------------------------- |
| `keepalived_auth_pass` | Yes | `SuperSecurePassword` | VRRP authentication password |
| `keepalived_chk_service` | Yes | --------------------- | Service name to check for health |
| `keepalived_id` | Yes | --------------------- | Keepalived instance identifier |
| `keepalived_interface` | Yes | `eth0` | Network interface for VRRP |
| `keepalived_priority` | Yes | `101` | VRRP priority (higher = master) |
| `keepalived_state` | Yes | `MASTER` | Initial state (MASTER/BACKUP) |
| `keepalived_unicast_peer` | Yes | --------------------- | Peer IP address for unicast VRRP |
| `keepalived_unicast_src_ip` | Yes | --------------------- | Source IP address for unicast VRRP |
| `keepalived_virtual_ipaddress` | Yes | --------------------- | Virtual IP address to manage |
| `keepalived_virtual_ipaddress_interface` | Yes | `eth0` | Interface for virtual IP |
| `keepalived_vr_id` | Yes | `1` | VRRP virtual router ID |
| `keepalived_vrrp_instance` | Yes | `VI_01` | VRRP instance name |
## Example
```yaml
keepalived_auth_pass: "SecurePassword123"
keepalived_chk_service: "nginx"
keepalived_id: "web01"
keepalived_interface: "eth0"
keepalived_priority: "100"
keepalived_state: "BACKUP"
keepalived_unicast_peer: "192.168.1.11"
keepalived_unicast_src_ip: "192.168.1.10"
keepalived_virtual_ipaddress: "192.168.1.100"
keepalived_virtual_ipaddress_interface: "eth0"
keepalived_vr_id: "51"
keepalived_vrrp_instance: "VI_WEB"
```