Headstartapp::Marionette - ZMQ connection to puppet master

Marionette connects a puppet node to its master and executes puppet runs on demand. Marionette uses fast and lightweight 0MQ http://zeromq.org messaging system.

From version 0.0.14 onward, added methods: puppet!, facter! and run!
From version 0.0.9 onward, Marionette.setup automatically ran at connect.
From version 0.0.8 onward, use puppet agent for puppet runs
From version 0.0.7 onward, talk replaces send and receive.
From version 0.0.7 onward, marionette reconnects after n-poll attempts (10 by default @ 100 millisecond interval).
From version 0.0.6 onward, marionette polls before receives.

Installation

You must, of course, first install zeromq. Run the following as root:

wget http://download.zeromq.org/zeromq-2.1.0.tar.gz
tar zxvf zeromq-2.1.0.tar.gz
cd zeromq-2.1.0
./configure
make
make install
ldconfig

If you're using RVM, run this under the system context. Be sure to have the appropriate port open (for the following example, port 5555) on the puppet node.

gem install marionette

Example

The following has been tested on Centos 5.5 running Ruby 1.8.7-p174 and p302. In this example, puppet and master are on the same local network and the puppet's ip is 192.168.1.1.

Ruby:

require 'rubygems'
require 'marionette'

# With this option, ZMQ tries sending every 1 sec if recipient unavailable.
ZMQ::RECOVERY_IVL = 1

puppet = HeadStartApp::Marionette::Connect.new(:uri=>"192.168.1.1:5555) puppet
master = HeadStartApp::Marionette::Connect.new(:uri=>"192.168.1.1:5555").master

# Passing this argument polls node till reply is available (default = false).
# By default the master polls for 1 second.
poll_till_reply_available = true

# Executes a puppet run and returns output
puts master.puppet!(poll_till_reply_available)

# Executes facter and returns it as a hash
puts master.facter!(poll_till_reply_available)

# Executes an ad hoc system command
# Result on the node: /tmp/test.out contains "test #{Time.now}"
cmd = "echo 'test @ #{Time.now}' > /tmp/test.out && cat /tmp/test.out"
puts master.run!(cmd, poll_till_reply_available)

CLI:

# To start marionette as a daemon
marionette start tcp://192.168.1.1:5555

# To setup marionette as a service
# pass the tcp address if you don't want to accept the default on eth1.
marionette-setup
marionette-setup tcp://192.168.1.1:5555

MISC: # By default, the tcp connection is on eth1 over port 5555. # Tcp location is read from /etc/marionette.tcp. Update if necessary.

# run as root
chkconfig marionette on     # start marionette daemon at boot
service marionette start    # start marionette as a service
service marionette restart  # restart marionette service
service marionette stop     # stop marionette service

To Do

1) Instructions for setting up SSH Tunnel to secure marionette.

Headstartapp::Marionette - ZMQ connection to puppet master

Installation

Example

To Do

Meta