diff -r 61c5ec82378f -r 8e29e051b417 README.rdoc --- a/README.rdoc Thu Jul 12 15:28:32 2018 -0700 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,117 +0,0 @@ - -= 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[https://rubygems.org/gems/configurability] to determine -behavior. The configuration is a YAML[http://www.yaml.org/] 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 - -**NOTE**: If you've upgrade from a version pre 0.2.0, the -Configurability path has changed from `symphony_ssh`, to an `ssh` key -under the `symphony` top level. - - -=== path - -The absolute path to the ssh binary. - -=== user - -The default user to connect to remote hosts with. This can be -changed 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}[http://bitbucket.org/mahlon/symphony-ssh]. - -After checking out the source, run: - - $ rake - -This task will run the tests/specs and generate the API documentation. - -If you use {rvm}[http://rvm.io/], entering the project directory will -install any required development dependencies. - - -== License - -Copyright (c) 2014-2018, Mahlon E. Smith and Michael Granger -All rights reserved. - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are met: - -* Redistributions of source code must retain the above copyright notice, - this list of conditions and the following disclaimer. - -* Redistributions in binary form must reproduce the above copyright notice, - this list of conditions and the following disclaimer in the documentation - and/or other materials provided with the distribution. - -* Neither the name of the author/s, nor the names of the project's - contributors may be used to endorse or promote products derived from this - software without specific prior written permission. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE -FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER -CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, -OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - -