https://github.com/voxpupuli/puppet-lldpd
Module to manage lldpd package, service and facts
https://github.com/voxpupuli/puppet-lldpd
archlinux-puppet-module bsd-puppet-module centos-puppet-module debian-puppet-module fedora-puppet-module freebsd-puppet-module gentoo-puppet-module hacktoberfest linux-puppet-module puppet redhat-puppet-module ubuntu-puppet-module
Last synced: 4 months ago
JSON representation
Module to manage lldpd package, service and facts
- Host: GitHub
- URL: https://github.com/voxpupuli/puppet-lldpd
- Owner: voxpupuli
- License: agpl-3.0
- Created: 2017-11-18T08:21:52.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-09-17T07:35:05.000Z (7 months ago)
- Last Synced: 2024-10-29T14:22:38.202Z (6 months ago)
- Topics: archlinux-puppet-module, bsd-puppet-module, centos-puppet-module, debian-puppet-module, fedora-puppet-module, freebsd-puppet-module, gentoo-puppet-module, hacktoberfest, linux-puppet-module, puppet, redhat-puppet-module, ubuntu-puppet-module
- Language: Ruby
- Size: 437 KB
- Stars: 3
- Watchers: 40
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# puppet-lldpd
[](https://github.com/voxpupuli/puppet-lldpd/actions?query=workflow%3ACI)
[](https://github.com/voxpupuli/puppet-lldpd/actions/workflows/release.yml)
[](https://forge.puppetlabs.com/puppet/lldpd)
[](https://forge.puppetlabs.com/puppet/lldpd)
[](https://forge.puppetlabs.com/puppet/lldpd)
[](https://forge.puppetlabs.com/puppet/lldpd)
[](http://www.puppetmodule.info/m/puppet-lldpd)
[](LICENSE)
## Table of Contents
* [Overview](#overview)
* [Setup](#setup)
* [Support](#support)
* [Reference](#reference)
* [Limitations](#limitations)
* [Development](#development)
* [Authors](#authors)
----
## Overview
LLDP stands for Link Layer Discovery Protocol. This module manages the LLDP
implementation from [Vincent Bernat](https://vincentbernat.github.io/lldpd/).
[puppet-strings](https://github.com/puppetlabs/puppet-strings#puppet-strings)
docs are available in [/docs](/docs). They are generated before each release.
This module configures the upstream repo if necessary. The LLDP requires a
daemon, which will be started. the command line client has support for json
output. This is used to create a structured fact. It is updated automatically
with a systemd timer (or a cronjob on legacy systems).
The [REFERENCE.md](REFERENCE.md) contains [puppet-strings](https://github.com/puppetlabs/puppet-strings#puppet-strings)
generated docs.
## Setup
This is very easy:
```puppet
include lldpd
```
You can disable the repo management:
```puppet
class{'lldpd':
manage_repo => false,
}
```
## Support
This module supports the installation on:
* Archlinux
* CentOS 7
* Fedora 32
* Debian 9
* Debian 10
* Ubuntu 16.04
* Ubuntu 18.04
* Ubuntu 20.04
* VirtuozzoLinux 7
* FreeBSD 11
* FreeBSD 12
The fact is present on all Operating Systems except for FreeBSD. Docker
acceptance tests work for CentOS 6 and 7. Vagrant acceptance tests work for
Fedora 25. Other nodesets are currently not present. The module requires at
least Puppet 4.9.4 (this is the first version with proper data-in-modules
support).
## Development
This project contains tests for [rspec-puppet](http://rspec-puppet.com/).
Quickstart to run all linter and unit tests:
```bash
bundle install --path .vendor/ --without system_tests --without development --without release
bundle exec rake test
```
For acceptance tests:
```bash
bundle install --path .vendor/ --with system_tests --without development --without release
BEAKER_debug=true PUPPET_INSTALL_TYPE=agent bundle exec rake beaker:fedora-25-x64
BEAKER_debug=true PUPPET_INSTALL_TYPE=agent bundle exec rake acceptance BEAKER_set=docker/centos-7
```
## Authors
puppet-lldpd is maintained by [Vox Pupuli](https://voxpupuli.org), it was written by [Tim 'bastelfreak' Meusel](https://github.com/bastelfreak).