ventriloquist 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 09186437104632dfc1082b0c3a74c1805acffe66
-  data.tar.gz: b79fcc5629899d6a2848f8c5b7a0f90f932541dd
+  metadata.gz: 622451e1fa3cb26754ad42f9aebbc3951dbca561
+  data.tar.gz: 0932280472ea91d43f57ce5a187c3f92bf80710d
 SHA512:
-  metadata.gz: 82bf8ad04594de111b5fce86d56dc46def1309e42298a4f4942b847d3604f16b1e4afc23db62b581cc217a600c35b99e8aeec8e8d94d6a1d69969abd51a22738
-  data.tar.gz: 4fdcd644046dc4c89e95b8e01c122a123b452e48ffb1d6b4ed24b528959a4a053c0ce6cf97d85bfe110a8c3f7ff7dc775d9f96163af986b4b1965c2efd5cfb7b
+  metadata.gz: caeb20bb176e52a457af45a10807b2c9be4d25ce4dd45bba81fb150264b8e4d367b9558f07592aaabb36156a5a7e8525aac3f3e4f5205ae1f12a2055b29b9ec6
+  data.tar.gz: 190dac27b55fb95cc50a2f4aea6faf48cc7452b72827da819dfcfc2f72e18c1af48aaddd92347b667f407938a3c1bd1059d224736e5cd66e3c410e728b7bc550

data/.gitignore

@@ -3,7 +3,6 @@
 .bundle
 .config
 .yardoc
-Gemfile.lock
 InstalledFiles
 _yardoc
 coverage
@@ -15,3 +14,4 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+.vagrant

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.1.0 (September 10, 2013)
+
+  - Initial public release.

data/Gemfile

@@ -2,3 +2,19 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in ventriloquist.gemspec
 gemspec
+
+group :development, :test do
+  gem 'rake'
+  gem 'vagrant', github: 'mitchellh/vagrant', tag: 'v1.2.7'
+  gem 'rspec'
+  gem 'simplecov', require: false
+  gem 'bogus'
+end
+
+group :development do
+  gem 'vagrant-lxc',           github: 'fgrehm/vagrant-lxc'
+  gem 'vagrant-pristine',      github: 'fgrehm/vagrant-pristine'
+  gem 'vagrant-global-status', github: 'fgrehm/vagrant-global-status'
+  gem 'vagrant-cachier',       github: 'fgrehm/vagrant-cachier'
+  gem 'guard-rspec'
+end

data/Gemfile.lock

