rouster 0.7 → 0.41

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b6badce99c05cdd7080ee400746d3c2b73a550cf
-  data.tar.gz: b776da73cf962263b7a9d2c0ee9fedef736d926d
+  metadata.gz: 05f007fa8cb115a1889737b42c19eb6ab3a1029e
+  data.tar.gz: c58f43def276534730ead0ffb636254805ce8080
 SHA512:
-  metadata.gz: fc0b36efffe024aa6f50bc2e4ca27aaa8be09224019b4fcd7a15e02a1be28b91b33e0050043879d34e63121a61832176d0fe81acfa0f849f80e0a67c4f03ef37
-  data.tar.gz: dfe3b1e7d14c1a9aae10a86eaa26f876c411999152deeb4d220dc4dc685c5706f915f8fb9dfeb4790b73d800e1f8823468d5f5f567de7d5df2208ea55ff96bd7
+  metadata.gz: 6465a1136c9506cb9f6fd7a7dd46d90eb39d30501ab7162d2f1635bad69a6cb349bfd45eb1d183f19abdd5e214cdca81cf02f6337fd2f7f72093bd343644f7d3
+  data.tar.gz: 88f46d185da9d5f61193ca97651d0a16165c05e2b68871fbfb57dc6a219865054c60218682d90cb0bceaff48319b3511906570aec5597de678dd4e1a6ac0daab

data/.gitignore

