142 lines
4.4 KiB
Markdown
142 lines
4.4 KiB
Markdown
# Ansible Freifunk MWU
|
|
|
|
Wir, die Freifunk MWU Community, nutzen Ansible um unsere Freifunk Server aufzusetzen und zu konfigurieren. In
|
|
diesem Repository verwalten wir unsere Ansible Roles und Playbooks.
|
|
|
|
Ein Server muss minimal vorbereitet sein, bevor dieser per Ansible z.B. zu einem Freifunk-Gateway gemacht werden
|
|
kann. Die folgenden Voraussetzungen müssen erfüllt sein:
|
|
|
|
- Ein dedizierter (v)server muss existieren und unter einer IPv4- und einer IPv6-Adresse öffentlich erreichbar sein.
|
|
- Die Adressen müssen im MWU-DNS eingetragen sein.
|
|
- Als Betriebssystem muss Debian stretch installiert sein.
|
|
- Für ansible muss Python 2.5 oder Python 2.4 + python-simplejson installiert sein.
|
|
- Es muss einen User admin geben, auf den die Admins Zugriff haben; dieser muss Root-Zugang über sudo haben.
|
|
|
|
Die Voraussetzungen werden von der Rolle `prerequisites` geprüft, die Rolle sollte als erste Rolle in jedem
|
|
Playbook eingebunden sein.
|
|
|
|
Die Server werden mit ihren FQDNs im Ansible Inventory hinterlegt, bedenkt das für eure ssh-config.
|
|
|
|
## Variablen für jedes Mesh
|
|
|
|
Viele Rollen brauchen spezifische Informationen, wie IP-Adresse, Masken, Interface-Namen, etc.
|
|
Wir verwalten diese Mesh-Informationen in einem Dictionary unter `inventory/group_vars/all`:
|
|
|
|
```
|
|
meshes:
|
|
mz:
|
|
site_number: 37
|
|
site_code: ffmz
|
|
site_name: Mainz
|
|
ipv4_network: 10.37.0.0/18
|
|
ipv6:
|
|
ula:
|
|
- fd37:b4dc:4b1e::/48
|
|
public:
|
|
- 2a03:2260:11a::/48
|
|
dnssl:
|
|
- ffmz.org
|
|
- user.ffmz.org
|
|
batman:
|
|
it: 10000
|
|
gw: server 96mbit/96mbit
|
|
mm: 0
|
|
dat: 0
|
|
iface_mtu: 1350
|
|
peers_mesh_repo: https://github.com/freifunk-mwu/peers-ffmz.git
|
|
peers_intragate_repo: https://github.com/freifunk-mwu/ffmz-infrastructure-peers.git
|
|
|
|
wi:
|
|
site_number: 56
|
|
site_code: ffwi
|
|
site_name: Wiesbaden
|
|
ipv4_network: 10.56.0.0/18
|
|
ipv6:
|
|
ula:
|
|
- fd56:b4dc:4b1e::/48
|
|
public:
|
|
- 2a03:2260:11b::/48
|
|
dnssl:
|
|
- ffwi.org
|
|
- user.ffwi.org
|
|
batman:
|
|
it: 10000
|
|
gw: server 96mbit/96mbit
|
|
mm: 0
|
|
dat: 0
|
|
iface_mtu: 1350
|
|
peers_mesh_repo: https://github.com/freifunk-mwu/peers-ffwi.git
|
|
peers_intragate_repo: https://github.com/freifunk-mwu/ffwi-infrastructure-peers.git
|
|
```
|
|
|
|
|
|
## Aufsetzen eines neuen Gateways
|
|
|
|
- FQDN im Inventory zur Gruppe ffmwu-gateways hinzufügen
|
|
- Host-Variablen setzen
|
|
- inventory/host_vars/$FQDN
|
|
|
|
```
|
|
---
|
|
# Gateway-Nummer, von der vieles abgeleitet wird. Integer zwischen 1-254. Muss eindeutig unter allen FFMWU Servern sein.
|
|
magic:
|
|
|
|
# Pfade zu den fastd secrets im passwordstore
|
|
fastd_secrets:
|
|
mzVPN: "{{ lookup('passwordstore', 'fastd/mzVPN/$Hostname') }}"
|
|
wiVPN: "{{ lookup('passwordstore', 'fastd/wiVPN/$Hostname') }}"
|
|
mzigVPN: "{{ lookup('passwordstore', 'fastd/mzVPN/$Hostname') }}"
|
|
wiigVPN: "{{ lookup('passwordstore', 'fastd/wiVPN/$Hostname') }}"
|
|
|
|
# FFRL (muss vorher bereits zugewiesen worden sein)
|
|
# Öffentliche IPv4 NAT Adresse
|
|
ffrl_public_ipv4_nat:
|
|
|
|
ffrl_exit_server:
|
|
ffrl-a-ak-ber:
|
|
public_ipv4_address:
|
|
tunnel_ipv4_network: # Format: IP/Maske
|
|
tunnel_ipv4_address:
|
|
tunnel_ipv4_netmask:
|
|
tunnel_ipv6_address:
|
|
tunnel_ipv6_netmask:
|
|
ffrl-b-ak-ber:
|
|
public_ipv4_address:
|
|
tunnel_ipv4_network: # Format: IP/Maske
|
|
tunnel_ipv4_address:
|
|
tunnel_ipv4_netmask:
|
|
tunnel_ipv6_address:
|
|
tunnel_ipv6_netmask:
|
|
ffrl-a-ix-dus:
|
|
public_ipv4_address:
|
|
tunnel_ipv4_network: # Format: IP/Maske
|
|
tunnel_ipv4_address:
|
|
tunnel_ipv4_netmask:
|
|
tunnel_ipv6_address:
|
|
tunnel_ipv6_netmask:
|
|
ffrl-b-ix-dus:
|
|
public_ipv4_address:
|
|
tunnel_ipv4_network: # Format: IP/Maske
|
|
tunnel_ipv4_address:
|
|
tunnel_ipv4_netmask:
|
|
tunnel_ipv6_address:
|
|
tunnel_ipv6_netmask:
|
|
ffrl-a-fra2-fra:
|
|
public_ipv4_address:
|
|
tunnel_ipv4_network: # Format: IP/Maske
|
|
tunnel_ipv4_address:
|
|
tunnel_ipv4_netmask:
|
|
tunnel_ipv6_address:
|
|
tunnel_ipv6_netmask:
|
|
ffrl-b-fra2-fra:
|
|
public_ipv4_address:
|
|
tunnel_ipv4_network: # Format: IP/Maske
|
|
tunnel_ipv4_address:
|
|
tunnel_ipv4_netmask:
|
|
tunnel_ipv6_address:
|
|
tunnel_ipv6_netmask:
|
|
|
|
```
|
|
- Neues Gateway aufsetzen per `ansible-playbook playbooks/gateways.yml`
|
|
- Hierbei werden die definierten Rollen auch auf schon aufgesetzte Gateways angewandt, was unkritisch ist, weil wir unsere Rollen idempotent schreiben.
|
|
- Um die Rollen nur auf das neu aufzusetzende Gateway anzuwenden: `ansible-playbook playbooks/gateways.yml --limit=$FQDN`
|