Puppet External Nodes

This plugin allows you to use ONA as a Puppet External Node classifier. You can read more about that ability here: http://docs.puppetlabs.com/guides/external_nodes.html

Install

Unzip the archive and place it in your $ONABASE/www/local/plugins directory tar -C /opt/ona/www/local/plugins -zxvf pluginname.tar.gz
Click Plugins->Manage Plugins while logged in as an admin user
Click the install icon for the plugin which should be listed by the plugin name
Follow any instructions it prompts you with. They may or may not include the following (some user/group names may differ on various platforms):
- chown -R www-data /opt/ona/www/local/plugins
- if you have not already, run the following command echo '/opt/ona' > /etc/onabase. This assumes you installed ONA into /opt/ona
Ensure you have prerequisites installed:
- A Puppetmaster
- dcm.pl ONA command line tool (must be installed on the puppet master)
- The php YAML module

Usage

Click Plugins->Puppet External Nodes
There are now new dcm.pl modules to use from the CLI as well:
- ...._add
Add the following to /etc/puppet/puppet.conf

external_nodes = /opt/ona/bin/dcm.pl -u https://ona.example.com/dcm.php -r puppet_external_node
node_terminus = exec

You must add a default node to your nodes.pp file. Typically this default node statement would not have anything in it as those settings would come from ONA. For example:

# Must have a default node defined so the external node function works.
# The default node currently has nothing in it as we expect
# our nodes to have some sort of definition either externally or in nodes.pp.
node default {
}

You should be able to also place regular node statements in nodes.pp that are not pulled from ONA.

FUTURE

In the future support for parameterized classes and some of the newer external node classifier options should be supported.

opennetadmin/puppet_external_nodes

Puppet External Nodes

Install

Usage

FUTURE