@@ -0,0 +1,118 @@
+GIT
+  remote: git://github.com/fgrehm/vagrant-cachier.git
+  revision: f8484f73434f640b790300085002b084c8a96d6b
+  specs:
+    vagrant-cachier (0.3.3.dev)
+
+GIT
+  remote: git://github.com/fgrehm/vagrant-global-status.git
+  revision: a0295400a0e47756cbcb8f97ed9f4449b1fb6b56
+  specs:
+    vagrant-global-status (0.1.1)
+
+GIT
+  remote: git://github.com/fgrehm/vagrant-lxc.git
+  revision: 2c32f1caa6bb6fff1e2d0daefe3f1f675b99474c
+  specs:
+    vagrant-lxc (0.5.1.dev)
+
+GIT
+  remote: git://github.com/fgrehm/vagrant-pristine.git
+  revision: 5c400d7850fc5f98d9601b59f4c3bd74818650de
+  specs:
+    vagrant-pristine (0.2.0)
+
+GIT
+  remote: git://github.com/mitchellh/vagrant.git
+  revision: 7ec0ee1d00a916f80b109a298bab08e391945243
+  tag: v1.2.7
+  specs:
+    vagrant (1.2.7)
+      childprocess (~> 0.3.7)
+      erubis (~> 2.7.0)
+      i18n (~> 0.6.0)
+      log4r (~> 1.1.9)
+      net-scp (~> 1.1.0)
+      net-ssh (~> 2.6.6)
+
+PATH
+  remote: .
+  specs:
+    ventriloquist (0.1.0)
+      vocker (~> 0.3.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    bogus (0.1.4)
+      dependor (>= 0.0.4)
+    childprocess (0.3.9)
+      ffi (~> 1.0, >= 1.0.11)
+    coderay (1.0.9)
+    dependor (1.0.1)
+    diff-lcs (1.2.4)
+    erubis (2.7.0)
+    ffi (1.9.0)
+    formatador (0.2.4)
+    guard (1.8.2)
+      formatador (>= 0.2.4)
+      listen (>= 1.0.0)
+      lumberjack (>= 1.0.2)
+      pry (>= 0.9.10)
+      thor (>= 0.14.6)
+    guard-rspec (3.0.2)
+      guard (>= 1.8)
+      rspec (~> 2.13)
+    i18n (0.6.5)
+    listen (1.3.1)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+      rb-kqueue (>= 0.2)
+    log4r (1.1.10)
+    lumberjack (1.0.4)
+    method_source (0.8.2)
+    multi_json (1.7.9)
+    net-scp (1.1.2)
+      net-ssh (>= 2.6.5)
+    net-ssh (2.6.8)
+    pry (0.9.12.2)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rake (10.1.0)
+    rb-fsevent (0.9.3)
+    rb-inotify (0.9.1)
+      ffi (>= 0.5.0)
+    rb-kqueue (0.2.0)
+      ffi (>= 0.5.0)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.5)
+    rspec-expectations (2.14.2)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.3)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    slop (3.4.6)
+    thor (0.18.1)
+    vocker (0.3.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bogus
+  guard-rspec
+  rake
+  rspec
+  simplecov
+  vagrant!
+  vagrant-cachier!
+  vagrant-global-status!
+  vagrant-lxc!
+  vagrant-pristine!
+  ventriloquist!

data/Guardfile

@@ -0,0 +1,5 @@
+guard :rspec do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/ventriloquist/(.+)\.rb$}) { |m| "spec/unit/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')            { "spec" }
+end

data/LICENSE.txt

@@ -19,4 +19,4 @@ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,24 +1,206 @@
 # Ventriloquist
 
-TODO: Write a gem description
+> **ven·tril·o·quist**: _(noun)_ a person who can speak or utter sounds so that
+  they seem to come from somewhere else, esp. an entertainer who makes their voice
+  appear to come from a dummy of a person or animal.
 
-## Installation
+Ventriloquist combines [Vagrant](http://www.vagrantup.com/) and [Docker](http://www.docker.io/)
+to give **developers** the ability to configure portable and disposable development
+VMs with ease. It lowers the entry barrier of building a sane working environment without
+the need to learn tools like [Puppet](http://puppetlabs.com/puppet/what-is-puppet)
+or [Chef](http://www.opscode.com/chef/).
+
+Its core is made of a Vagrant plugin that uses a set of opinionated Docker
+images + some [guest capabilities](http://docs.vagrantup.com/v2/plugins/guest-capabilities.html)
+to provision VMs with services and programming language environments, think of
+it as a "Heroku for Vagrant" where a Dyno is your Vagrant machine and Docker
+services are its addons.
+
+To give you an idea, this is what it takes to configure a Vagrant VM ready
+for development on [Discourse](http://www.discourse.org/):
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.vm.box = "quantal64"
+  config.vm.provision :ventriloquist do |env|
+    env.services  = %w( redis pg:9.1 )
+    env.platforms = %w( nodejs ruby:1.9.3 )
+  end
+end
+```
+
+
+## Project Goals
+
+* Multi purpose, "zero-conf" development environments that fits into a gist.
+* Production parity for those that have no control of their production machines,
+  like if you are deploying to Heroku or another PaaS.
+* Be the easiest tool for building other tools development environments.
+* Be a learning playground for hackers, making it easy to learn new programming
+  languages / tools.
+
+
+## Status
+
+Early development, the feature set and configuration format might change rapidly
+and has only been tested on the following Ubuntu 13.04 Vagrant VMs using Docker
+0.6.1 and Vagrant 1.2.7 / 1.3.0:
 
-Add this line to your application's Gemfile:
+* http://cloud-images.ubuntu.com/vagrant/raring/current/raring-server-cloudimg-amd64-vagrant-disk1.box
+* http://bit.ly/vagrant-lxc-raring64-2013-07-12 (yes! LXC inception :)
 
-    gem 'ventriloquist'
+_Please note that in order to use the plugin on [vagrant-lxc](https://github.com/fgrehm/vagrant-lxc)
+containers you need some extra steps described below_
 
-And then execute:
+On its current state is a "somewhat stable experiment" as I've been using a setup with the
+plugin without issues for more than a week now.
 
-    $ bundle
 
-Or install it yourself as:
+## Installation
+
+Make sure you have Vagrant 1.2+ and run:
+
+```
+vagrant plugin install ventriloquist
+```
 
-    $ gem install ventriloquist
 
 ## Usage
 
-TODO: Write usage instructions here
+Just add the provisioner block to your Vagrantfile and `vagrant up` it:
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.vm.provision :ventriloquist do |env|
+    # Pick the services you need to have around
+    env.services << %w( redis pg:9.1 memcached elasticsearch )
+    # Configure your development environment
+    env.platforms << %w( nodejs ruby:2.0.0 go )
+  end
+end
+```
+
+
+## Available services
+
+The `services` parameter passed in on the Vagrantfile are the ones built with the
+Dockerfiles available under [_/services_](services) that are configured to require
+no additional configuration for usage with the default `vagrant` user that usually
+comes with Vagrant boxes and will always be available from `localhost` using the
+default service port (like 5432 for PostgreSQL).
+
+Some extra steps might be required to simplify the connection with the configured
+services. As an example, besides running the associated Docker image, setting up
+PostgreSQL will involve installing the `postgresql-client` package and adding an
+`export PGHOST=localhost` to the guest's `/etc/profiles.d/ventriloquist.sh` so that
+the `psql` client works without any extra params.
+
+Please note that all of the builtin images are available on the Docker registry
+with the `fgrehm/ventriloquist-` prefix that is ommited on the table below:
+
+| Name          | Provides       | Notes |
+| ------------- | -------------- | ----- |
+| elasticsearch | 0.90.3         | Runs on port 9200 |
+| memcached     | 1.4.14         | Runs on port 11211 |
+| pg            | PostgreSQL 9.2 | Runs on port 5432 and adds an `export PGHOST=localhost` to the guest's `/etc/profile.d/ventriloquist`. It will also install the `postgresql-client` and `libpq-dev` packages on the guest. |
+| pg:9.1        | PostgreSQL 9.1 | Same as above |
+| mysql         | 5.5            | Runs on port 3306 and creates a `/home/vagrant/.my.conf`. It will also install the `mysql-client` and `libmysqlclient-dev` packages on the guest. |
+| redis         | 2.4.15         | Runs on port 6379 and installs / compiles the `redis-cli` excutable |
+
+Since services are just Docker images, you can build your own image, push to the
+registry and use it on your Vagrantfile, you'll just need to specify its fully
+qualified name and the corresponding Ventriloquist service:
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.vm.provision :ventriloquist do |env|
+    env.services << {
+      redis: { image: 'username/redis' },
+      pg:    { image: 'otheruser/pg', tag: 'latest' }
+    }
+  end
+end
+```
+
+
+## Available platforms
+
+In order to configure the VM for usage with the programming language that your
+app is written on, the plugin leverages Vagrant's [guest capabilities](http://docs.vagrantup.com/v2/plugins/guest-capabilities.html)
+to deal with distribution specifics. Right now things should work just fine on
+Ubuntu VMs and you'll be warned in case you specify a something that is not supported
+on your guest machine.
+
+Unless you specify the version to use (like in `ruby:1.9.3` from the Discourse
+example above), the latest version of the available platforms will be installed.
+For example, if you omit the Ruby version you want to use, Ventriloquist will
+install 2.0.0 with the latest path level.
+
+So far I've only set up the stuff I need to work but feel free to submit a Pull
+Request with the scripts required to set things for other platforms:
+
+| Name      | Provides         |
+| --------- | ---------------- |
+| ruby      | rvm + Ruby 2.0.0 |
+| go        | 1.1.2            |
+| nodejs    | Currently limited to the latest version available at https://launchpad.net/~chris-lea/+archive/node.js (0.10.17 as of this writing) |
+| phantomjs | 1.9.1            |
+
+
+## Ideas for improvements
+
+* Use a Docker container as the dev environment within the Vagrant VM, maybe using
+  [Buildstep](https://github.com/progrium/buildstep) or something like it to
+  configure it.
+* Allow services configuration from the Vagrantfile (like setting the max memory
+  used by memcached for example)
+* Saner defaults for services (none of the provided services have memory / connection
+  limits or the like)
+* Make use of Docker data volumes for services to avoid loosing data
+* Introduce "profiles" - `heroku:free` for example would limit postgresql / memcached
+  / etc resources (like max memory / connections) to what people will get there.
+* Support for installing "random" tools / packages from within the Vagrantfile
+  (like git / sqlite3 / heroku toolbelt / ruby gems / npm packages)
+* Leverage [vagrant-cachier](https://github.com/fgrehm/vagrant-cachier) during
+  provisioning
+* Convert provisioning code to a set of bash scripts so that it can be reused
+  outside of Vagrant environments as well (maybe use them for building [Packer](http://www.packer.io/)
+  images)
+
+
+### Usage with [vagrant-lxc](https://github.com/fgrehm/vagrant-lxc)
+
+If you are on a Linux machine, you can use vagrant-lxc to avoid messing up with
+your working environment. While developing this plugin I was able to recreate
+containers that were capable of using Docker without issues multiple times on
+an up to date Ubuntu 13.04 host and guest.
+
+In order to allow a vagrant-lxc container to boot nested Docker containers you'll
+just need to `apt-get install apparmor-utils && aa-complain /usr/bin/lxc-start`
+and add the code below to your Vagrantfile:
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.vm.provider :lxc do |lxc|
+    lxc.customize 'aa_profile', 'unconfined'
+  end
+
+  config.vm.provision :shell, inline: %[
+    if ! [ -f /etc/default/lxc ]; then
+      cat <<STR > /etc/default/lxc
+LXC_AUTO="false"
+USE_LXC_BRIDGE="false"
+STR
+    fi
+  ]
+end
+```
+
+The LXC networking configs are only required if you are on an Ubuntu host as
+it automatically creates the `lxcbr0` bridge for you on the host machine and
+if you don't do that the vagrant-lxc container will end up crashing as it
+will collide with the host's `lxcbr0`.
+
 
 ## Contributing
 

data/Rakefile

@@ -1 +1,3 @@
+Dir['./tasks/**/*.rake'].each { |f| load f }
+
 require "bundler/gem_tasks"

data/development/Vagrantfile

@@ -0,0 +1,50 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+Vagrant.require_plugin 'vagrant-lxc'
+Vagrant.require_plugin 'vagrant-cachier'
+Vagrant.require_plugin 'vagrant-pristine'
+Vagrant.require_plugin 'vagrant-global-status'
+Vagrant.require_plugin 'ventriloquist'
+
+Vagrant.configure("2") do |config|
+  config.vm.box = "raring64"
+  config.vm.synced_folder "../", "/vagrant", id: 'vagrant-root'
+
+  config.vm.network :private_network, ip: "192.168.123.123"
+  config.vm.network :forwarded_port, guest: 8080, host: 8080
+
+  config.cache.auto_detect = true
+
+  config.vm.provider :virtualbox do |_, override|
+    override.vm.box_url = 'http://cloud-images.ubuntu.com/vagrant/raring/current/raring-server-cloudimg-amd64-vagrant-disk1.box'
+  end
+
+  config.vm.provider :lxc do |lxc, override|
+    # Required to boot nested containers
+    lxc.customize 'aa_profile', 'unconfined'
+    override.vm.box_url = 'http://bit.ly/vagrant-lxc-raring64-2013-07-12'
+  end
+
+  # Required to boot nested containers
+  config.vm.provision :shell, inline: %[
+    if ! [ -f /etc/default/lxc ]; then
+      cat <<STR > /etc/default/lxc
+LXC_AUTO="false"
+USE_LXC_BRIDGE="false"
+STR
+    fi
+  ]
+
+  config.vm.provision :ventriloquist do |env|
+    env.services << {
+      redis:         { image: 'fgrehm/ventriloquist-redis',         tag: 'latest' },
+      memcached:     { image: 'fgrehm/ventriloquist-memcached',     tag: 'latest' },
+      elasticsearch: { image: 'fgrehm/ventriloquist-elasticsearch', tag: 'latest' }
+    }
+    env.services << ['pg:9.1', 'mysql']
+
+    env.platforms << { ruby: { version: '2.0.0' } }
+    env.platforms << %w( nodejs phantomjs go:1.1.2 )
+  end
+end

data/lib/ventriloquist/cap/debian/git_install.rb

@@ -0,0 +1,18 @@
+module VagrantPlugins
+  module Ventriloquist
+    module Cap
+      module Debian
+        module GitInstall
+          def self.git_install(machine)
+            machine.communicate.tap do |comm|
+              if ! comm.test('which git > /dev/null')
+                machine.env.ui.info('Installing git')
+                comm.sudo('apt-get install -y git')
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ventriloquist/cap/debian/go_install.rb

@@ -0,0 +1,34 @@
+module VagrantPlugins
+  module Ventriloquist
+    module Cap
+      module Debian
+        module GoInstall
+          def self.go_install(machine, version)
+            return if machine.communicate.test('which go > /dev/null')
+
+            src      = "https://go.googlecode.com/files/go#{version}.linux-amd64.tar.gz"
+            bin_path = "/usr/local/go/bin"
+            go_path  = "$HOME/go"
+
+            machine.env.ui.info("Installing go #{version}")
+            machine.communicate.tap do |comm|
+              comm.sudo('apt-get install curl -y -q')
+              # TODO: Use download + untar capability
+              comm.execute("cd /usr/local && curl #{src} | sudo tar xzfv -")
+
+              if ! comm.test("grep -q '#{bin_path}' /etc/profile.d/ventriloquist.sh 2>/dev/null")
+                comm.sudo("echo 'export PATH=$PATH:#{bin_path}' >> /etc/profile.d/ventriloquist.sh")
+              end
+
+              comm.execute("mkdir -p #{go_path}") if ! comm.test("test -d #{go_path}")
+
+              if ! comm.test("grep -q '#{go_path}' /etc/profile.d/ventriloquist.sh 2>/dev/null")
+                comm.sudo("echo 'export GOPATH=#{go_path}' >> /etc/profile.d/ventriloquist.sh")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ventriloquist/cap/debian/install_build_tools.rb

@@ -0,0 +1,18 @@
+module VagrantPlugins
+  module Ventriloquist
+    module Cap
+      module Debian
+        module InstallBuildTools
+          def self.install_build_tools(machine)
+            machine.communicate.tap do |comm|
+              if ! comm.test('dpkg -l | grep build-essential')
+                machine.env.ui.info('Installing build tools')
+                comm.sudo('apt-get install -y build-essential')
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ventriloquist/cap/debian/mercurial_install.rb

@@ -0,0 +1,18 @@
+module VagrantPlugins
+  module Ventriloquist
+    module Cap
+      module Debian
+        module MercurialInstall
+          def self.mercurial_install(machine)
+            machine.communicate.tap do |comm|
+              if ! comm.test('which hg > /dev/null')
+                machine.env.ui.info('Installing mercurial')
+                comm.sudo('apt-get install -y mercurial')
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ventriloquist/cap/debian/mysql_install_client.rb

@@ -0,0 +1,18 @@
+module VagrantPlugins
+  module Ventriloquist
+    module Cap
+      module Debian
+        module MySqlInstallClient
+          def self.mysql_install_client(machine)
+            machine.communicate.tap do |comm|
+              if ! comm.test('which mysql > /dev/null')
+                machine.env.ui.info('Installing MySQL client')
+                comm.sudo('apt-get install -y mysql-client')
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ventriloquist/cap/debian/mysql_install_headers.rb

@@ -0,0 +1,18 @@
+module VagrantPlugins
+  module Ventriloquist
+    module Cap
+      module Debian
+        module MySqlInstallHeaders
+          def self.mysql_install_headers(machine)
+            machine.communicate.tap do |comm|
+              if ! comm.test('dpkg -l | grep libmysqlclient-dev')
+                machine.env.ui.info('Installing MySQL headers')
+                comm.sudo('apt-get install -y libmysqlclient-dev')
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ventriloquist/cap/debian/nodejs_install.rb

@@ -0,0 +1,21 @@
+module VagrantPlugins
+  module Ventriloquist
+    module Cap
+      module Debian
+        module NodejsInstall
+          def self.nodejs_install(machine)
+            return if machine.communicate.test('which nodejs > /dev/null')
+
+            machine.env.ui.info('Installing nodejs')
+            machine.communicate.tap do |comm|
+              comm.sudo('apt-get install -y software-properties-common')
+              comm.sudo('add-apt-repository -y ppa:chris-lea/node.js')
+              comm.sudo('apt-get update')
+              comm.sudo("apt-get install -y nodejs")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ventriloquist/cap/debian/pg_install_client.rb

@@ -0,0 +1,18 @@
+module VagrantPlugins
+  module Ventriloquist
+    module Cap
+      module Debian
+        module PgInstallClient
+          def self.pg_install_client(machine)
+            machine.communicate.tap do |comm|
+              if ! comm.test('which psql > /dev/null')
+                machine.env.ui.info('Installing PostgreSQL client')
+                comm.sudo('apt-get install -y postgresql-client')
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ventriloquist/cap/debian/pg_install_headers.rb

@@ -0,0 +1,18 @@
+module VagrantPlugins
+  module Ventriloquist
+    module Cap
+      module Debian
+        module PgInstallHeaders
+          def self.pg_install_headers(machine)
+            machine.communicate.tap do |comm|
+              if ! comm.test('dpkg -l | grep libpq-dev')
+                machine.env.ui.info('Installing PostgreSQL headers')
+                comm.sudo('apt-get install -y libpq-dev')
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ventriloquist/cap/debian/phantomjs_install.rb

@@ -0,0 +1,24 @@
+module VagrantPlugins
+  module Ventriloquist
+    module Cap
+      module Debian
+        module PhantomjsInstall
+          def self.phantomjs_install(machine, version)
+            return if machine.communicate.test('which phantomjs > /dev/null')
+
+            src        = "https://phantomjs.googlecode.com/files/phantomjs-#{version}-linux-x86_64.tar.bz2"
+            executable = "/usr/local/share/phantomjs-#{version}-linux-x86_64/bin/phantomjs"
+
+            machine.env.ui.info("Installing phantomjs #{version}")
+            machine.communicate.tap do |comm|
+              comm.sudo('apt-get install -y fontconfig libfreetype6 curl -y -q')
+              # TODO: Use download + untar capability
+              comm.execute("cd /usr/local/share && curl #{src} | sudo tar xjfv -")
+              comm.sudo("ln -s #{executable} /usr/local/bin/phantomjs")
+            end
+          end
+        end
+      end
+    end
+  end
+end