## Goal

This document is intended to provide an overview of the Opsview puppet module and demonstrate working examples to get the reader started with using the module. It is not intended to provide a guide on how to use puppet, including installation of packages or configuration of puppet/puppetdb files.

## Design

The Opsview puppet module allows puppet to create and modify Opsview objects using Opsview’s REST API. ​In order to accomplish this, a puppet “manage” node needs to be delegated for gathering and applying Opsview configuration (this is commonly the puppet master, itself.)

## Requirements

  • Puppet server package and Puppet DB package installed. The Puppet DB package will make it possible to use exported resources. [https://docs.puppet.com/puppetserver/2.3/install_from_packages.html](🔗) [https://docs.puppet.com/puppetdb/4.0/install_from_packages.html](🔗)

  • The Opsview puppet module, available here: [https://github.com/opsview/opsview-puppet](🔗) Zip available here: [https://github.com/opsview/opsview-puppet/archive/master.zip](🔗)

  • The “manage” node will need to have the rest-client and json rubygems packages

  • Puppet will need to be configured to automatically send modules to client nodes (default behavior for current version.)

Puppet Version

Only Puppet v3 is currently supported.