PuppetDB, Puppet Explorer and puppetdbquery
3 likes3,617 views
This document summarizes PuppetDB, Puppet Explorer, and puppetdbquery. PuppetDB is a Clojure service that stores Puppet data like facts, catalogs, and reports in a PostgreSQL backend. It allows exporting and collecting resources. PuppetDB has a rich query API to search nodes, environments, facts, catalogs, resources, and more. Puppet Explorer is a web UI that visualizes PuppetDB data using CoffeeScript and AngularJS. Puppetdbquery is a Puppet module and CLI tool for querying PuppetDB with functions, a Puppetface, hiera backend, and Ruby API. It allows querying nodes and resources with comparison, logical, and date expressions.
![Query API example
["and",
["in","certname",
["extract","certname",
["select_fact_contents",
["and",
["=","path",["lsbdistcodename"]],
["=","value","squeeze"]]]]],
["in","certname",
["extract","certname",
["select_resources",
["and",
["=","type","Class"],
["=","title","Nginx"],
["=","exported",false]]]]]]](https://image.slidesharecdn.com/puppetdbpuppetexplorer-151120173617-lva1-app6892/85/PuppetDB-Puppet-Explorer-and-puppetdbquery-5-320.jpg)
![lsbdistcodename=squeeze and class[nginx]
same query in puppetdbquery](https://image.slidesharecdn.com/puppetdbpuppetexplorer-151120173617-lva1-app6892/85/PuppetDB-Puppet-Explorer-and-puppetdbquery-6-320.jpg)
![Query syntax
Comparison operators
=
!=
>
>=
<
<=
~
!~
Logical Operators
and
or
not
Fact comparisons
factname = value
uptime.days > 209
apt_package_updates.* ~ openssl
Resource expressions
type[name] { parameter = value }](https://image.slidesharecdn.com/puppetdbpuppetexplorer-151120173617-lva1-app6892/85/PuppetDB-Puppet-Explorer-and-puppetdbquery-8-320.jpg)
![Poor mans mcollective
pssh -h <(puppet query nodes 'site=lon and class[nginx]')
sudo service nginx restart](https://image.slidesharecdn.com/puppetdbpuppetexplorer-151120173617-lva1-app6892/85/PuppetDB-Puppet-Explorer-and-puppetdbquery-10-320.jpg)
PuppetDB, Puppet Explorer and puppetdbquery
- 2. PuppetDB Aclojure service with a PostgreSQL backend. Stores data produced by Puppet: ‣ facts ‣ catalogs ‣ reports
- 3. Resource collections Allows you to export and collect resources. class ssh { # Declare: @@sshkey { $hostname: type => dsa, key => $sshdsakey, } # Collect: Sshkey <<| |>> }
- 4. Query API PuppetDB has a rich queryAPI. Can query nodes, environments, facts, fact paths, catalogs, resources, edges, reports and events. Allows subqueries between endpoints.
- 6. lsbdistcodename=squeeze and class[nginx] same query in puppetdbquery
- 7. puppetdbquery Amodule for Puppet for querying PuppetDB with: ‣ functions ‣ clitool/puppetface ‣ hierabackend ‣ RubyAPI github.com/dalen/puppet- puppetdbquery forge.puppetlabs.com/dalen/ puppetdbquery
- 8. Query syntax Comparison operators = != > >= < <= ~ !~ Logical Operators and or not Fact comparisons factname = value uptime.days > 209 apt_package_updates.* ~ openssl Resource expressions type[name] { parameter = value }
- 9. Syntactic sugar and advanced stuff Date expressions @yesterday @"feb 1 2015" Subqueries #node.latest_report_status=failed #node { report_timestamp > @"4 hours ago" and report_timestamp < @"2 hours ago" }
- 10. Poor mans mcollective pssh -h <(puppet query nodes 'site=lon and class[nginx]') sudo service nginx restart
- 11. Puppet Explorer
- 12. Puppet Explorer Web UI forvisualizing data in PuppetDB. Made using CoffeeScript and AngularJS Borrows ideas from puppetdbquery and contains a JavaScript implementation of it called node- puppetdbquery
- 13. Demo time