oddjob

Table of Contents

  1. Description

  2. Setup - The basics of getting started with oddjob

  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 oddjob, a D-Bus service which performs random tasks.

RHEL/CentOS is supported using Puppet 5 or later.

Setup

Beginning with oddjob

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

include dbus
include oddjob

Usage

To install the mkhomedir Oddjob job:

include dbus
include oddjob
include oddjob::mkhomedir

You will then likely want to configure the PAM stack to utilise this.

Reference

The reference documentation is generated with puppet-strings and the latest version of the documentation is hosted at bodgit.github.io/puppet-oddjob/ 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:

  • Red Hat/CentOS Enterprise Linux 6/7/8

Development

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

$ bundle exec rake spec
$ bundle exec rake litmus:*

Please log issues or pull requests at github.