@@ -4,6 +4,3 @@ doc/*
 *.swp
 *tmp*
 *.gem
-.rakeTasks
-*raiden*
-.project

data/README.md

@@ -1,8 +1,6 @@
 Rouster
 ======
 
-[![build status](https://travis-ci.org/chorankates/rouster.svg)](https://travis-ci.org/chorankates/rouster) [![Gem Version](https://badge.fury.io/rb/rouster.svg)](https://rubygems.org/gems/rouster)
-
 ```rb
 Rouster.is_a?('abstraction layer for controlling Vagrant virtual machines')
 => true
@@ -24,48 +22,23 @@ The first implementation of Rouster was in Perl, called [Salesforce::Vagrant](ht
 
 ## Requirements
 
-* [Ruby](http://rubylang.org), version 2.0+ (best attempt made to support 1.8.7 and 1.9.3 as well)
 * [Vagrant](http://vagrantup.com), version 1.0.5+
-* Gems
-  * json
-  * log4r
-  * net-scp
-  * net-ssh
-  * fog (only if using AWS or OpenStack)
+* a usable Vagrantfile
+
+Note: Vagrant itself requires VirtualBox or VMWare Fusion (1.0.3+)
 
 Note: Rouster should work exactly the same on Windows as it does on \*nix and OSX (minus rouster/deltas.rb functionality, at least currently),
 but no real testing has been done to confirm this. Please file issues as appropriate.
 
-### From-source local usage (latest)
-
-```sh
-git clone https://github.com/chorankates/rouster.git
-cd rouster
-bundle install # use :aws to pull in fog
-...
-irb(main):001:0> require './path_helper.rb'
-=> true
-irb(main):002:0> require 'rouster'
-=> true
-```
-
-### From-source installation (latest)
+### Easiest installation
 
 ```sh
 git clone https://github.com/chorankates/rouster.git
 cd rouster
 rake buildgem
-gem install rouster-<version>.gem
-...
-irb(main):001:0> require 'rouster'
-=> true
+gem install Rouster-<version>.gem
 ```
 
-### pre-built gem installation (stable)
-
-```sh
-gem install rouster
-```
 
 ## Using Rouster
 
@@ -146,89 +119,6 @@ app.get('/tmp/foo')
 app.destroy()
 ```
 
-### advanced instantiation (passthroughs!)
-
-detailed options in ```examples/passthrough.rb```, ```examples/aws.rb``` and ```examples/openstack.rb```
-
-since Rouster only requires an SSH connection to control a machine, why stop at Vagrant?
-
-```rb
-require 'rouster'
-require 'rouster/plugins/aws'
-require 'rouster/plugins/openstack'
-
-# control the machine rouster itself is running on
-local = Rouster.new(:name => 'local', :passthrough => { :type => :local } }
-
-# control a remote machine
-remote = Rouster.new(
-  :name => 'remote',
-  :passthrough => {
-    :type => :remote,
-    :host => 'foo.bar.com',
-    :user => 'keanu',
-    :key  => '/path/to/private/key',
-  }
-
-  :sudo => true, # false by default, enabling requires that sshd is not enforcing 'requiretty'
-)
-
-# control a running EC2 instance
-aws_already_running = Rouster.new(
-  :name => 'cloudy',
-  :passthrough => {
-    :type     => :aws,
-    :instance => 'your-instance-id',
-    :keypair  => 'your-keypair-name',
-  }
-)
-
-# start and control an EC2 instance
-aws_start_me_up = Rouster.new(
-  :name        => 'bgates',
-  :passthrough => {
-    :type            => :aws,
-    :ami             => 'your-ami-id',
-    :security_groups => 'your-security-groups',
-    :key_id          => 'your-aws-key-id',     # defaults to ${AWS_ACCESS_KEY_ID}
-    :secret_key      => 'your-aws-secret-key', # defaults to ${AWS_SECRET_ACCESS_KEY}
-  }
-)
-
-# create a remote OpenStack instance
-ostack = Rouster.new(
-  :name      => 'ostack-testing',
-  :passthrough => {
-    :type                => :openstack,
-    :openstack_auth_url  => 'http://hostname.domain.com:5000/v2.0/tokens',
-    :openstack_username  => 'some_console_user',
-    :openstack_tenant    => 'tenant_id',
-    :user                => 'some_ssh_userid', 
-    :keypair             => 'keypair_name',
-    :image_ref           => 'c0340afb-577d-4db6-1234-aebdd6d1838f',
-    :flavor_ref          => '547d9af5-096c-44a3-1234-7d23162556b8',
-    :openstack_api_key   => 'some_api_key',
-    :key                 => '/path/to/private/key.pem',
-  },
-  :sudo => true, # false by default, enabling requires that sshd is not enforcing 'requiretty'
-)
-
-# control a running OpenStack instance
-openstack_already_running = Rouster.new(
-  :name      => 'ostack-copy',
-  :passthrough => {
-    :type                => :openstack,
-    :openstack_auth_url  => 'http://hostname.domain.com:5000/v2.0/tokens',
-    :openstack_username  => 'some_console_user',
-    :openstack_tenant    => 'tenant_id',
-    :user                => 'ssh_user',
-    :keypair             => 'keypair_name',
-    :instance            => 'your-instance-id',
-  },
-)
-
-```
-
 ### functional puppet test
 
 ```rb
@@ -272,130 +162,6 @@ end
 ## Base Methods
 
 ```rb
-irb(main):001:0> require './path_helper.rb'
-=> true
-irb(main):002:0> require 'rouster'
-=> true
-irb(main):003:0> pp (Rouster.new(:name => 'app').methods - Object.methods).sort
-=> [
-[:_run,
- :cache,
- :cache_timeout,
- :check_key_permissions,
- :connect_ssh_tunnel,
- :deltas,
- :destroy,
- :dir,
- :dirs,
- :disconnect_ssh_tunnel,
- :exitcode,
- :facts,
- :facts=,
- :file,
- :files,
- :generate_unique_mac,
- :get,
- :get_crontab,
- :get_groups,
- :get_output,
- :get_packages,
- :get_ports,
- :get_services,
- :get_ssh_info,
- :get_users,
- :halt,
- :is_available_via_ssh?,
- :is_dir?,
- :is_executable?,
- :is_file?,
- :is_group?,
- :is_in_file?,
- :is_in_path?,
- :is_package?,
- :is_passthrough?,
- :is_port_active?,
- :is_port_open?,
- :is_process_running?,
- :is_readable?,
- :is_service?,
- :is_service_running?,
- :is_symlink?,
- :is_user?,
- :is_user_in_group?,
- :is_vagrant_running?,
- :is_writeable?,
- :logger,
- :os_type,
- :output,
- :package,
- :parse_ls_string,
- :passthrough,
- :put,
- :rebuild,
- :restart,
- :retries,
- :run,
- :sandbox_available?,
- :sandbox_commit,
- :sandbox_off,
- :sandbox_on,
- :sandbox_rollback,
- :sshkey,
- :status,
- :suspend,
- :traverse_up,
- :unittest,
- :up,
- :uses_sudo?,
- :vagrant,
- :vagrantbinary,
- :vagrantfile]
-]
-```
-
-## AWS methods
-```rb
-irb(main):001:0> require './path_helper.rb'
-=> true
-irb(main):002:0> require 'rouster'
-=> true
-irb(main):003:0> require 'rouster/plugins/aws'
-=> true
-irb(main):004:0> pp (Rouster.new(:name => 'aws', :passthrough => { :type => :aws }).methods - Object.methods).sort
-=> [
-...
- :aws_bootstrap,
- :aws_connect,
- :aws_connect_to_elb,
- :aws_describe_instance,
- :aws_destroy,
- :aws_get_ami,
- :aws_get_hostname,
- :aws_get_instance,
- :aws_get_ip,
- :aws_get_metadata,
- :aws_get_url,
- :aws_get_userdata,
- :aws_status,
- :ec2,
- :elb,
- :elb_connect,
- :find_ssh_elb,
- :instance_data,
-...
-]
-```
-
-## Openstack methods
-
-```rb
-[
-  :ostack_connect,
-  :ostack_describe_instance,
-  :ostack_destroy,
-  :ostack_get_instance_id,
-  :ostack_get_ip,
-  :ostack_status,
-  :ostack_up
-]
+irb(main):003:0> (Rouster.new(:name => 'app').methods - Object.methods).sort
+=> [:_run, :_vm, :check_key_permissions, :connect_ssh_tunnel, :deltas, :destroy, :dir, :exitcode, :facter, :facts, :file, :generate_unique_mac, :get, :get_catalog, :get_groups, :get_output, :get_packages, :get_ports, :get_puppet_errors, :get_puppet_notices, :get_services, :get_ssh_info, :get_users, :is_available_via_ssh?, :is_dir?, :is_executable?, :is_file?, :is_group?, :is_in_file?, :is_in_path?, :is_package?, :is_passthrough?, :is_port_active?, :is_port_open?, :is_process_running?, :is_readable?, :is_service?, :is_service_running?, :is_user?, :is_user_in_group?, :is_writeable?, :log, :os_type, :output, :parse_catalog, :parse_ls_string, :passthrough, :put, :rebuild, :remove_existing_certs, :restart, :run, :run_puppet, :sshkey, :status, :sudo, :suspend, :traverse_up, :up, :uses_sudo?, :vagrantfile, :verbosity]
 ```

data/Rakefile

@@ -1,83 +1,46 @@
 require sprintf('%s/%s', File.dirname(File.expand_path(__FILE__)), 'path_helper')
 require 'rubygems'
 require 'rake/testtask'
-require 'reek/rake/task'
 
-desc 'build the gem'
-task :build do
+task :buildgem do
   sh 'gem build rouster.gemspec'
 end
 
-desc 'cleanup environment'
-task :clean do
-  sh 'rm /tmp/rouster-*'
-end
-
 task :default do
   sh 'ruby test/basic.rb'
 end
 
-desc 'run the example demo'
 task :demo do
   sh 'ruby examples/demo.rb'
 end
 
-desc 'rdoc generation'
 task :doc do
   sh 'rdoc --line-numbers lib/*'
 end
 
 task :examples do
   Dir['examples/**/*.rb'].each do |example|
