`flyoverhead.openwrt.network`

OpenWRT network configuration

create/delete/configure network devices
create/delete/configure network interfaces

Role Variables

Variable	Descritpion	Status	Type	Default/Example
`network_globals`	Global network configuration options		`dictionary`
`network_ula_prefix`	IPv6 ULA prefix (`IPv6-prefix` or `auto`)	`optional`	`string`	`auto`
`network_packet_steering`	Enable or disable usage of every CPU to handle packet traffic	`optional`	`boolean`	`0`
`network_devices`	List of network devices		`list of dictionaries`
`id`	Unique device ID	`required`	`string`	`guest_dev`
`name`	Unique device name	`mandatory`	`string`	`br-guest`
`state`	Device status (`present` or `absent`)	`required`	`string`	`present`
`type`	Device type (for bridge devices only)	`optional`	`string`	`bridge`
`ports`	List of ports associated with bridge device	`required`	`list`	`["eth0", "eth1"]`
`stp`	Enable the Spanning Tree Protocol (STP) which prevents network loops	`optional`	`boolean`	`0`
`igmp_snooping`	Enable IGMP snooping	`optional`	`boolean`	`0`
`ipv6`	Enable IPv6 support	`optional`	`boolean`	`0`
`network_interfaces`	List of [network interfaces](https://openwrt.org/docs/guide-user/base-system/	`igmp_snooping`	Enable IGMP snooping	`optional`
`id`	Unique interface ID	`mandatory`	`string`	`guest`
`state`	Interface status (`present` or `absent`)	`required`	`string`	`present`
`device`	Network device associated with the interface (for newly created interface)	`optional`	`string`	`guest_dev`
`proto`	Interface protocol	`mandatory`	`string`	`static`
`auto`	Specifies whether to bring up interface on boot	`optional`	`boolean`	`0` for proto `none`, else `1`
`force_link`	Specifies whether ip address, route, and optionally gateway are assigned to the interface regardless of the link being active ('1') or only after the link has become active ('0')	`optional`	`boolean`	`1` for protocol `static`, else `0`
`ipaddr`	IP address	`required`	`string`	`192.168.1.1`
`netmask`	Netmask	`required`	`string`	`255.255.255.0`
`gateway`	Default gateway	`optional`	`string`	`192.168.1.1`
`peerdns`	Use peer/DHCP provided DNS server(s)	`optional`	`boolean`	`1`
`dns`	Override peer/DHCP provided DNS server(s)	`optional`	`list`	`["1.1.1.1", "8.8.8.8"]`
`username`	Username for PAP/CHAP authentication	`optional`	`string`	`username`
`password`	Password for PAP/CHAP authentication	`optional`	`string`	`password`
`mtu`	MTU value	`optional`	`integer`	`1532`
`ipv6`	Enable IPv6 support	`optional`	`boolean`	`0`
`delegate`	Enable prefix delegation	`optional`	`boolean`	`0`
`ip6assign`	Assign a part of given length of every public IPv6-prefix to this interface	`optional`	`integer`	`60`
`network_rules`	List of network rules		(`list of dictionaries`)
`id`	Unique rule ID	`mandatory`	`string`	`rule_example`
`state`	Rule status (`present` or `absent`)	`required`	`string`	`present`
`mark`	fwmark and optionally its mask to match	`optional`	`string`	`0xFF`
`in`	Incoming logical interface name	`optional`	`string`	`lan`
`out`	Outgoing logical interface name	`optional`	`string`	`wan`
`src`	Source subnet to match (CIDR notation)	`optional`	`string`	`172.16.0.0/16`
`dest`	Destination subnet to match (CIDR notation)	`optional`	`string`	`192.168.1.0/24`
`invert`	Invert the meaning of the match options	`optional`	`boolean`	`0`
`priority`	Priority of the IP rule	`optional`	`integer`	`100`
`lookup`	Protocol ID to use for the route declared in `/etc/iproute2/rt_tables`	`mandatory`	`string`	`main`
`goto`	Rule to jump to specified by its `priority` value	`optional`	`integer`	`99`
`action`	Routing action (`prohibit`, `unreachable`, `blackhole` or `throw`)	`optional`	`string`	`prohibit`
`disabled`	Disable the rule	`optional`	`boolean`	`0`
`network_routes`	List of network routes		(`list of dictionaries`)
`id`	Unique route ID	`mandatory`	`string`	`route_example`
`state`	Route status (`present` or `absent`)	`required`	`string`	`present`
`interface`	Logical interface name of the parent (or master) interface the route belongs to	`mandatory`	`string`	`lan`
`target`	Network address	`mandatory`	`string`	`172.16.0.10`
`netmask`	Route netmask	`optional`	`string`	`255.255.255.255`
`gateway`	Network gateway	`optional`	`string`	`172.16.0.1`
`table`	Table ID to use for the route	`optional`	`string`	`main`
`source`	Route source address in source-address dependent routes	`optional`	`boolean`	`0`
`type`	Routing type (`unicast`, `local`, `broadcast`, `multicast`, `unreachable`, `prohibit`, `blackhole` or `anycast`)	`optional`	`string`	`unicast`
`proto`	Protocol ID to use for the route declared in `/etc/iproute2/rt_tables`	`mandatory`	`string`	`main`
`disabled`	Disable the rule	`optional`	`boolean`	`0`

Dependencies

Name	Description
`Ansible Role: openwrt`	Ansible role by gekmihesg for managing OpenWRT and derivatives

Example Playbook

- hosts: openwrt
  roles:
      - role: flyoverhead.openwrt.network

Example Vars

network_devices:
  - id: "iot_dev"
    name: "br-iot"
    state: "present"
    type: "bridge"
network_interfaces:
  - id: "lan"
    proto: "static"
    ipaddr: "192.168.1.1"
    netmask: "255.255.255.0"
  - id: "wan"
    proto: "dhcp"
  - id: "iot"
    state: "present"
    device: "br-iot"
    proto: "static"
    auto: "1"
    force_link: "1"
    ipaddr: "192.168.2.1"
    netmask: "255.255.255.0"
  - id: "wan6"
    state: "absent"

README.md

`flyoverhead.openwrt.network`

Role Variables

Dependencies

Example Playbook

Example Vars

License

Author Information

References

README.md Unescape Escape

flyoverhead.openwrt.network

Role Variables

Dependencies

Example Playbook

Example Vars

License

Author Information

References

README.md

`flyoverhead.openwrt.network`