Writing a Puppet Site Manifest

After installing and configuring Puppet, you can write Puppet manifests to control the nodes that run the Puppet Agent. Puppet manifests use a Puppet-specific language that is similar to Ruby. Each manifest uses a .pp file extension.

The Puppet site manifest, site.pp, is the main file that Puppet uses to define the pre-environment configuration. A site manifest defines a configuration that you want applied to every node. So, using a site manifest is ideal for managing system-wide configurations, such as DNS servers, LDAP configurations, and other site-wide settings that are common to all of the nodes.

A site manifest can also include node-specific blocks of code that apply to certain nodes. This capability enables you to assign specific configurations to specific nodes within a site manifest. See Writing Puppet Manifests That Specify Node-Specific Code.

Note:

The site.pp manifest does not exist on the Puppet Server (server) by default. You must initially create this file on the server in the default /etc/puppetlabs/code/environments/production/manifests directory.