ansible_role_avahi_daemon/README.md

ansible role avahi_daemon

Ansible role to install the avahi_daemon and optionally announce some services.

Variables

In the avahi_daemon__services variable you can define the services you want to announce. Here is a list with available parameters:

• service: Service Name (HTTP/SSH/...) (required)
• port: Service Port (required)

• name: optional name to announce the Service
• protocol: any/ipv6/ipv4
• txt_records: an array of txt records
• transport: Transport Protokoll (tcp/udp)

Example:

---
avahi_daemon__services:
  - service: 'SSH'
    port: 22
    protocol: 'any'
    transport: 'tcp'
  - service: 'NFS'
    name: 'Filesharing Host %h'
    port: 2049
    protocol: 'ipv6'
    txt_records:
      - 'path=/path/to/nfsexport'
  - service: 'FTP'
    port: '21'
    protocol: 'ipv4'
    txt_records:
      - 'path=/ftppath'
      - 'u=ftpuser'
      - 'p=ftppass'

Netfilter rules

Avahi is using multicast to announce services. Do not forget to add netfilter rules for multicast dns.

Configuration example for ferm:

# mdns
daddr 224.0.0.251 proto udp dport 5353 ACCEPT;
daddr ff02::fb proto udp dport 5353 ACCEPT;

Ansible Collection

This role is part of the l3d.avahi Ansible Collection.

Visit the README.md of the l3d.avahi collection for information about downloading or integrating the collection to your ansible playbook.

Role Usage Example:

Links
-----
* http://dns-sd.org/
* http://www.multicastdns.org/
* https://www.ietf.org/rfc/rfc6762.txt
* http://www.dns-sd.org/ServiceTypes.html

- https://www.avahi.org/
- https://github.com/lathiat/avahi

+ https://github.com/lathiat/avahi/blob/master/avahi-daemon/avahi-service.dtd

* https://github.com/lathiat/nss-mdns