Project

chloride

0.01
Repository is archived
No release in over 3 years
Low commit activity in last 3 years
There's a lot of open issues
A simple streaming NetSSH implementation
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

Runtime

 Project Readme

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.