mirror of https://github.com/roles-ansible/ansible_role_avahi_daemon.git synced 2024-08-16 15:09:48 +02:00

Mirror of https://github.com/roles-ansible/ansible_role_avahi_daemon.git

Find a file

dependabot[bot] aa0ae3db4f Bump ansible-actions/ansible-galaxy-action from 1.1.1 to 1.2.0 Bumps [ansible-actions/ansible-galaxy-action](https://github.com/ansible-actions/ansible-galaxy-action) from 1.1.1 to 1.2.0. - [Release notes](https://github.com/ansible-actions/ansible-galaxy-action/releases) - [Commits](https://github.com/ansible-actions/ansible-galaxy-action/compare/v1.1.1...v1.2.0) --- updated-dependencies: - dependency-name: ansible-actions/ansible-galaxy-action dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com>		2023-12-15 05:48:26 +00:00
.github	Bump ansible-actions/ansible-galaxy-action from 1.1.1 to 1.2.0	2023-12-15 05:48:26 +00:00
defaults	update vriable names	2021-09-02 11:02:00 +02:00
handlers	fix linting and update galaxy	2023-10-05 22:10:13 +02:00
meta	fix linting and update galaxy	2023-10-05 22:10:13 +02:00
tasks	Update linting	2023-10-28 18:12:24 +02:00
templates	Update avtions and lint template	2023-10-23 00:52:21 +02:00
vars	Update linting	2023-10-28 18:12:24 +02:00
.gitignore	Initial commit	2021-09-01 23:07:51 +02:00
.yamllint	Initial commit	2021-09-01 23:07:51 +02:00
LICENSE	Initial commit	2021-09-01 23:07:51 +02:00
README.md	Fix READM	2023-10-05 22:16:18 +02:00

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