Forge Home

Modules

Puppet

Resources

PuppetEcosystemPuppet CommunityUpdates

facecount

Retrieve node count from PuppetDB
Project URLRSS FeedReport issues

7,863 downloads

6,231 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

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
  • , , ,

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!