Version information
This version is compatible with:
- Puppet Enterprise 2025.5.x, 2025.4.x, 2025.3.x, 2025.2.x, 2025.1.x, 2023.8.x, 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x
- Puppet >= 7.0.0 < 9.0.0
- RedHat,Rocky,AlmaLinux,Debian,Ubuntu
Start using this module
Add this module to your Puppetfile:
mod 'treydock-munge', '6.0.0'Learn more about managing modules with a PuppetfileDocumentation
puppet-munge
Table of Contents
- Overview
- Usage - Configuration options
- Reference - Parameter and detailed reference to all options
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
- TODO
- 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 configmunge::install: Manage munge packagesmunge::repo: Manage munge repomunge::service: Manage munge servicemunge::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_repopackage_ensurepackage_nameinstall_devdev_package_nameservice_nameservice_ensureservice_enableservice_hasstatusservice_hasrestartmunge_key_pathlog_dirlib_dirconf_dirrun_dirmunge_key_sourcemunge_key_contentmanage_userusergroupmunge_user_uidmunge_group_gidmunge_user_shellmunge_user_homepackage_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)
Changed
Added
v5.0.0 (2023-08-22)
Changed
Added
v4.1.0 (2022-08-06)
Added
v4.0.0 (2021-11-25)
Changed
v3.2.0 (2021-11-25)
Added
v3.1.0 (2021-09-22)
Added
v3.0.0 (2021-03-17)
Changed
v2.4.0 (2020-06-19)
Added
v2.3.0 (2019-12-27)
Added
v2.2.0 (2019-11-18)
Added
v2.1.0 (2019-11-18)
Added
v2.0.0 (2019-05-08)
Changed
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)
Added
- Changes to allow for using or not using the stahnma/epel module #4 (millerjl1701)
1.0.0 (2017-11-13)
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)
0.1.0 (2014-07-11)
0.0.2 (2014-06-19)
0.0.1 (2014-06-19)
* This Changelog was automatically generated by github_changelog_generator
Dependencies
- puppetlabs/stdlib (>= 4.13.1 <10.0.0)
- puppet/epel (>= 3.0.0 <6.0.0)
Copyright (C) 2017 Trey Dockendorf <treydock@gmail.com>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.