arillso.system.network role – Network management with multi-entry-point support

Note

This role is part of the arillso.system collection (version 1.0.5).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install arillso.system.

To use it in a playbook, specify: arillso.system.network.

Entry point dns – DNS configuration entry point

Synopsis

  • Entry point for configuring DNS resolution

  • Supports systemd-resolved and traditional resolv.conf

Parameters

Parameter

Comments

network_dns_domain

string

Default DNS domain

Default: ""

network_dns_nameservers

list / elements=string / required

List of DNS nameservers

network_dns_options

list / elements=string

DNS resolver options

Default: []

list / elements=string

List of DNS search domains

Default: []

network_resolved_cache

string

DNS cache setting for systemd-resolved

Default: "yes"

network_resolved_dns

list / elements=string

DNS servers for systemd-resolved

Default: []

network_resolved_dns_over_tls

string

DNS-over-TLS setting for systemd-resolved

Default: "no"

network_resolved_dnssec

string

DNSSEC setting for systemd-resolved

Default: "allow-downgrade"

network_resolved_dnsstublistener

string

DNS stub listener setting for systemd-resolved

Default: "yes"

network_resolved_domains

list / elements=string

Search domains for systemd-resolved

Default: []

network_resolved_fallback_dns

list / elements=string

Fallback DNS servers for systemd-resolved

Default: ["8.8.8.8", "8.8.4.4"]

network_resolved_llmnr

string

LLMNR setting for systemd-resolved

Default: "yes"

network_resolved_multicast_dns

string

Multicast DNS setting for systemd-resolved

Default: "yes"

network_use_systemd_resolved

boolean

Use systemd-resolved instead of /etc/resolv.conf

Choices:

  • false

  • true ← (default)

Entry point main – Network management with multi-entry-point support

Synopsis

  • Manages network configuration including DNS and netplan

  • Supports systemd-resolved and traditional resolv.conf

Parameters

Parameter

Comments

network_backup_configs

boolean

Create backups before modifying configuration files

Choices:

  • false

  • true ← (default)

network_debug_mode

boolean

Enable debug output for troubleshooting

Choices:

  • false ← (default)

  • true

network_dns_domain

string

Default DNS domain

Default: ""

network_dns_nameservers

list / elements=string

List of DNS nameservers

Default: []

network_dns_options

list / elements=string

DNS resolver options

Default: []

list / elements=string

List of DNS search domains

Default: []

network_netplan_apply

boolean

Apply netplan configuration after writing

Choices:

  • false ← (default)

  • true

network_netplan_config

dictionary

Netplan configuration dictionary

Default: {}

network_netplan_enabled

boolean

Enable netplan configuration

Choices:

  • false ← (default)

  • true

network_netplan_filename

string

Filename for the netplan configuration

Default: "01-netcfg.yaml"

network_netplan_renderer

string

Netplan renderer backend

Default: "networkd"

network_resolv_enabled

boolean

Enable DNS configuration

Choices:

  • false

  • true ← (default)

network_resolved_cache

string

DNS cache setting for systemd-resolved

Default: "yes"

network_resolved_dns

list / elements=string

DNS servers for systemd-resolved

Default: []

network_resolved_dns_over_tls

string

DNS-over-TLS setting for systemd-resolved

Default: "no"

network_resolved_dnssec

string

DNSSEC setting for systemd-resolved

Default: "allow-downgrade"

network_resolved_dnsstublistener

string

DNS stub listener setting for systemd-resolved

Default: "yes"

network_resolved_domains

list / elements=string

Search domains for systemd-resolved

Default: []

network_resolved_fallback_dns

list / elements=string

Fallback DNS servers for systemd-resolved

Default: ["8.8.8.8", "8.8.4.4"]

network_resolved_llmnr

string

LLMNR setting for systemd-resolved

Default: "yes"

network_resolved_multicast_dns

string

Multicast DNS setting for systemd-resolved

Default: "yes"

network_restart_services

boolean

Restart network services after configuration changes

Choices:

  • false

  • true ← (default)

network_retry_count

integer

Number of retry attempts for tasks

Default: 3

network_retry_delay

integer

Delay in seconds between retry attempts

Default: 5

network_systemd_networkd_restart

boolean

Restart systemd-networkd after network changes

Choices:

  • false ← (default)

  • true

network_systemd_resolved_restart

boolean

Restart systemd-resolved after DNS changes

Choices:

  • false

  • true ← (default)

network_use_systemd_resolved

boolean

Use systemd-resolved instead of /etc/resolv.conf

Choices:

  • false

  • true ← (default)

network_validate_netplan

boolean

Validate netplan configuration before applying

Choices:

  • false

  • true ← (default)

Entry point netplan – Netplan configuration entry point

Synopsis

  • Entry point for configuring network interfaces via netplan

  • Ubuntu/Debian with netplan only

Parameters

Parameter

Comments

network_netplan_apply

boolean

Apply netplan configuration after writing

Choices:

  • false ← (default)

  • true

network_netplan_config

dictionary / required

Netplan configuration dictionary

network_netplan_filename

string

Filename for the netplan configuration

Default: "01-netcfg.yaml"

network_netplan_renderer

string

Netplan renderer backend

Default: "networkd"

network_validate_netplan

boolean

Validate netplan configuration before applying

Choices:

  • false

  • true ← (default)