Puppet Approved Modules
Puppet Forge modules are great at making your life easier. With the new Puppet Approved program, finding the right module is even easier. Puppet Approved modules are recommended by Puppet for use with Puppet Enterprise and meet our expectations for quality and usability.
Puppet Approved modules meet Puppet's standards for quality composition, reliable operation, and active development.
Puppet ensures that Puppet Approved modules:
- Solve a discrete automation challenge and are developed in accordance with module best practices
- Adhere to Puppet's standards for style and design
- Have accurate and thorough documentation to help you get started quickly
- Are regularly maintained and versioned according to SemVer rules
- Provide metadata including license, issues url, and where to find source code
- Do not deliberately inject malicious code or otherwise harm the system they're used with
What's the difference between Puppet Approved & Puppet Supported modules?
- Puppet Approved is a designation given to modules that pass specific quality and usability requirements. These modules are recommended by Puppet, but not supported as part of a Puppet Enterprise license agreement.
- Puppet Supported are modules that have been tested with Puppet Enterprise and are fully supported by Puppet and/or a third-party vendor where applicable.
How do I use Puppet Approved modules?
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.
How can I get help with a Puppet Approved module?
If you find a bug in a Forge module, you may file an issue by clicking the Report issues link near the top of the module's Forge page. And if you feel ambitious, generally you can even contribute a fix by following the Project URL link to its source control repository.
Though Puppet Approved modules are not part of any support agreement with Puppet, there are many ways to get help from the Puppet community. You might even get to chat with the author themselves! You can:
- Post to the Puppet Users Google Group
- Join the Puppet Community Slack channel
- Search for general Puppet guidance on the Open Source Puppet Assist Portal
How are Puppet Approved modules selected?
Today, modules are manually selected for review based on popularity, originality, and other inputs from the Forge and community.
If you're a module author or are interested in detailed criteria used to consider modules for Puppet Approved, see this page for more details.
How do I nominate a module to be Puppet Approved?
Module authors are welcome to request a review by submitting a ticket in the MODULES project at tickets.puppetlabs.com. We'll do our best to review all candidates in a timely fashion. In the future, we intend to automate most of the module analysis, providing feedback as close to the time of publication as possible.
Where can I find Puppet Approved modules?
All Puppet Approved modules can be browsed with this search query.
How will I know if a module is Puppet Approved?
On the module page, you'll see a badge that says "approved".
When searching for a module, Puppet Approved modules will be marked as such in the search results.
If I have multiple versions of a module, do I have to get them all approved?
Puppet will evaluate the latest release of your module and consider it for Puppet Approved. Within the major SemVer style version, we consider subsequent releases approved, assuming the module still conforms to quality standards.
Why would I want my module approved?
A Puppet Approved badge puts your module in front of a wider audience, giving it more usage and a better chance at getting community contributions.