symphony-ssh

Description

This is a small collection of base classes used for interacting with remote machines over ssh. With them, you can use AMQP (via Symphony) to run batch commands, execute templates as scripts, and perform any batch/remoting stuff you can think of without the need of a separate client agent.

These classes assume you have a user that can connect and login to remote machines using a password-less ssh keypair. They are not meant to be used directly. Subclass them!

See the rdoc for additional information and examples.

Options

Symphony-ssh uses Configurability to determine behavior. The configuration is a YAML file.

symphony_ssh:
  path: /usr/bin/ssh
  user: root
  key: /path/to/a/private_key.rsa
  opts:
    - -e
    - none
    - -T
    - -x
    - -o
    - CheckHostIP=no'
    - -o
    - BatchMode=yes'
    - -o
    - StrictHostKeyChecking=no

path

The absolute path to the ssh binary.

user

The default user to connect to remote hosts with. This can be changes per connection in the AMQP payload.

key

An absolute path to a password-less ssh private key.

opts

SSH client options, passed to the ssh binary on the command line. Note that the defaults have been tested fairly extensively, these are just exposed if you have very specific needs and you know what you're doing.

Installation

$ gem install symphony-ssh

Contributing

You can check out the current development source with Mercurial via its project page.

After checking out the source, run:

$ rake

This task will run the tests/specs and generate the API documentation.

If you use rvm, entering the project directory will install any required development dependencies.