This version is compatible with:
- Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
- Puppet >= 4.7.0 < 7.0.0
- , ,
Start using this module
Add this module to your Puppetfile:
Learn more about managing modules with a Puppetfilemod 'qtechnologies-utility_scripts', '1.0.0'
Puppet module that provides some utility scripts and files.
Script to easily summarise recent puppet runs or jobs. Show output across multiple nodes allowing you to narrow down to just what you want to see.
./puppet_reports [-s status] [-v] [-d] [-g|-j] node|group|job -j get reports for all nodes in a puppet job -g get reports for all nodes in a puppet group -s match status (provide a regex string with 'failure', 'success' or 'noop') -r match resource type (provide a regex string) -n match name of resource (provide a regex string) -m match message (provide a regex string) -t show the time the puppet run ended -e show the puppet environment used for the puppet run -v show additional messages -d show potentially destructive changes only (removals)
This script outputs facts from the PuppetDB according to query criteria. The advantage over the Puppet provided tools is it provides more options for output, makes the queries simpler and combines information from the classifier.
./puppet_facts [-f json|yaml|csv ] -a action [group|fact name|node] [fact value] The following actions are supported: all in_group match_fact match_host 'group' is a Puppet Enterprise Console group 'fact name' is a PuppetDB fact in dot notation 'node' is a Puppet node - i.e. clientcert 'fact value' is required when matching a fact -r restrict the fact fields to display ( supply a comma seperated list) -f data format to output (defaults to yaml, can also be csv or json) -v is to show verbose messages -d is to show debug messages
Puppet Classifier Groups
Script to make it easier to get/set information from the Puppet classifier.
./puppet_groups [-f csv|yaml|json] -a action [group name] -a the action to perform The following actions are supported: add_agent_env delete_group list_groups get_group_id -f data format to output (defaults to json) (when listing groups) When listing the groups the 'group name' will be treated as a sub string
Script to list nodes that are not reporting according to the time you specify.
./puppet_inactive_nodes [-a age] -a age of last report (default 24 hours)
List nodes in Puppet
Simple script to just list nodes according to criteria.
./puppet_list_nodes -a action [group|fact name|node] [fact value] The following actions are supported: all in_group match_fact match_host 'group' is a Puppet Enterprise Console group 'fact name' is a PuppetDB fact in dot notation 'node' is a Puppet node - i.e. clientcert 'fact value' is required when matching a fact -v is to show verbose messages -d is to show debug messages
Script to produce rundeck node lists from PuppetDB.
./puppet_rundeck_lists -a action [group|fact name|node] [fact value] The following actions are supported: all in_group match_fact match_host 'group' is a Puppet Enterprise Console group 'fact name' is a PuppetDB fact in dot notation 'node' is a Puppet node - i.e. clientcert 'fact value' is required when matching a fact -f data format to output (defaults to yaml) -v is to show verbose messages -d is to show debug messages -u the user to use for SSH access for Rundeck
This is a bash script that facilitates a process whereby change records can be recorded as part of promoting code. At the moment it is passive, but it can be extended to reach into the service management tool to ensure the change is valid at the time it is being performed.
Install this module how you would normally include a Puppet module.
Require Perl Modules
The following perl modules are required for the scripts to work. For Centos, they are available from base and EPEL. You can use your preferred way to pull them onto your Puppet master. I like to use: https://github.com/Q-Technologies/puppet-packages, which would use the following hiera data. At the time of writing, this list may be incomplete.
packages::add: RedHat: - perl-Moose - perl-Class-Load - perl-Data-OptList - perl-Params-Util - perl-Sub-Install - perl-Module-Implementation - perl-Module-Runtime - perl-Try-Tiny - perl-Class-Load - perl-Class-Load-XS - perl-Package-DeprecationManager - perl-MRO-Compat - perl-Sub-Name - perl-Eval-Closure - perl-Sub-Exporter - perl-Devel-GlobalDestruction - perl-Sub-Exporter-Progressive - perl-Package-Stash
This module is using hiera data that is embedded in the module rather than using a params class. This may not play nicely with other modules using the same technique unless you are using hiera 3.0.6 and above (PE 2015.3.2+).
What are tasks?
Modules can contain tasks that take action outside of a desired state managed by Puppet. It’s perfect for troubleshooting or deploying one-off changes, distributing scripts to run across your infrastructure, or automating changes that need to happen in a particular order as part of an application deployment.
Tasks in this module release
Copyright 2016 Q-Technologies Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.