vagrant-vultr_pro

Vagrant plugin that allows to use Vultr as provider.

For now, basic operations like vagrant up/halt/reload/destroy/provision are supported.

Installation

$ vagrant plugin install vagrant-vultr_pro

Usage

Create simple Vagrantfile:

Vagrant.configure(2) do |config|
  config.vm.provider :vultr do |vultr, override|
    override.ssh.private_key_path = '~/.ssh/id_rsa'
    override.vm.box = 'vultr'
    override.vm.box_url = 'https://github.com/p0deje/vagrant-vultr/raw/master/box/vultr.box'

    vultr.token = 'YOUR_TOKEN'  # You can also use VULTR_TOKEN environment variable
    vultr.region = 'Seattle'
    vultr.plan = '768 MB RAM,15 GB SSD,1.00 TB BW'

    # Use either OS name or Snapshot identifier
    vultr.os = 'Ubuntu 14.04 x64'
    vultr.snapshot = '524557af2439b'

    # Optional parameters
    vultr.label    = 'My Label'
    vultr.tag      = 'My Tag'
    vultr.hostname = 'myhostname'

    # New optional parameters
    vultr.timeout  = 300
    vultr.ssh_key  = 'vagrant'
    vultr.startup_script  = 'user'
  end
end

Now start vagrant box:

$ vagrant up --provider=vultr

Notes

You have to specify override.ssh.private_key_path. Public key will be uploaded to Vultr as "vagrant" SSH key and will be used when servers are created.
Currently, servers are created with "root" user.
If you hit API rate limit, you can set VULTR_RATE_LIMIT_INTERVAL_MS environment variable to introduce delay between API requests.

Build

First commit all modifications to git, and then upload gem to https://rubygems.org by command below:

$ rake release

If you have any mistake for uploaded gem, you can remove it from https://rubygems.org by command below:

$ gem yank vagrant-vultr_pro -v 0.2.0

Testing

First of all, add the box that is used for testing:

$ bundle exec rake box:add

Since the tests involve actual calls to Vultr, you have to provide a valid API token:

$ export VULTR_TOKEN="token"

Now you can run tests:

$ bundle exec rake cucumber

Note that Vultr is not very stable, so tests sometimes may fail due to timeout or 404 API requests.

In the end, remove the box:

$ bundle exec rake box:remove

Contributing

Fork the project.
Make your feature addition or bug fix.
Commit, do not mess with Rakefile, version, or history. If you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull.
Send me a pull request. Bonus points for topic branches.