GitHubHelp

aisbergg/ansible-role-networkmanager

:wrench: An Ansible role to install and configure NetworkManager, and also manage network connections using nmcli on Linux systems.

★ 6Forks 4PythonGitHub ↗Compare

README

Ansible Role: aisbergg.networkmanager

This Ansible role is used to install and configure NetworkManager, and also manage network connections on Debian, RedHat and Arch Linux distributions.

Requirements

None.

Role Variables

Variable Default Comments
networkmanager_redhat_enablerepo Repository to enable while installing NetworkManager. Applies only to RedHat systems.
networkmanager_debian_repo {{ ansible_distribution_release }}-backports Repository used for installation. Applies only to Debian systems.
networkmanager_extra_packages [] List of additional packages to be installed, e.g. wireguard.
networkmanager_service_enabled true Enable the NetworkManager service.
networkmanager_service_state started Manage the state of the NetworkManager service
Choices:
  • reloaded
  • restarted
  • started
  • stopped
networkmanager_service_restart_on_change true Restart NetworkManager service on configuration changes.
networkmanager_connections [] List of network connections. The parameters can be looked up here.
networkmanager_config {} Main NetworkManager configuration. Available options can be found in the NetworkManager.conf.5 manpage. The options need to be provided as key-value pairs. See Example Section below for the correct syntax.
networkmanager_conf_d {} List of NetworkManager configurations, that will be put into the conf.d/ directory. See Example Section below for the correct syntax.

Dependencies

Depends on community.general collection.

Example Playbook

- hosts: all
  vars: 
    vars:
      networkmanager_service_enabled: true
      networkmanager_service_state: started
      
      networkmanager_config:
        logging:
          level: WARN
          domains: ALL

      networkmanager_conf_d:
        "mac-address":  # -> conf.d/mac-address.conf
          "device-mac-randomization":
            # "yes" is already the default for scanning
            "wifi.scan-rand-mac-address": true

          "connection-mac-randomization":
            # Randomize MAC for every ethernet connection
            "ethernet.cloned-mac-address": random
            # Generate a random MAC for each WiFi and associate the two permanently.
            "wifi.cloned-mac-address": random
      
      networkmanager_connections:
        # set DNS resolvers on default interface
        - name: "{{ ansible_default_ipv4.interface }}"
          type: "{{ 'ethernet' if ansible_default_ipv4.type == 'ether' else omit }}"
          dns4: ['9.9.9.9']
          dns4_search: example.org

  roles:
    - aisbergg.networkmanager

License

MIT

Author Information

Andre Lehmann ([email protected])

Contributors

aisberggstejoo

Issues