Ansible role to install and configure Avahi. Avahi enables discoverable services in a network, specifically mirroring Apple Bonjour behavior allow Mac's to discover services in a Linux machine.
This role has been tested on Ubuntu 20.04 and should work on most modern Debian installations.
The role will need sudo privileges so it should be run with become: True or a user with sufficient default privileges to install and configure packages.
The following variables are defined in defaults/main.yml and can be used to further configure Avahi services. avahi_services is the most important variable which defines which services are advertised over mDNS.
# List of service definitions.
avahi_services:
# Name of the file, /etc/avahi/services/afpd.service
- name: afpd
# List of services
services:
# Service type, port, and txt records.
- type: _afpower._tcp
port: 548
- type: _device-info._tcp
port: 0
txt_records:
- model=Xserve
# Replace wildcards in the service definition (i.e. %h -> hostname)
avahi_replace_wildcards: yes
# Network name to be advertised
avahi_network_name: '%h'
# Enable or disable IPv6
avahi_use_ipv6: 'no'
# Set which interfaces to run on
avahi_allow_interfaces: "{{ ansible_default_ipv4.interface }}"
# Enable or disable reflector mode
avahi_enable_reflector: 'yes'
# Support for systems not usingn dbus/systemd
avahi_enable_dbus: 'yes'
None
Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
- hosts: servers
roles:
- name: brianhartsock.avahi
become: true
MIT
Created with love by Brian Hartsock.