Puppet Classes

The Puppet classes page can be accessed via the configure menu:

Configure > Classes

The Puppet classes page forms a part of orcharhino’s Puppet support. It is the default option for configuration management within orcharhino.

Puppet classes are units of Puppet code and represent an integral part of how Puppet code is structured. As such, they are somewhat similar to Ansible roles. Multiple Puppet classes form a Puppet module. orcharhino will import any Puppet module from the Puppet master and display them on the Puppet classes page.

In addition, any appropriately declared parameters from within the imported Puppet classes will be added to the smart class parameter page.

Note

Puppet classes cannot be created, added, or edited from within orcharhino. They should be managed directly via Puppet instead.

Puppet classes
  • The Import button (1) allows you to import Puppet modules from your Puppet masters, e.g. your orcharhino or any connected smart proxy.

  • The table (2) lists all already imported classes as well as information regarding their Puppet environment and number of hosts.

  • The Actions menu (3) allows you to delete a Puppet class and override all parameters. Note that delete will only remove the selected Puppet class from the management UI, but not delete the actual file.

Editing a Puppet Class

Navigate to Configure > Puppet >> Classes and select the Puppet class you want to edit in the table as shown above.

Viewing a Puppet class
  • The Class Name and Puppet environments (1) are set and cannot be changed.

  • The Host Groups field (2) allows you to select which host groups the Puppet class is assigned to.

  • Clicking the Submit button (3) saves your changes to orcharhino. Remember to also edit the other two tabs as shown below:


Puppet smart class parameters 1 Puppet smart class parameters 1

The smart class parameter tab allows you to configure the default behaviour of the Puppet module. This example chooses to override the policies key with the <%= @host.policies_enc %> value.


Puppet smart variables 1 Puppet smart variables 2

The smart variables tab allows you to configure default variables.

Refer to the Puppet guide for more information on how to use Puppet for configuration management with orcharhino.