Chloride

Gem Version Build Status Issue Count

A simple abstraction layer around NetSSH.

Features:

  • Host allows you to easily SSH/SCP to a host using local SSH defaults
  • Actions allows you to automate your interactions on a Host
  • Put it all together in order to automate your SSH-based workflows, such as installing Puppet.

Installation

Add this line to your application's Gemfile:

gem 'chloride'

And then execute:

$ bundle

Or install it yourself as:

$ gem install chloride

Usage

Check out the example go_execute command

$ bundle exec bin/go_execute 'abc123.example.com' 'cat /etc/hosts'

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Release

We use gem-release to make the gem release process easier.

# First, ensure that all the files in the repo are world-readable
chmod -R ugo+r *

# with any of the following commands, provide --pretend to see what would happen
# Second, bump the lib/chloride/version.rb file, and create a signed commit
bundle exec gem bump -s -v 1.1.1       # Bump to the given, specific version number
bundle exec gem bump -s -v major       # Bump to the next major level (e.g. 0.0.1 to 1.0.0)
bundle exec gem bump -s -v minor       # Bump to the next minor level (e.g. 0.0.1 to 0.1.0)
bundle exec gem bump -s -v patch       # Bump to the next patch level (e.g. 0.0.1 to 0.0.2)

# Finally, tag and release
bundle exec gem release -t -p       # Tag (-t), and push (-p) the gem

# If you want to do it all in one
bundle exec gem bump -v patch -s -t -p

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/puppetlabs/chloride. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

See LICENSE file.

Support

We use semantic version numbers for our releases, and recommend that users stay as up-to-date as possible by upgrading to patch releases and minor releases as they become available.

Bugfixes and ongoing development will occur in minor releases for the current major version.

Technical support is not provided for this library.