Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/githubixx/ansible-role-hetzner-floating-ip
This Ansible role adds a floating IP (v4 and/or v6) to a Hetzner Cloud host. Additionally you can change the source IP to the floating IP (which may be important for mailserver).
https://github.com/githubixx/ansible-role-hetzner-floating-ip
ansible cloud floating-ip hetzner hetzner-cloud interface linux network ubuntu
Last synced: 4 months ago
JSON representation
This Ansible role adds a floating IP (v4 and/or v6) to a Hetzner Cloud host. Additionally you can change the source IP to the floating IP (which may be important for mailserver).
- Host: GitHub
- URL: https://github.com/githubixx/ansible-role-hetzner-floating-ip
- Owner: githubixx
- License: gpl-3.0
- Created: 2018-10-07T18:43:37.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-01-22T18:34:10.000Z (about 1 year ago)
- Last Synced: 2024-01-22T22:36:52.274Z (about 1 year ago)
- Topics: ansible, cloud, floating-ip, hetzner, hetzner-cloud, interface, linux, network, ubuntu
- Language: Shell
- Homepage:
- Size: 23.4 KB
- Stars: 10
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ansible-role-hetzner-floating-ip
This Ansible role adds a floating IP (v4 and/or v6) to a [Hetzner Cloud](https://www.hetzner.cloud) host. Additionally you can change the source IP to the floating IP.
## Versions
I tag every release and try to stay with [semantic versioning](http://semver.org). If you want to use the role I recommend to checkout the latest tag. The master branch is basically development while the tags mark stable releases. But in general I try to keep master in good shape too.
## Requirements
A [Hetzner Cloud VM](https://www.hetzner.cloud) and a [floating IP](https://docs.hetzner.com/cloud/floating-ips/persistent-configuration/)
## Changelog
see [CHANGELOG.md](https://github.com/githubixx/ansible-role-hetzner-floating-ip/blob/master/CHANGELOG.md)
## Installation
- Directly download from Github (Change into Ansible roles directory before cloning. You can figure out the role path by using `ansible-config dump | grep DEFAULT_ROLES_PATH` command):
`git clone https://github.com/githubixx/ansible-role-hetzner-floating-ip.git githubixx.hetzner_floating_ip`
- Via `ansible-galaxy` command and download directly from Ansible Galaxy:
`ansible-galaxy install role githubixx.hetzner_floating_ip`
- Create a `requirements.yml` file with the following content (this will download the role from Github) and install with
`ansible-galaxy role install -r requirements.yml` (change `version` if needed):
```yaml
---
roles:
- name: githubixx.hetzner_floating_ip
src: https://github.com/githubixx/ansible-role-hetzner-floating-ip.git
version: 4.0.0
```
## Role Variables
These variables can be defined in `group_vars` or `host_vars`:
```yaml
# Filename that contains the floating v4 IP configuration in
# "/etc/network/interfaces.d/". ".cfg" suffix will be appended
# automatically.
hetzner_floating_ipv4_filename: "99-floating-ipv4"
# Filename that contains the floating v6 IP configuration in
# "/etc/network/interfaces.d/". ".cfg" suffix will be appended
# automatically.
hetzner_floating_ipv6_filename: "99-floating-ipv6"
```
Just adding the variables above isn't enough. If you just define this variables nothing will be deployed. Additionally you need to set a few variables per host in `host_vars`. E.g. to add a IPv4 floating IP and use this floating IP as source IP you can add this variable and settings:
```yaml
hetzner_floating_ipv4_options:
- { option: "method", value: "static" }
- { option: "address", value: "12.23.34.45" }
- { option: "netmask", value: "32" }
- { option: "post-up", value: "ip route del default; ip route add default dev eth0 via 172.31.1.1 src 12.23.34.45" }
```
Using the examples above a file called `/etc/netplan/99-floating-ipv4.yaml` will be created with this content:
```yaml
network:
version: 2
ethernets:
eth0:
addresses:
- 12.23.34.45/32
```
`{ option: "method", value: "static" }` has no effect in this case. And the **post-up** hook will be located in `/etc/network/if-post-up.d/99-floating-ipv4`:
```yaml
#!/bin/sh
ip route del default; ip route add default dev eth0 via 172.31.1.1 src 12.23.34.45
```
Here is a example for a IPv6 interface:
```yaml
hetzner_floating_ipv6_options:
- { option: "method", value: "static" }
- { option: "address", value: "2a01:4f8:1111:1111::1" }
- { option: "netmask", value: "64" }
```
The resulting files will be located at `/etc/netplan/99-floating-ipv6.yaml` and `/etc/network/if-post-up.d/99-floating-ipv6`.
## Example Playbook
```yaml
- hosts: floating-ip-hosts
roles:
- githubixx.hetzner_floating_ip
```
## License
GNU GENERAL PUBLIC LICENSE Version 3
## Author Information
[http://www.tauceti.blog](http://www.tauceti.blog)