Puppet HipChat & Twilio

For our second weekend bonus - two final report processors, the first Puppet HipChat and the second Puppet Twilio.

Puppet HipChat

Puppet HipChat is a report processor that notifies a HipChat room of a failed Puppet run with the name of the host that failed and the date. It requires the hipchat gem to be installed on your Puppet master:

$ sudo gem install hipchat

You can then install puppet-hipcat as a module in your Puppet master’s modulepath.

Create a HipChat API key with a type of Admin. Record the API key that is generated. Next, update the hipchat_api and hipchat_room variables in the hipchat.yaml file with your HipChat connection details and the room you wish to notify. Then copy the file to /etc/puppet/. An option to notify users in the room hipchat_notify defaults to false. An example file is included.

Now enable pluginsync and reports on your master and clients in puppet.conf including specifying the hipchat report processor.

[master]
report = true
reports = hipchat
pluginsync = true
[agent]
report = true
pluginsync = true

Finally, run the Puppet client and sync the report as a plugin and your failed Puppet runs will be now be sent to the requested HipChat room.

Puppet Twilio

The Puppet Twilio report processor sends an SMS using Twilio notifying of failed Puppet runs with the name of the host that failed and the date. It’s easy to install and configure.

1. Install the twiliolib gem on your Puppet master

   $ sudo gem install twiliolib

2. Install puppet-twilio as a module in your Puppet master’s module path.

3. Update the sid, token, to (the number you want to send to), from (one of your Twilio numbers) variables in the file twilio.yaml and copy the file to /etc/puppet/.

4. Enable pluginsync and reports on your master and clients in puppet.conf

   [master] report = true reports = twilio pluginsync = true [agent] report = true pluginsync = true

5. Run the Puppet client and sync the report as a plugin