puppet-lldpd
Table of Contents
Overview
LLDP stands for Link Layer Discovery Protocol. This module manages the LLDP implementation from Vincent Bernat. puppet-strings docs are available in /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 contains puppet-strings generated docs.
Setup
This is very easy:
include lldpd
You can disable the repo management:
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).
Reference
The main class provides an interface that can be used. It can be configured via the upcoming parameters. All other classes are internal and can't be accessed directly.
$manage_repo
Boolean, if true, the module will setup the upstream repository. Defaults to true on Debian and CentOS family.
$repourl
String, part of the upstream repository URL. The module provides sane defaults for all repositories. There should be no need to set this parameter.
$gpgkeyfingerprint
String. The ID from the key that's used to sign the packages. Currently only used for the apt repo.
$ensure
String, allowed values are present, absent and latest. This sets the status of the lldpd package.
Development
This project contains tests for rspec-puppet.
Quickstart to run all linter and unit tests:
bundle install --path .vendor/ --without system_tests --without development --without release
bundle exec rake test
For acceptance tests:
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, it was written by Tim 'bastelfreak' Meusel.