Puppet MOTD module

WARNING: Current version only tested with Puppet 7.x and 8.x.

Overview

This is a simple message of the day module for Puppet. It's heavily based on the example from puppetlabs-concat.

Module Description

This module allows you to build /etc/motd in 'chunks'. That way, you can add content from different parts in your code.

License

Apache License, Version 2.0

Usage

See REFERENCE.

Contact

Federico Voges fvoges@gmail.com

Support

Please report issues on the project page.

Pull requests are welcome :)

Reference

Table of Contents

Classes

• motd: This is a simple class that manages /etc/motd using puppetlabs-concat

Defined types

• motd::fragment: Defined type to add fragments to /etc/motd

Classes

motd

Copyright 2014 Federico Voges, unless otherwise noted.

Examples

Simple example

class { 'motd':
  motd_local_enabled => false,
  add_puppet_warning => true,
}

Parameters

The following parameters are available in the motd class:

• motd_file
• motd_local_enabled
• add_puppet_warning

motd_file

Data type: Stdlib::Unixpath

Absolute path to MOTD file

Default value: '/etc/motd'

motd_local_enabled

Data type: Boolean

If true, Puppet will append the contents of /etc/motd.local. The contents of /etc/motd.local are not managed by Puppet

Default value: true

add_puppet_warning

Data type: Boolean

Adds a warning to the top of the MOTD ("${trusted['certname']} is managed by Puppet")

Default value: false

Defined types

motd::fragment

Defined type to add fragments to /etc/motd

Examples

Simple example

class { 'motd':
   motd_local_enabled => false,
   add_puppet_warning => true,
 }

 motd::fragment { 'extra motd':
   content => "This will be addded to /etc/motd\n",
 }

 motd::fragment { 'extra motd from template':
   content => template('some/template.erb'),
 }

Parameters

The following parameters are available in the motd::fragment defined type:

• content
• source
• order

content

Data type: Optional[String]

Content of the fragment

Default value: undef

source

Data type: Optional[String]

Source of the fragment

Default value: undef

order

Data type: Variant[String,Integer]

By default all files gets a 10_ prefix in the directory you can set it to anything else using this to influence the order of the content in the file

Default value: '10'

Changelog

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.

v3.0.0 - 2024-10-05

Full Changelog

Other

• rename changelog and update readme #29 (fvoges)
• update metadata for new release #28 (fvoges)
• fix ci warnings and errors #27 (fvoges)
• replace Travis with GHA #26 (fvoges)
• update to pdk 3.3 #25 (fvoges)
• pdk update to latest supported Puppet versions #24 (fvoges)
• pdk update run #23 (fvoges)
• fix and simplify Jenkinsfile #22 (fvoges)
• PDK convert and drop Puppet 3.x #21 (fvoges)

v2.0.0 - 2020-04-13

Full Changelog

Other

• PDK convert and drop Puppet 3.x #21 (fvoges)
• Update readme #20 (fvoges)
• Update #19 (fvoges)
• 2.x #16 (fvoges)
• fix broken unit tests for Puppet < 4.9.0 #15 (fvoges)
• Add Jenkinsfile #14 (fvoges)
• (maint) Maintenance #13 (fvoges)
• (maint) Fix Travis CI failures #12 (fvoges)
• Misc updates #11 (fvoges)

v1.0.3 - 2017-04-03

Full Changelog

v1.0.2 - 2017-04-03

Full Changelog

Other

• Remove all Ruby versions from test matrix except 2.1 #10 (fvoges)

v1.0.1 - 2016-12-17

Full Changelog

Other

• Remove all Ruby versions from test matrix except 2.1 #10 (fvoges)
• Update contributing rules #9 (fvoges)
• Remove Ruby 1.9.3 from test matrix #8 (fvoges)
• Update Travis CI badge URL #7 (fvoges)
• Update changelog, add coverage report and GitMagic contributing rules #4 (fvoges)
• Add source attribute to motd::fragment #3 (fvoges)

v1.0.0 - 2016-03-06

Full Changelog

v0.3.0 - 2015-03-27

Full Changelog

0.2.2 - 2015-03-02

Full Changelog

0.2.1 - 2015-03-02

Full Changelog

0.2.0 - 2015-02-25

Full Changelog

0.1.0 - 2014-05-09

Full Changelog