1
0
Fork 0
mirror of https://github.com/roles-ansible/ansible_role_avahi_daemon.git synced 2024-08-16 15:09:48 +02:00
ansible_role_avahi_daemon/README.md
2023-10-05 22:16:18 +02:00

81 lines
2.6 KiB
Markdown

[![Ansible Galaxy](https://ansible.l3d.space/svg/l3d.avahi_daemon.svg)](https://galaxy.ansible.com/ui/standalone/roles/l3d/avahi_daemon/)
[![MIT License](https://ansible.l3d.space/svg/l3d.avahi_daemon_license.svg)](LICENSE)
[![Maintainance](https://ansible.l3d.space/svg/l3d.avahi_daemon_maintainance.svg)](https://ansible.l3d.space/#l3d.avahi_daemon)
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:
```yaml
---
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.
[![collection l3d.avahi](https://ansible.l3d.space/svg/l3d.avahi_ansible-collection_collection.svg)](https://galaxy.ansible.com/ui/repo/published/l3d/avahi/)
[![Maintainance](https://ansible.l3d.space/svg/l3d.avahi_maintainance_collection.svg)](https://ansible.l3d.space/#l3d.avahi)
[![License](https://ansible.l3d.space/svg/l3d.avahi_license_collection.svg)](LICENSE)
Visit the [README.md](https://github.com/roles-ansible/ansible_collection_avahi#readme) of the l3d.avahi collection for information about downloading or integrating the collection to your ansible playbook.
### Role Usage Example:
```bash
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