-    sh "ruby #{example}"
-  end
+	  sh "ruby #{example}"
+	end
 end
 
-desc 'shortcut to vagrant destroy -f'
-task :vdestroy do
-  sh 'vagrant destroy -f'
+Rake::TestTask.new do |t|
+  t.name = 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/test_*.rb']
+  t.verbose = true
 end
 
-Reek::Rake::Task.new do |t|
-  t.config_file   = sprintf('%s/.reek', File.dirname(__FILE__))
-  #t.source_files  = FileList.new('lib/**/*.rb', 'plugins/**/*.rb')
-  t.source_files  = FileList.new('lib/**/*.rb')
-  t.reek_opts     = '--no-wiki-links'
-  t.fail_on_error = false
-  t.verbose       = true
+Rake::TestTask.new do |t|
+  t.name = 'unit'
+  t.libs << 'lib'
+  t.test_files = FileList['test/unit/**/test_*.rb']
+  t.verbose = true
 end
 
-namespace :test do
-  Rake::TestTask.new(:all => :vdestroy) do |t|
-    t.description = 'run all tests'
-    t.libs << 'lib'
-    t.test_files = FileList['test/**/test_*.rb']
-  end
-
-  Rake::TestTask.new do |t|
-    t.name = 'unit'
-    t.description = 'run unit tests'
-    t.libs << 'lib'
-    t.test_files = FileList['test/unit/**/test_*.rb']
-  end
-
-  Rake::TestTask.new(:functional => :vdestroy) do |t|
-    t.description = 'run functional tests'
-    t.libs << 'lib'
-    t.test_files = FileList['test/functional/**/test_*.rb']
-  end
-
-  Rake::TestTask.new(:deltas => :vdestroy) do |t|
-    t.description = 'run delta tests'
-    t.libs << 'lib'
-    t.test_files = FileList['test/functional/deltas/test_*.rb']
-  end
-
-  Rake::TestTask.new do |t|
-    t.name        = 'puppet'
-    t.description = 'run puppet tests'
-    t.libs << 'lib'
-    t.test_files  = FileList['test/puppet/test*.rb']
-    t.verbose = true
-  end
+Rake::TestTask.new do |t|
+  t.name = 'functional'
+  t.libs << 'lib'
+  t.test_files = FileList['test/functional/**/test_*.rb']
+  t.verbose = true
 end

