Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: 3 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).

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)