Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bodgit/puppet-avahi
Puppet Module for managing Avahi
https://github.com/bodgit/puppet-avahi
avahi puppet
Last synced: about 2 months ago
JSON representation
Puppet Module for managing Avahi
- Host: GitHub
- URL: https://github.com/bodgit/puppet-avahi
- Owner: bodgit
- License: apache-2.0
- Created: 2016-08-22T21:02:35.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2021-06-18T21:54:07.000Z (over 3 years ago)
- Last Synced: 2024-05-15T09:53:57.080Z (9 months ago)
- Topics: avahi, puppet
- Language: Ruby
- Homepage: https://forge.puppetlabs.com/bodgit/avahi
- Size: 172 KB
- Stars: 0
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# avahi
[](https://github.com/bodgit/puppet-avahi/actions?query=workflow%3ATest)
[](https://codecov.io/gh/bodgit/puppet-avahi)
[](https://forge.puppetlabs.com/bodgit/avahi)
[](https://forge.puppetlabs.com/bodgit/avahi)
[](https://forge.puppetlabs.com/bodgit/avahi)
#### Table of Contents
1. [Description](#description)
2. [Setup - The basics of getting started with avahi](#setup)
* [Beginning with avahi](#beginning-with-avahi)
3. [Usage - Configuration options and additional functionality](#usage)
4. [Reference - An under-the-hood peek at what the module is doing and how](#reference)
5. [Limitations - OS compatibility, etc.](#limitations)
6. [Development - Guide for contributing to the module](#development)
## Description
This module manages Avahi for mDNS/DNS-SD services.
RHEL/CentOS, Ubuntu, Debian and OpenBSD are supported using Puppet 5 or
later.
## Setup
### Beginning with avahi
In the very simplest case, you can just include the following:
```puppet
include dbus
include avahi
```
## Usage
Install Avahi and add static service definitions for SSH and SFTP:
```puppet
include dbus
include avahi
avahi::service { 'ssh':
description => '%h',
replace_wildcards => true,
services => [
{
'type' => '_ssh._tcp',
'port' => 22,
},
],
}
avahi::service { 'sftp-ssh':
description => '%h',
replace_wildcards => true,
services => [
{
'type' => '_sftp-ssh._tcp',
'port' => 22,
},
],
}
```
Install Avahi and add a static host entry on behalf of an mDNS-unaware router:
```puppet
include dbus
include avahi
avahi_host { 'router.local':
ensure => present,
ip => '192.0.2.1',
}
```
## Reference
The reference documentation is generated with
[puppet-strings](https://github.com/puppetlabs/puppet-strings) and the latest
version of the documentation is hosted at
[https://bodgit.github.io/puppet-avahi/](https://bodgit.github.io/puppet-avahi/)
and available also in the [REFERENCE.md](https://github.com/bodgit/puppet-avahi/blob/main/REFERENCE.md).
## Limitations
This module has been built on and tested against Puppet 5 and higher.
The module has been tested on:
* Red Hat/CentOS Enterprise Linux 6/7/8
* Ubuntu 16.04/18.04/20.04
* Debian 9/10
* OpenBSD 6.9
## Development
The module relies on [PDK](https://puppet.com/docs/pdk/1.x/pdk.html) and has
both [rspec-puppet](http://rspec-puppet.com) and
[Litmus](https://github.com/puppetlabs/puppet_litmus) tests. Run them
with:
```
$ bundle exec rake spec
$ bundle exec rake litmus:*
```
Please log issues or pull requests at
[github](https://github.com/bodgit/puppet-avahi).