ansible-ffibk/roles/network-fastd/README.md

# Ansible role network-fastd

Diese Ansible role konfiguriert Netzwerk Interfaces für die definierten fastd Instanzen.

Es wird zwischen node- und intragate-Instanzen unterschieden.

## Interface-Benamung
Node-Interfaces: $mesh.id + vpn + '-' + $mesh.fastd.nodes.instances.xx.mtu, z.B. "mzvpn-1312"
Intragate-Interfaces: $mesh.id + 'ig' + vpn + '-' + $mesh.fastd.intragate.instances.xx.mtu, z.B. "mzigvpn-1312"

## Benötigte Variablen

- Dictionary `meshes`
´´´
meshes:
  - id: xx
...
    ipv4_network:
...
    fastd:
      nodes:
        instances:
          - id: 0 # integer
            mtu: # integer
          ...
      intragate:
        instances:
          - id: 0 # integer
            mtu: # integer
          ...

´´´
- Host Variable `magic`

## MAC-Adressen

Die MAC-Adressen der Interfaces werden aus dem IPv4-Subnetz sowie der `magic`-Nummer des Hosts berechnet.

xxvpn-$mtu prefix: `02:2x` # x = ID der fastd-Instanz
xxigvpn-$mtu prefix: `02:3x` # x = ID der fastd-Instanz
-												Roles: add role documentation

											
										
										
											2017-09-06 11:17:38 +02:00
+								# Ansible role network-fastd
-												Restructure fastd configuration to define multiple instances easily

 - introduce mesh subdictionary `fastd`
 - change fastd instance naming
 - change fastd network interface naming (identical with fastd instance
names)
 - change mac address prefixes

											
										
										
											2017-10-07 00:57:35 +02:00
+								Diese Ansible role konfiguriert Netzwerk Interfaces für die definierten fastd Instanzen.
-												Roles: add role documentation

											
										
										
											2017-09-06 11:17:38 +02:00
-												Restructure fastd configuration to define multiple instances easily

 - introduce mesh subdictionary `fastd`
 - change fastd instance naming
 - change fastd network interface naming (identical with fastd instance
names)
 - change mac address prefixes

											
										
										
											2017-10-07 00:57:35 +02:00
+								Es wird zwischen node- und intragate-Instanzen unterschieden.
 								## Interface-Benamung
-												Lowercase all network interface names

											
										
										
											2017-11-06 21:24:56 +01:00
+								Node-Interfaces: $mesh.id + vpn + '-' + $mesh.fastd.nodes.instances.xx.mtu, z.B. "mzvpn-1312"
 								Intragate-Interfaces: $mesh.id + 'ig' + vpn + '-' + $mesh.fastd.intragate.instances.xx.mtu, z.B. "mzigvpn-1312"
-												Roles: add role documentation

											
										
										
											2017-09-06 11:17:38 +02:00
 								## Benötigte Variablen
 								- Dictionary `meshes`
 								´´´
 								meshes:
-												Migrate nested dictionary `meshes` into a list of dictionaries

 - migrate dictionary `ipv6` into two simple lists
 - migrate dictionary `forward_zones` into a list

											
										
										
											2017-10-06 22:58:00 +02:00
+								  - id: xx
-												Roles: add role documentation

											
										
										
											2017-09-06 11:17:38 +02:00
+								...
 								    ipv4_network:
 								...
-												Role network-fastd: update README.md

											
										
										
											2017-10-08 09:44:42 +02:00
+								    fastd:
 								      nodes:
 								        instances:
 								          - id: 0 # integer
 								            mtu: # integer
 								          ...
 								      intragate:
 								        instances:
 								          - id: 0 # integer
 								            mtu: # integer
 								          ...
-												Roles: add role documentation

											
										
										
											2017-09-06 11:17:38 +02:00
 								´´´
 								- Host Variable `magic`
 								## MAC-Adressen
-												Restructure fastd configuration to define multiple instances easily

 - introduce mesh subdictionary `fastd`
 - change fastd instance naming
 - change fastd network interface naming (identical with fastd instance
names)
 - change mac address prefixes

											
										
										
											2017-10-07 00:57:35 +02:00
+								Die MAC-Adressen der Interfaces werden aus dem IPv4-Subnetz sowie der `magic`-Nummer des Hosts berechnet.
-												Roles: add role documentation

											
										
										
											2017-09-06 11:17:38 +02:00
-												Lowercase all network interface names

											
										
										
											2017-11-06 21:24:56 +01:00
+								xxvpn-$mtu prefix: `02:2x` # x = ID der fastd-Instanz
 								xxigvpn-$mtu prefix: `02:3x` # x = ID der fastd-Instanz