Write and test Puppet code and modules with the Puppet Development Kit (PDK)

We recommend that you use the open source Puppet Development Kit (PDK) to write and validate Puppet code and modules. The PDK includes a complete module skeleton, testing tools and all dependencies needed for its use.

You can also convert an existing module to a standardized PDK module with an infrastructure for testing it. This allows you to use PDK tools for creating classes, defined types, and tasks in your module, as well as validating and unit testing it. 

Learn about PDK commands from our Command Reference. The most used commands are: pdk new (module, class, defined_type), pdk validate, and pdk test unit.

If you use an IDE, take a look at Microsoft Visual Studio Code. If you use Visual Studio Code, use the Puppet VSCode Extension.

Watch a video on using Visual Studio Code with the extension.

Getting help

If you use the PDK to write code that doesn’t work and your code fails rspec testing, this is likely a code issue. If you have an issue with your code, you can ask for help from our community Slack, and IRC.

Provide feedback for the PDK

If you have any feedback or feature requests for the PDK, please provide feedback at the PDK JIRA project.

Learn more

• Installing PDK
• Developing modules with PDK
• Validate and test modules
• Customize module configuration 
• PDK Command Reference
• PDK Troubleshooting