puppet-munge

Table of Contents

1. Overview
2. Usage - Configuration options
3. Reference - Parameter and detailed reference to all options
4. Limitations - OS compatibility, etc.
5. Development - Guide for contributing to the module
6. TODO
7. Additional Information

Overview

This module manages MUNGE.

Usage

munge

Manage munge and define a site specific munge.key

class { 'munge':
  munge_key_source  => 'puppet:///modules/site_munge/munge.key',
}

Reference

http://treydock.github.io/puppet-munge/

Limitations

This module has been tested on:

• RedHat/CentOS 7
• RedHat/Rocky/AlmaLinux 8
• RedHat/Rocky/AlmaLinux 9
• Debian 10
• Debian 11
• Ubuntu 20.04
• Ubuntu 22.04

Reference

Table of Contents

Classes

Public Classes

• munge: Manage MUNGE

Private Classes

• munge::config: Manage munge config
• munge::install: Manage munge packages
• munge::repo: Manage munge repo
• munge::service: Manage munge service
• munge::user: Manage munge user and group

Classes

munge

Manage MUNGE

Examples

class { 'munge':
   munge_key_source  => 'puppet:///modules/site_munge/munge.key',
 }

Parameters

The following parameters are available in the munge class:

• manage_repo
• package_ensure
• package_name
• install_dev
• dev_package_name
• service_name
• service_ensure
• service_enable
• service_hasstatus
• service_hasrestart
• munge_key_path
• log_dir
• lib_dir
• conf_dir
• run_dir
• munge_key_source
• munge_key_content
• manage_user
• user
• group
• munge_user_uid
• munge_group_gid
• munge_user_shell
• munge_user_home
• package_install_options

manage_repo

Data type: Boolean

Whether or not to manage the repo necessary to install munge. If set to false, it is assumed that the munge RPMs are available via a different repository.

Default value: false

package_ensure

Data type: String

package 'ensure' property

Default value: 'present'

package_name

Data type: String

Munge package name.

Default value: 'munge'

install_dev

Data type: Boolean

Sets if the munge-devel package should be installed

Default value: false

dev_package_name

Data type: String

Munge dev package name.

Default value: 'munge-devel'

service_name

Data type: String

Munge service name

Default value: 'munge'

service_ensure

Data type: String

Munge service 'ensure' property

Default value: 'running'

service_enable

Data type: Boolean

Munge service 'enable' property

Default value: true

service_hasstatus

Data type: Boolean

Munge service hasstatus value.

Default value: true

service_hasrestart

Data type: Boolean

Munge service hasrestart value.

Default value: true

munge_key_path

Data type: Stdlib::Absolutepath

Path to the munge.key file. Default is OS dependent.

Default value: '/etc/munge/munge.key'

log_dir

Data type: Optional[Stdlib::Absolutepath]

Log directory path, should be unnecessary to set.

Default value: undef

lib_dir

Data type: Optional[Stdlib::Absolutepath]

/var/lib directory path, should be unnecessary to set.

Default value: undef

conf_dir

Data type: Optional[Stdlib::Absolutepath]

/etc/munge directory path, should be unnecessary to set.

Default value: undef

run_dir

Data type: Optional[Stdlib::Absolutepath]

daemon run directory path, should be unnecessary to set.

Default value: undef

munge_key_source

Data type: Optional[String]

The source for the munge.key file

Default value: undef

munge_key_content

Data type: Optional[Variant[String,Binary]]

The content for the munge.key file

Default value: undef

manage_user

Data type: Boolean

Boolen that determines if munge user and group should be managed

Default value: true

user

Data type: String

User running munge

Default value: 'munge'

group

Data type: String

Group running munge

Default value: 'munge'

munge_user_uid

Data type: Optional[Integer]

UID of the munge user

Default value: undef

munge_group_gid

Data type: Optional[Integer]

GID of the munge group

Default value: undef

munge_user_shell

Data type: Stdlib::Absolutepath

Shell of munge user

Default value: '/sbin/nologin'

munge_user_home

Data type: Stdlib::Absolutepath

Home directory of munge user

Default value: '/var/run/munge'

package_install_options

Data type: Optional[Array[String]]

An array of additional options to pass when installing a package. Typical usage is enabling certain repositories like EPEL.

Default value: undef

Change log

All notable changes to this project will be documented in this file. The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

v6.0.0 (2024-11-27)

Full Changelog

Changed

• Drop EL7 and Debian 10, add Debian 12 and Ubuntu 24.04 #24 (treydock)

Added

• Allow munge_key_content to be provided as Binary type data #23 (optiz0r)

v5.0.0 (2023-08-22)

Full Changelog

Changed

• BREAKING: Major updates - read description #21 (treydock)

Added

• Support EL9, Debian 11, Ubuntu 22.04 #22 (treydock)

v4.1.0 (2022-08-06)

Full Changelog

Added

• Allow newer EPEL module #20 (treydock)

v4.0.0 (2021-11-25)

Full Changelog

Changed

• Replace CentOS 8 with Rocky 8, drop Ubuntu 16.04 support #19 (treydock)

v3.2.0 (2021-11-25)

Full Changelog

Added

• Add package_install_options to the package resource #18 (yorickps)

v3.1.0 (2021-09-22)

Full Changelog

Added

• Bump upper version limit for the stdlib dependency #17 (mrolli)

v3.0.0 (2021-03-17)

Full Changelog

Changed

• Major updates (see description) #16 (treydock)

v2.4.0 (2020-06-19)

Full Changelog

Added

• PDK update and EPEL module dependency change #15 (treydock)

v2.3.0 (2019-12-27)

Full Changelog

Added

• Allow munge.key to have content defined via munge_key_content parameter #14 (treydock)

v2.2.0 (2019-11-18)

Full Changelog

Added

• Allow user running munge to be hacked for docker based tests #13 (treydock)

v2.1.0 (2019-11-18)

Full Changelog

Added

• Add RedHat 8 and Debian 10 and drop Ubuntu 14.04 #12 (treydock)

v2.0.0 (2019-05-08)

Full Changelog

Changed

• Replace use_epel with manage_repo #6 (treydock)
• Support Puppet 5 and Puppet 6 #5 (treydock)

Added

• Document using puppet-strings #10 (treydock)
• Support Debian 8 & 9 and Ubuntu 14.04, 16.04 and 18.04 #9 (treydock)
• Use Hiera v5 module data #8 (treydock)
• pdk convert #7 (treydock)

1.1.0 (2018-01-28)

Full Changelog

Added

• Changes to allow for using or not using the stahnma/epel module #4 (millerjl1701)

1.0.0 (2017-11-13)

Full Changelog

Added

• BREAKING: Manage munge user and group, can be disabled #3 (treydock)
• BREAKING: Use data types for parameters - drop puppet 3 support #2 (treydock)

0.1.1 (2014-07-11)

Full Changelog

0.1.0 (2014-07-11)

Full Changelog

0.0.2 (2014-06-19)

Full Changelog

0.0.1 (2014-06-19)

Full Changelog

* This Changelog was automatically generated by github_changelog_generator