ansible.avahi

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.

Requirements

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.

Role Variables

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'

Dependencies

None

Example Playbook

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

License

MIT

Author Information

Created with love by Brian Hartsock.

Helpful Links

• Avahi Service Details
• mDNS/Bonjour Bible