ChefMetalSsh

TODO: Write a gem description

Installation

Add this line to your application's Gemfile:

gem 'chef-metal-ssh'

And then execute:

$ bundle

Or install it yourself as:

$ gem install chef-metal-ssh

Usage

valid machine options: one of the two is required, ip address is boss if both given
```
  :ip_address,
  :fqdn - this can be a shortname too as long as it resolves
```

valid ssh options

  :auth_methods, 
  :bind_address, 
  :compression, 
  :compression_level, 
  :config,
  :encryption, 
  :forward_agent, 
  :hmac, 
  :host_key,
  :keepalive, 
  :keepalive_interval, 
  :kex, 
  :keys, 
  :key_data,
  :languages, 
  :logger, 
  :paranoid, 
  :password, 
  :port, 
  :proxy,
  :rekey_blocks_limit,
  :rekey_limit, 
  :rekey_packet_limit, 
  :timeout, 
  :verbose,
  :global_known_hosts_file, 
  :user_known_hosts_file, 
  :host_key_alias,
  :host_name, 
  :user, 
  :properties, 
  :passphrase, 
  :keys_only, 
  :max_pkt_size,
  :max_win_size, :send_env, 
  :use_agent

machine resource example:

  require 'chef_metal_ssh'
  
  with_ssh_cluster("~/metal_ssh")

  machine "one" do
    action [:ready, :converge]
    machine_options 'ip_address' => '192.168.33.21',
                    'ssh_options' => {
                      'user' => 'vagrant',
                      'password' => 'vagrant'
                    }
    recipe 'ssh_test::remote1'
    notifies :create, 'machine[two]'
    notifies :run, 'execute[run_touch1]'
  end

To test it out, clone the repo:

git clone https://github.com/double-z/chef-metal-ssh.git

in the root there is a Vagrantfile with 3 nodes, 1 master and 2 targets.

FYI, nothing will get installed on your local machine in this process.

Run:

vagrant up

which will bring up all 3 nodes.

So then ssh to the master:

vagrant ssh master

the repo test directory has a test cookbook and run_zero script. its located at /vagrant/test

cd into the test directory:

cd /vagrant/test

then run:

bash run_zero install_local if you built the gem locally first using rake build

otherwise:

bash run_zero install_rubygems

this will install the prereqs. then run:

bash run_zero both

this will run the ssh_test::both recipe which will converge both targets, with target one notifying target two. target one will converge the ssh_test::remote1 recipe, target two the ssh_test::remote2 recipe.

thats it.

party on wayne.

Contributing

Fork it ( http://github.com/double-z/chef-metal-ssh/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request