PuppetDB 1.5 » Using PuppetDB

Included in Puppet Enterprise 3.2. A newer version is available; see the version menu above for details.

Currently, the main use for PuppetDB is to enable advanced features in Puppet. We expect additional applications to be built on PuppetDB as it becomes more widespread.

If you wish to build applications on PuppetDB, see the navigation sidebar for links to the API spec.

Checking Node Status

The PuppetDB plugins installed on your puppet master(s) include a status action for the node face. On your puppet master, run:

$ sudo puppet node status <node> 

where <node> is the name of the node you wish to investigate. This will tell you whether the node is active, when its last catalog was submitted, and when its last facts were submitted.

Using Exported Resources

PuppetDB lets you use exported resources, which allows your nodes to publish information for use by other nodes.

See here for more about using exported resources.

Using the Inventory Service

PuppetDB provides better performance for Puppet’s inventory service.

See here for more about using the inventory service and building applications on it. If you are using Puppet Enterprise’s console, or Puppet Dashboard with inventory support turned on, you will not need to change your configuration — PuppetDB will become the source of inventory information as soon as the puppet master is connected to it.

↑ Back to top