network-interfaces

Manage network interfaces in Debian-like systems.

Requirements

None

Variables

General

• network_interfaces_manage_devices: [required]: Whether all additional scripts should be deleted

• network_interfaces_interfaces: [default: []]: Network interfaces declarations

• network_interfaces_interfaces.{n}.device: [required]: Device name

• network_interfaces_interfaces.{n}.auto: [default: true]: Enable on boot

• network_interfaces_interfaces.{n}.family: [default: inet]: Network type, eg. inet | inet6

• network_interfaces_interfaces.{n}.method: [default: dhcp]: Method of the interface, eg. dhcp | static

• network_interfaces_interfaces.{n}.address: [optional]: Address

• network_interfaces_interfaces.{n}.network: [optional]: Network address

• network_interfaces_interfaces.{n}.netmask: [optional]: Netmask

• network_interfaces_interfaces.{n}.broadcast: [optional]: Broadcast address

• network_interfaces_interfaces.{n}.gateway: [optional]: Default gateway

• network_interfaces_interfaces.{n}.nameservers: [optional]: List of nameservers for this interface

• network_interfaces_interfaces.{n}.dns_search: [optional]: Search list for host-name lookup

• network_interfaces_interfaces.{n}.mtu: [optional]: MTU of the interface

• network_interfaces_interfaces.{n}.subnets: [optional]: List of additional subnets, eg. ['192.168.123.0/24', '192.168.124.11/32']

Bridge

• network_interfaces_interfaces.{n}.bridge: [optional, default: {}]: Bridge declarations
• network_interfaces_interfaces.{n}.bridge.ports: [optional]: Bridge ports
• network_interfaces_interfaces.{n}.bridge.stp: [optional]: Turn spanning tree protocol on/off
• network_interfaces_interfaces.{n}.bridge.fd: [optional]: Bridge forward delay
• network_interfaces_interfaces.{n}.bridge.maxwait: [optional]: Maximum time to wait for the bridge ports to get to the forwarding status
• network_interfaces_interfaces.{n}.bridge.waitport: [optional]: Maximum time to wait for the specified ports to become available

Bond

• network_interfaces_interfaces.{n}.bond: [optional, default: {}]: Bond declarations
• network_interfaces_interfaces.{n}.bond.mode: [optional]: Bonding mode. One of "active-backup", "balance-slb", or "balance-tcp"
• network_interfaces_interfaces.{n}.bond.miimon: [optional]: Specifies the MII link monitoring frequency in milliseconds
• network_interfaces_interfaces.{n}.bond.master: [optional]: The name of the device that should act as bond master
• network_interfaces_interfaces.{n}.bond.slaves: [optional]: A list of devices to be used as bond slave
• network_interfaces_interfaces.{n}.bond.lacp-rate: [optional]: Option specifying the rate in of transmission of LACPDU packets in 802.3ad mode
• network_interfaces_interfaces.{n}.bond.xmit-hash-policy: [optional]: The transmit hash policy to use for slave selection in balance-xor and 802.3ad modes

Inline hook scripts

• network_interfaces_interfaces.{n}.pre-up: [optional, default: []]: List of pre-up script lines
• network_interfaces_interfaces.{n}.up: [optional, default: []]: List of up script lines
• network_interfaces_interfaces.{n}.post-up: [optional, default: []]: List of post-up script lines
• network_interfaces_interfaces.{n}.pre-down: [optional, default: []]: List of pre-down script lines
• network_interfaces_interfaces.{n}.down: [optional, default: []]: List of down script lines
• network_interfaces_interfaces.{n}.post-down: [optional, default: []]: List of post-down script lines

Dependencies

None

Recommended

• netplan (see)

Example(s)

DigitalOcean droplet with private networking enabled

---
- hosts: all
  roles:
    - oefenweb.network-interfaces
  vars:
    network_interfaces_manage_devices: true
    network_interfaces_interfaces:
      - device: eth0
        auto: true
        family: inet
        method: static
        address: 188.166.9.28
        netmask: 255.255.0.0
        gateway: 188.166.0.1
        mtu: 1500
        nameservers:
          - 8.8.8.8
          - 8.8.4.4
        up:
          - 'ip addr add 10.18.0.8/16 dev eth0'
      - device: eth1
        auto: true
        family: inet
        method: static
        address: 10.133.136.172
        netmask: 255.255.0.0

License

MIT

Author Information

• Andreas Reischuck
• Mark van Driel
• Mischa ter Smitten

Feedback, bug-reports, requests, ...

Are welcome!