Puppet Supported Modules

Puppet Supported Modules make sure common services are easy to set up, implement, and manage with Puppet Enterprise.

Guarantees

Support Lifecycle

We maintain supported modules on supported platforms over the lifetime of the Puppet Enterprise lifecycle. See Operating Systems for the expected end-of-life (EOL) dates of popular operating systems.

If features in Puppet Supported modules are supported by upstream platforms, then they are also commercially supported even if the underlying functionality continues to work. For example, when RedHat moved away from Docker support in RHEL, the puppetlabs-docker module dropped testing and support for the RedHat-shipped docker package. However, it was possible to still use the module by switching to the Docker packages provided by Mirantis.

We provide a short transition period for customers to upgrade to supported platforms. If a Puppet version or operating system reaches EOL, then we remove compatibility from each Supported module's metadata. This removal does not prevent its use or availability. Customers can still file critical support requests for a three-month transition period.

When a Puppet version or operating system initially reaches EOL:

• We remove its compatibility from module metadata.
• We remove the EOL platform from the testing matrix.
• We only provide critical customer bugfixes for EOL platforms.
• Customers can still file support requests for 3 months.

Three months after Puppet version or operating system's EOL:

• We completely remove all the code that supports EOL platforms.
• We close all issues and pull requests for old platform support.
• We release the module with a SemVer major version increment.
• Customers must upgrade their platforms in order to file support requests.

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

How do I use a supported module?

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

If you find a bug in a supported module, you can file an issue by:

• Clicking the "Report Issues" link near the top of the module's Forge page
• Contacting the Puppet Support team if you need immediate assistance.

And if you feel ambitious, you can even contribute a fix by clicking the "Project URL" link to the module's GitHub repository and following the regular contributing guidelines. Given our more rigorous testing for supported modules, please be patient as we work on reviewing and merging your pull requests.

What does testing mean?

When we say that each supported module has been tested, we mean that each module passes 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 applicable)

If you want to test your modules, see the Puppet Development Kit (PDK).

How can my module become a supported module?

The Puppet Supported badge indicates commercial support from Puppet. If you want 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 packaged with your install of Puppet Enterprise are also officially supported. Packaged modules that exist on the Forge may be upgraded to the latest versions for bug fixes and for continued support.

What about the other modules in the "puppetlabs" namespace?

Only modules marked as "supported" receive commercial support. Other modules in our namespace vary in quality and maintenance levels and must be evaluated like any other module on the Forge.

Puppet Supported Modules Compatibility Matrix

The following list displays which supported modules are compatible across the Puppet Enterprise supported platforms.