Puppet Documentation Index
This is the documentation for Puppet, as well as several related tools and applications.
Most of the content here applies equally to Puppet Enterprise and open source releases of Puppet, but make sure you’re using the right docs version for your Puppet Enterprise version. If you get lost, check the version note in red text at the top of each page.
Practically speaking, Puppet is a collection of several projects. Here’s the documentation for all of the major components that make up a Puppet deployment:
|Puppet Server||Latest||Other versions|
Cheat Sheets and Glossary
Small documents for getting help fast.
- Core Types Cheat Sheet — A double-sided reference to the most common resource types.
- Module Cheat Sheet — A one-page reference to Puppet module layout, covering classes and defined types, files, templates, and plugins.
Puppet Reference Manuals
A concise reference to Puppet’s usage and internals. Use the left sidebar of any reference manual page to navigate between pages.
Other Reference Material
- Versioned References — inline reference docs from Puppet’s past and present
- History of the Puppet Language — a table showing which language features were added and removed in which Puppet versions
Learn about different areas of Puppet, fix problems, and design solutions.
Installing and Configuring
Get the latest version of Puppet up and running.
- An Introduction to Puppet
- Installing Puppet 4 for Linux
- Installing Puppet 4 for Windows
- Upgrading Puppet from 3.x to 4.x
Previous Install Guides
Building and Using Modules
- Beginner’s Guide to Modules — Learn what works best when starting to develop a new Puppet module.
- Module Fundamentals — nearly all Puppet code should be in modules.
- Installing Modules from the Puppet Forge — save time by using pre-existing modules
- Module Smoke Testing — write and run basic smoke tests for your modules
- Publishing Modules on the Puppet Forge — preparing your best modules to go public
Help With Writing Puppet Code
- Techniques — common design patterns, tips, and tricks
- Troubleshooting — avoid common problems and confusions
- Style Guide — Puppet community conventions
- Best Practices — use Puppet effectively
- Templating — template out config files using ERB
- Virtual Resources
- Exported Resources — share data between hosts
- Using the Augeas Resource Type — safely edit many types of config files
Using Optional Features
- Puppet File Serving — Files in modules are automatically served; this guide explains how to configure additional custom mount points for serving large files that shouldn’t be kept in modules.
Puppet on Windows
You can manage Windows nodes side by side with your *nix infrastructure, with Puppet 2.7 and higher (including Puppet Enterprise ≥ 2.5).
Tuning and Scaling
Puppet’s default configuration is meant for prototyping and designing a site. Once you’re ready for production deployment, learn how to adjust Puppet for peak performance.
- Running a Production-Grade Puppet Master Server With Passenger — This should be one of your earliest steps in scaling out Puppet.
- Scaling Puppet — general tips & tricks
- Using Multiple Puppet Masters — a guide to deployments with multiple Puppet masters
Hacking and Extending: Using Puppet’s Data
- Puppet Data Library: Overview — Puppet automatically gathers reams of data about your infrastructure. Learn where that data is, how to access it, and how to mine it for knowledge.
- Inventory Service — use Puppet’s inventory of nodes at your site in your own custom applications
- Reporting — learn what your nodes are up to
Hacking and Extending: APIs and Interfaces
- HTTP Access Control — secure API access with
- External Nodes — specify what your machines do using external data sources
- LDAP Nodes — a special-case tool for keeping node information in your LDAP directory
Hacking and Extending: Ruby Plugins
- Plugins In Modules — where to put plugins, how to sync to clients
- Writing Custom Facts
- Writing Custom Functions
- Writing Custom Types & Providers
- Complete Resource Example — more information on custom types & providers
- Provider Development — more about providers
- Running Puppet from Source — preview the leading edge
- Development Life Cycle — learn how to contribute code
- Puppet Internals — understand how Puppet works internally
Puppet has gone through some transitional periods, and we’ve occasionally written short guides to explain major changes in its behavior.
- Scope and Puppet — understand and banish dynamic lookup warnings with Puppet 2.7
- Scaling With Mongrel — Running production puppet master servers with pre-0.24.6 versions of Puppet