Ansible Collection - Jonny007MKD.interfaces

Role gather_ip_interfaces

Ansible facts contain information about the IP configuration in a non-optimal way (IMO). This role restructures the facts and sets new variables:

interfaces

A list of dicts containing the configuration of each network interfaces. The specific content comes from the ansible variables; this is only an aggregate of all interface dictionaries.

ok: [localhost] => {
    "interfaces": [
        {
            "active": true,
            "device": "lo",
            "features": {
                "esp_hw_offload": "off [fixed]",
                "esp_tx_csum_hw_offload": "off [fixed]",
                "fcoe_mtu": "off [fixed]",
                "generic_receive_offload": "on",
                "generic_segmentation_offload": "on",
                ...
            },
            "hw_timestamp_filters": [],
            "ipv4": {
                "address": "127.0.0.1",
                "broadcast": "",
                "netmask": "255.0.0.0",
                "network": "127.0.0.0",
                "prefix": "8"
            },
            "ipv6": [
                {
                    "address": "::1",
                    "prefix": "128",
                    "scope": "host"
                }
            ],
            "mtu": 65536,
            "promisc": false,
            "timestamping": [],
            "type": "loopback"
        },
        {
            "active": true,
            "device": "wlo1",
            "features": {
                "esp_hw_offload": "off [fixed]",
                "esp_tx_csum_hw_offload": "off [fixed]",
                "fcoe_mtu": "off [fixed]",
                "generic_receive_offload": "on",
                "generic_segmentation_offload": "off [requested on]",
                ...
            },
            "hw_timestamp_filters": [],
            "ipv4": {
                "address": "192.168.1.100",
                "broadcast": "192.168.1.255",
                "netmask": "255.255.255.0",
                "network": "192.168.1.0",
                "prefix": "9"
            },
            "ipv6": [
                {
                    "address": "fddc:ffeb:2910::206",
                    "prefix": "128",
                    "scope": "global"
                },
                {
                    "address": "fddc:ffeb:2910:0:18c7:c3ff:efa6:35ae",
                    "prefix": "64",
                    "scope": "global"
                }
            ],
            "macaddress": "18:c7:c3:a6:35:ae",
            "module": "rtw88_8821ce",
            "mtu": 1500,
            "pciid": "0000:01:00.0",
            "promisc": false,
            "timestamping": [],
            "type": "ether"
        }
    ]
}

all_ipv4_addresses

A list of dicts with the information about this machine's IPv4 networks

ok: [localhost] => {
    "all_ipv4_addresses": [
        {
            "interface": "lo",
            "address": "127.0.0.1",
            "address_prefix": "127.0.0.1/8",
            "broadcast": "",
            "netmask": "255.0.0.0",
            "network": "127.0.0.0",
            "network_prefix": "127.0.0.0/8",
            "prefix": "8"
        },
        {
            "interface": "wlo1",
            "address": "192.168.1.100",
            "address_prefix": "192.168.1.100/24",
            "broadcast": "192.168.1.255",
            "netmask": "255.255.255.0",
            "network": "192.168.1.0",
            "network_prefix": "192.168.1.0/24",
            "prefix": "24"
        }
    ]
}

all_ipv6_addresses

A list of dicts with the information about this machine's IPv6 networks

ok: [localhost] => {
    "all_ipv6_addresses": [
        {
            "address": "::1",
            "address_prefix": "::1/128",
            "interface": "lo",
            "prefix": "128",
            "scope": "host"
        },
        {
            "address": "fddc:ffeb:2910::206",
            "address_prefix": "fddc:ffeb:2910::206/128",
            "interface": "wlo1",
            "prefix": "128",
            "scope": "global"
        },
        {
            "address": "fddc:ffeb:2910:0:18c7:c3ff:efa6:35ae",
            "address_prefix": "fddc:ffeb:2910:0:18c7:c3ff:efa6:35ae/64",
            "interface": "wlo1",
            "prefix": "64",
            "scope": "global"
        },
    ]
}

Usage

Simply include the role in your playbook:

---
- name: My playbook
  hosts: localhost
  connection: local
  roles:
      - Jonny007MKD.interfaces.gather_ip_interfaces

Or include it in your role when you need it:

- name: Gather IP facts on servers
  ansible.builtin.import_role:
      name: Jonny007MKD.interfaces.gather_ip_interfaces