Puppet Supported Modules

Puppet Forge modules are pretty great at making your life easier. Puppet Supported modules take it one step further, making sure common services are easy to set up, implement, and manage with Puppet Enterprise.

Support Lifecycle

Supported modules are maintained and supported on supported platforms, over the lifetime of the Puppet Enterprise lifecycle. See this reference for expected end-of-life (EOL) dates of popular operating systems. Only the most recent version of each module is fully supported.

Features in Puppet Supported modules will only be commercially supported if they are supported by upstream platforms, even if the underlying functionality continues to work. For example, as RedHat moved away from Docker support in RHEL, the puppetlabs-docker module dropped testing and support for the RedHat-shipped docker package, although you could continue to use the module by switching to the Docker packages provided by Mirantis.

We provide a short transition period for customers to gracefully upgrade to supported platforms. Once a Puppet version or operating system reaches EOL, then compatibility will be removed from each Supported module's metadata, but that will not prevent its use or availability. Customers may still file critical support requests for a three-month transition period. After that period, all support ceases and we will begin removing code for supporting old platforms.

Puppet version or operating system EOL:

• Compatibility removed from metadata
• The EOL platform will be removed from the testing matrix
• Critical customer bugfixes only for EOL platforms
• Customers may still file support requests but will be encouraged to upgrade

Three months after respective EOL:

• Code for supporting EOL platforms will be removed
• All issues and pull requests for old platform support will be closed
• The module will be released with a SemVer major version increment
• Customers will be required to upgrade their platforms in order to file support requests

Users who cannot upgrade their platform will need to pin modules to the latest release supporting their platform. You can do this by specifying the required version in your Puppetfile.

How do I use a supported module?

You will find installation instructions on each module's Forge page. Whether you add the module to your Puppetfile or install it to a Bolt project, just follow its README for help getting started using it.

If you find a bug in a supported module, you may file an issue by clicking the Report issues link near the top of the module's Forge page or contact the Puppet Support team if you need immediate assistance. And if you feel ambitious, you can even contribute a fix by following the Project URL link to its GitHub repository, following the regular contributing guidelines. Given our more rigorous testing for supported modules, please be patient as we work on merging your pull requests.

What does testing mean?

When we say that each supported module has been tested, we mean that each module has been run through all the standard PDK tests, including:

• puppet-lint to ensure stylistic consistency
• rspec-puppet unit tests for any classes or defined types
• Rubocop validation to ensure compliance with Ruby community standards
• acceptance testing with the Litmus test framework

If you are interested in testing your modules Puppet Development Kit (PDK) makes it easy to get started.

How can my module become a supported module?

The Puppet Supported badge indicates commercial support from Puppet. If you'd like a badge to signify high quality on your own module, see the Puppet Approved program.

What about the modules that come packaged in Puppet Enterprise?

The modules that come bundled with your install of Puppet Enterprise are officially supported, and those that exist on the Forge may be upgraded to the latest versions for bugfixes and retain that support.

What about the other modules in the puppetlabs namespace?

Only modules marked as Supported will receive commercial support. Other modules in our namespace will be of varying quality and maintenance levels and should be evaluated like any other module on the Forge.

Puppet Supported Modules Compatibility Matrix

Below is a list of supported modules showing current compatibility across the Puppet Enterprise supported platforms.