data/Vagrantfile

@@ -1,35 +1,17 @@
 # stripped down example piab Vagrantfile for rouster
 
-boxes = {
-  :ppm   => {
-    :box_name => 'centos6',
-    :box_url  => 'http://puppet-vagrant-boxes.puppetlabs.com/centos-64-x64-vbox4210.box',
-  },
-  :app   => {
-    :box_name => 'centos6',
-    :box_url  => 'http://puppet-vagrant-boxes.puppetlabs.com/centos-64-x64-vbox4210.box',
-  },
-
-  :ubuntu12  => {
-      :box_name => 'ubuntu12',
-      :box_url => 'http://puppet-vagrant-boxes.puppetlabs.com/ubuntu-server-12042-x64-vbox4210.box',
-  },
-
-  :ubuntu13     => {
-    :box_name => 'ubuntu13',
-    :box_url  => 'http://puppet-vagrant-boxes.puppetlabs.com/ubuntu-1310-x64-virtualbox-puppet.box',
-  },
-
-}
+box_url  = 'http://puppet-vagrant-boxes.puppetlabs.com/centos-64-x64-vbox4210.box'
+box_name = 'centos6'
+boxes    = [:ppm, :app]
 
 Vagrant::Config.run do |config|
-  boxes.each_pair do |box,hash|
+  boxes.each do |box|
     config.vm.define box do |worker|
 
-      worker.vm.box            = hash[:box_name]
-      worker.vm.box_url        = hash[:box_url]
-      worker.vm.host_name      = hash[:box_name]
-      worker.vm.network        :hostonly, sprintf('10.0.1.%s', rand(253).to_i + 2)
+      worker.vm.box            = box_name
+      worker.vm.box_url        = box_url
+      worker.vm.host_name      = box.to_s
+      worker.vm.network        :hostonly, sprintf('10.0.1.%s', rand(254))
       worker.ssh.forward_agent = true
 
       if box.to_s.eql?('ppm') and File.directory?('../puppet')