whats

A script to query puppetdb and tell you what something is.

• Takes hostname/fqdn as an argument.
• Can provide yaml/json output as well as human readable.
• Has configurable default fact list
• has configurable domain completion/searches

Basically, whats is a wrapper around the puppetdb api, and will return facts you find interesting.

Installation

gem install puppet-whats

Config Example

---
puppetdb_server: 'puppetdb.some.domain.com'
puppetdb_port: '8080'
domains:
  - some.domain.com
  - domain.com
basic_info:
  - hostname
  - uptime

Usage

whats --help
Usage: whats [options] <hostname>
    -j, --json                       JSON output
    -y, --yaml                       YAML output
    -p, --pp                         Pretty Print output
    -a, --all                        Use all facts
    -c, --config CONFIG              Config file to use
    -v, --verbose                    Be verbose
    -q, --quiet                      Be extra quiet, only shown

Default output is a human readble table, thanks to terminal-table

Options are pretty obvious, however:

-j --json will output json formatted facts

-y --yaml will output yaml formatted facts

-p --pp will pretty-print format the facts

-a --all will just output all the facts, with whatever output you pick

-v --verbose will give you a little more info as to whats going on

-q --quiet will suppress everything except the fact output, for scripting

-c --config lets you specify a config (yaml) other than the default locations of ['~/.whats.yaml','/etc/whats.yaml']

Example:

Normal:

╰─ ./whats puppetca
Searching for puppetca...
Searching for puppetca.test.domain
+------------------------+--------------------------------------------------------+
| Fact                   | Value                                                  |
+------------------------+--------------------------------------------------------+
| hostname               | puppetca                                               |
| manufacturer           | VMware, Inc.                                           |
| productname            | VMware Virtual Platform                                |
| serialnumber           | VMware-42 20 6d 93 d4 97 c0 b8-01 dc 5d 46 e9 c7 69 a8 |
| operatingsystem        | CentOS                                                 |
| operatingsystemrelease | 7.2.1511                                               |
| architecture           | x86_64                                                 |
| processor0             | Intel(R) Xeon(R) CPU E5-2698 v3 @ 2.30GHz              |
| processorcount         | 4                                                      |
| memorysize             | 3.70 GiB                                               |
| kernelrelease          | 3.10.0-327.10.1.el7.x86_64                             |
| ipaddress              | 10.120.6.8                                             |
| macaddress             | 00:50:56:a0:71:0b                                      |
| virtual                | vmware                                                 |
| uptime                 | 10 days                                                |
+------------------------+--------------------------------------------------------+

Todo

• Add SSL support