Puppet Module for managing rngd


Keywords
rngd, entropy, puppet
License
Apache-2.0
Install
puppet module install bodgit-rngd --version 3.0.0

Documentation

rngd

Build Status Codecov Puppet Forge version Puppet Forge downloads Puppet Forge - PDK version

Table of Contents

  1. Description
  2. Setup - The basics of getting started with rngd
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module

Description

This module manages rngd.

The module basically makes sure the rngd daemon is installed and started, that's pretty much it. The rngd daemon does a good job at working out where the source of hardware entropy is so there's little configuration required.

Setup

Beginning with rngd

In the very simplest case, you can just include the following:

include ::rngd

Usage

For example to configure rngd to use /dev/urandom for random number input:

class { '::rngd':
  hwrng_device => '/dev/urandom',
}

If you want to use something else to manage the rngd daemon, you can do:

class { '::rngd':
  service_manage => false,
}

Reference

The reference documentation is generated with puppet-strings and the latest version of the documentation is hosted at https://bodgit.github.io/puppet-rngd/ and available also in the REFERENCE.md.

Limitations

This module has been built on and tested against Puppet 5 and higher.

The module has been tested on:

  • RedHat Enterprise Linux 6/7
  • Ubuntu 14.04/16.04
  • Debian 8/9

Development

The module relies on PDK and has both rspec-puppet and beaker-rspec tests. Run them with:

$ bundle exec rake spec
$ PUPPET_INSTALL_TYPE=agent PUPPET_INSTALL_VERSION=x.y.z bundle exec rake beaker:<nodeset>

Please log issues or pull requests at github.