Forge Home

facecount

pdk
Retrieve node count from PuppetDB

beergeek

beergeek

6,799 downloads

5,289 latest version

5.0 quality score

Version information

  • 0.1.2 (latest)
  • 0.1.1 (deleted)
  • 0.1.0
released Mar 10th 2018
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 6.0.0
  • Debian
    ,
    RedHat
    ,
    Ubuntu
    ,
    windows

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'beergeek-facecount', '0.1.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add beergeek-facecount
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install beergeek-facecount --version 0.1.2

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

beergeek/facecount — version 0.1.2 Mar 10th 2018

facecount

Table of Contents

  1. Overview
  2. Setup - The basics of getting started with facecount
  3. Usage - Using the new action
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module

Overview

A Puppet Module providing the ability for customer to easily track their Puppet Enterprise node counts.

Features

  • Puppet Face to retrieve the node count from PuppetDB
  • Custom fact to expose the same information in the console
  • Puppet Class to gather historical node counts to a log file

Setup

Install the module via Code Manager or r10k and then run Puppet. If you would like to gather historical node count statistics to a file, include the provided class facecount on your Puppet Enterprise Master either through Puppet Code or the Node Classifier and statistics will be collected into the file /var/log/puppetlabs/node_count.txt for you and updated every 30 minutes.

Custom fact

This module includes a custom fact to expose node counts through the Puppet Enterprise Console. Node counts are available on the Puppet Enterprise Master/Master of Masters on it's inventory page:

node count on master

This information only makes sense to display for the Puppet Master, so regular agent nodes will display the message 'Available on Puppet Master/MoM only' instead on their individual inventory pages.

Usage

Once installed and puppet has run, you will have a new action for the puppet node subcommand on the Puppet master:

puppet node count

Limitations

Requires the module to be installed on your Puppet Master and run puppet at least once on the Puppet master before the command becomes available. Can normally be only run from the Puppet master due to PuppetDB library access.

Development

Happy for PRs!