daptiv-chef-ci 0.0.2 → 0.0.3

data/README.md

@@ -1,2 +1,74 @@
 # Daptiv Chef CI
-Common tools to help automate Vagrant in CI
+Common tools to help automate Vagrant in CI
+
+This is a really thin wrapper around Vagrant that makes it a little easier to call Vagrant from a Rake build. Why on earth does this exist?
+
+1. Makes it easier to call your installed Vagrant from a Rake build.
+2. Ensures vagrant is loaded from your PATH and _not_ from a bundled gem.
+3. Reduces duplication between cookbook Vagrantfiles.
+
+## Basic Usage
+
+Add a dependency for daptiv-chef-ci in your Gemfile
+
+`gem 'daptiv-chef-ci'`
+
+In your Rakefile require 'daptiv-chef-ci/vagrant_task' and then declare a new Vagrant::RakeTask. The minimal task declaration look like this in your rake file:
+
+```
+require 'daptiv-chef-ci/vagrant_task'
+
+Vagrant::RakeTask.new
+```
+
+The rake task will attempt to load a Vagrantfile as an Erubis template from the following locations in order:
+
+- Vagrantfile.erb
+- Vagrantfile
+
+If none of those exist the task will use the Vagrantfile.erb template embedded in this gem. Here's an example that specifies a Windows Vagrant box using the embedded Vagrantfile:
+
+```
+require 'daptiv-chef-ci/vagrant_task'
+
+Vagrant::RakeTask.new do |task|
+  task.guest_os = :windows
+  task.box_name = 'vagrant-windows2008r2'
+  task.box_url = 'http://example.com/vagrant/boxes/vagrant-windows2008r2.box'
+  task.run_list = ['mycookbook::recipe']
+end
+```
+
+## Configuration
+
+The vagrant rake task provides the following configuration parameters to the ERB template, these can be configured using the same name in the rake task:
+
+- guest_os - defaults to :linux
+- chef_repo_dir - The chef-repo root directory, defaults to ~/src/chef-repo
+- box_name - defaults to 'Vagrant-hostname', this is optional.
+- node_name - The chef node name, defaults to 'Vagrant-hostname', this is optional.
+- box_url - URL to the box download location, this is optional.
+- run_list - The Chef run list, defaults to empty.
+- chef_json - Any additional Chef attributes in json format, this is optional.
+
+## Logging
+
+By default this gem will not log anything other than errors to stderr, however quite often its useful to get more information from the running Vagrant process. To change the gem logging level set the CHEF_CI_LOG environment variable to one supported by log4r (DEBUG, INFO etc).
+
+`CHEF_CI_LOG=DEBUG bundle exec rake vagrant`
+
+## Development
+
+Clone this repository and use [Bundler](http://gembundler.com) to get the dependencies:
+
+```
+$ bundle install
+```
+
+Once you have the dependencies, you can run the unit tests with `rake`:
+
+```
+$ bundle exec rake
+```
+
+If those pass, you're ready to start developing.

data/daptiv-chef-ci.gemspec

@@ -43,7 +43,7 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.name          = "daptiv-chef-ci"
   gem.require_paths = ["lib"]
-  gem.version       = '0.0.2'
+  gem.version       = '0.0.3'
   
   gem.add_runtime_dependency "log4r", "~> 1.1.10"
   gem.add_runtime_dependency "erubis", "~> 2.7.0"

data/lib/daptiv-chef-ci/vagrant_driver.rb

@@ -75,7 +75,7 @@ module DaptivChefCI
     def vagrantfile_erb_path()
       erbs = [
         File.join(Dir.pwd, 'Vagrantfile.erb'),
-        File.join(Dir.pwd, 'build/Vagrantfile.erb'),
+        File.join(Dir.pwd, 'Vagrantfile'),
         File.expand_path('Vagrantfile.erb', template_dir())
       ]
           

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: daptiv-chef-ci
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-21 00:00:00.000000000 Z
+date: 2013-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: log4r
@@ -155,6 +155,7 @@ files:
 - lib/daptiv-chef-ci/vagrant_task.rb
 - lib/daptiv-chef-ci/virtualbox_driver.rb
 - pkg/daptiv-chef-ci-0.0.1.gem
+- pkg/daptiv-chef-ci-0.0.2.gem
 - Rakefile
 - README.md
 - spec/daptiv-chef-ci/logger_spec.rb
@@ -176,7 +177,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 4054523152621213775
+      hash: -504818496541812232
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -185,7 +186,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 4054523152621213775
+      hash: -504818496541812232
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23