vagrant-cloudstack 0.0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5d750f86b43aa8348d4e5c9687d83637b9b7997e
+  data.tar.gz: f0551d674a64b6478c4a6b44a5dca65010dae7bd
+SHA512:
+  metadata.gz: 8e442bbdbfa07e2ae3f44421e3a3191c05352f025c1b41e8a6270e650e51d1ad74ab37f3c200b1ff494bd8fe148bf2a3a7e87d22536e2956836e326cc1392889
+  data.tar.gz: d5ebb8c660995a2caa731bf48e953bf029dc5982994f48c48366f8643a6ce74efbef8ba00318d3f6617bc8b28aa085deb58f613af0ee22491858dda5630ebb32

data/.gitignore

@@ -0,0 +1,14 @@
+# OS-specific
+.DS_Store
+
+# Bundler/Rubygems
+*.gem
+.bundle
+pkg/*
+tags
+Gemfile.lock
+
+# Vagrant
+.vagrant
+Vagrantfile
+!example_box/Vagrantfile

data/.travis.yml

@@ -0,0 +1,10 @@
+language: ruby
+notifications:
+  email:
+    - carl.loa.odin@klarna.com
+before_install:
+  - sudo apt-get update -qq
+  - sudo apt-get install -qq -y bsdtar
+rvm:
+  - 1.9.3
+script: rake

data/CHANGELOG.md

@@ -0,0 +1,47 @@
+# 0.0.2 (May 3, 2013)
+
+* Renamed module from CloudStack to Cloudstack
+* Renamed configurations to match Cloudstack
+  * domain -> domain_id
+  * offering_id -> service_offering_id
+* Added specc test for all provider specific configurations
+
+# 0.0.1 (April 17, 2013)
+
+* Forked into a Cloudstack plugin
+
+# 0.2.1 (April 16, 2013)
+
+* Got rid of extranneous references to old SSH settings.
+
+# 0.2.0 (April 16, 2013)
+
+* Add support for `vagrant ssh -c` [GH-42]
+* Ability to specify a timeout for waiting for instances to become ready. [GH-44]
+* Better error message if instance didn't become ready in time.
+* Connection can now be done using IAM profiles. [GH-41]
+
+# 0.1.3 (April 9, 2013)
+
+* The `AWS_ACCESS_KEY` and `AWS_SECRET_KEY` will be used if available
+  and no specific keys are set in the Vagrantfile. [GH-33]
+* Fix issues with SSH on VPCs, the correct IP is used. [GH-30]
+* Exclude the ".vagrant" directory from rsync.
+* Implement `:disabled` flag support for shared folders. [GH-29]
+* `aws.user_data` to specify user data on the instance. [GH-26]
+
+# 0.1.2 (March 22, 2013)
+
+* Choose the proper region when connecting to AWS. [GH-9]
+* Configurable SSH port. [GH-13]
+* Support other AWS-compatible API endpoints with `config.endpoint`
+  and `config.version`. [GH-6]
+* Disable strict host key checking on rsync so known hosts aren't an issue. [GH-7]
+
+# 0.1.1 (March 18, 2013)
+
+* Up fog dependency for Vagrant 1.1.1
+
+# 0.1.0 (March 14, 2013)
+
+* Initial release.

data/Gemfile

@@ -0,0 +1,10 @@
+source "https://rubygems.org"
+
+gemspec
+
+group :development do
+  # We depend on Vagrant for development, but we don't add it as a
+  # gem dependency because we expect to be installed within the
+  # Vagrant environment itself using `vagrant plugin`.
+  gem "vagrant", :git => "git://github.com/mitchellh/vagrant.git"
+end

data/LICENSE

@@ -0,0 +1,8 @@
+The MIT License (MIT)
+Copyright (c) 2013 Mitchell Hashimoto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 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.

data/README.md

@@ -0,0 +1,194 @@
+# Vagrant Cloudstack Provider
+
+[![Build Status](https://travis-ci.org/klarna/vagrant-cloudstack.png?branch=master)](https://travis-ci.org/klarna/vagrant-cloudstack)
+
+This is a fork of [mitchellh AWS Provider](https://github.com/mitchellh/vagrant-aws/).
+
+This is a [Vagrant](http://www.vagrantup.com) 1.2+ plugin that adds an [Cloudstack](http://cloudstack.apache.org)
+provider to Vagrant.
+
+**NOTE:** This plugin requires Vagrant 1.2+,
+
+## Features
+
+* SSH into the instances.
+* Provision the instances with any built-in Vagrant provisioner.
+* Minimal synced folder support via `rsync`.
+
+## Usage
+
+Install using standard Vagrant 1.1+ plugin installation methods. After
+installing, `vagrant up` and specify the `cloudstack` provider. An example is
+shown below.
+
+```
+$ vagrant plugin install vagrant-cloudstack
+...
+$ vagrant up --provider=cloudstack
+...
+```
+
+Of course prior to doing this, you'll need to obtain an Cloudstack-compatible
+box file for Vagrant.
+
+## Quick Start
+
+After installing the plugin (instructions above), the quickest way to get
+started is to actually use a dummy Cloudstack box and specify all the details
+manually within a `config.vm.provider` block. So first, add the dummy
+box using any name you want:
+
+```
+$ vagrant box add dummy https://github.com/klarna/vagrant-cloudstack/raw/master/dummy.box
+...
+```
+
+And then make a Vagrantfile that looks like the following, filling in
+your information where necessary.
+
+```
+Vagrant.configure("2") do |config|
+  config.vm.box = "dummy"
+
+  config.vm.provider :cloudstack do |cloudstack, override|
+    cloudstack.host = "cloudstack.local"
+    cloudstack.path = "/client/api"
+    cloudstack.port = "8080"
+    cloudstack.scheme = "http"
+    cloudstack.api_key = "AAAAAAAAAAAAAAAAAAA"
+    cloudstack.secret_key = "AAAAAAAAAAAAAAAAAAA"
+
+    cloudstack.template_id = "AAAAAAAAAAAAAAAAAAA"
+    cloudstack.service_offering_id = "AAAAAAAAAAAAAAAAAAA"
+    cloudstack.network_id = "AAAAAAAAAAAAAAAAAAA"
+    cloudstack.zone_id = "AAAAAAAAAAAAAAAAAAA"
+    cloudstack.project_id = "AAAAAAAAAAAAAAAAAAA"
+  end
+end
+```
+
+Note that normally a lot of this boilerplate is encoded within the box
+file, but the box file used for the quick start, the "dummy" box, has
+no preconfigured defaults.
+
+And then run `vagrant up --provider=cloudstack`.
+
+This will start an instance in Cloudstack. And assuming your template on Cloudstack is Vagrant compatible _(vagrant user with official vagrant pub key in authorized_keys)_ SSH and provisioning will work as well.
+
+## Box Format
+
+Every provider in Vagrant must introduce a custom box format. This
+provider introduces `cloudstack` boxes. You can view an example box in
+the [example_box/ directory](https://github.com/klarna/vagrant-cloudstack/tree/master/example_box).
+That directory also contains instructions on how to build a box.
+
+The box format is basically just the required `metadata.json` file
+along with a `Vagrantfile` that does default settings for the
+provider-specific configuration for this provider.
+
+## Configuration
+
+This provider exposes quite a few provider-specific configuration options:
+
+* `host` - Cloudstack api host
+* `path` - Cloudstack api path
+* `port` - Cloudstack api port
+* `scheme` - Cloudstack api scheme _(default: http)_
+* `api_key` - The api key for accessing Cloudstack
+* `secret_key` - The secret key for accessing Cloudstack
+* `instance_ready_timeout` - The number of seconds to wait for the instance
+  to become "ready" in Cloudstack. Defaults to 120 seconds.
+* `domain_id` - Domain id to launch the instance into
+* `network_id` - Network uuid that the instance should use
+* `project_id` - Project uuid that the instance should belong to 
+* `service_offering_id`- Service offering uuid to use for the instance
+* `template_id` - Template uuid to use for the instance
+* `zone_id` - Zone uuid to launch the instance into
+
+These can be set like typical provider-specific configuration:
+
+```ruby
+Vagrant.configure("2") do |config|
+  # ... other stuff
+
+  config.vm.provider :cloudstack do |cloudstack|
+    cloudstack.api_key = "foo"
+    cloudstack.secret_key = "bar"
+  end
+end
+```
+
+In addition to the above top-level configs, you can use the `region_config`
+method to specify region-specific overrides within your Vagrantfile. Note
+that the top-level `region` config must always be specified to choose which
+region you want to actually use, however. This looks like this:
+
+```ruby
+Vagrant.configure("2") do |config|
+  # ... other stuff
+
+  config.vm.provider :cloudstack do |cloudstack|
+    cloudstack.api_key = "foo"
+    cloudstack.secret_key = "bar"
+    cloudstack.domain = "internal"
+
+    # Simple domain config
+    cloudstack.domain_config "internal", :network_id => "AAAAAAAAAAAAAAAAAAA"
+
+    # More comprehensive region config
+    cloudstack.domain_config "internal" do |domain|
+      domain.network_id = "AAAAAAAAAAAAAAAAAAA"
+      domain.service_offering_id = "AAAAAAAAAAAAAAAAAAA"
+    end
+  end
+end
+```
+
+The domain-specific configurations will override the top-level
+configurations when that domain is used. They otherwise inherit
+the top-level configurations, as you would probably expect.
+
+## Networks
+
+Networking features in the form of `config.vm.network` are not
+supported with `vagrant-cloudstack`, currently. If any of these are
+specified, Vagrant will emit a warning, but will otherwise boot
+the Cloudstack machine.
+
+## Synced Folders
+
+There is minimal support for synced folders. Upon `vagrant up`,
+`vagrant reload`, and `vagrant provision`, the Cloudstack provider will use
+`rsync` (if available) to uni-directionally sync the folder to
+the remote machine over SSH.
+
+This is good enough for all built-in Vagrant provisioners (shell,
+chef, and puppet) to work!
+
+## Development
+
+To work on the `vagrant-cloudstack` plugin, clone this repository out, and use
+[Bundler](http://gembundler.com) to get the dependencies:
+
+```
+$ bundle
+```
+
+Once you have the dependencies, verify the unit tests pass with `rake`:
+
+```
+$ bundle exec rake
+```
+
+If those pass, you're ready to start developing the plugin. You can test
+the plugin without installing it into your Vagrant environment by just
+creating a `Vagrantfile` in the top level of this directory (it is gitignored)
+and add the following line to your `Vagrantfile` 
+```ruby
+Vagrant.require_plugin "vagrant-cloudstack"
+```
+Use bundler to execute Vagrant:
+
+```
+$ bundle exec vagrant up --provider=cloudstack
+```

data/Rakefile

@@ -0,0 +1,21 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'rspec/core/rake_task'
+
+# Immediately sync all stdout so that tools like buildbot can
+# immediately load in the output.
+$stdout.sync = true
+$stderr.sync = true
+
+# Change to the directory of this file.
+Dir.chdir(File.expand_path("../", __FILE__))
+
+# This installs the tasks that help with gem creation and
+# publishing.
+Bundler::GemHelper.install_tasks
+
+# Install the `spec` task so that we can run tests.
+RSpec::Core::RakeTask.new
+
+# Default task is to run the unit tests
+task :default => "spec"

data/example_box/README.md

@@ -0,0 +1,13 @@
+# Vagrant Cloudstack Example Box
+
+Vagrant providers each require a custom provider-specific box format.
+This folder shows the example contents of a box for the `aws` provider.
+To turn this into a box:
+
+```
+$ tar cvzf cloudstack.box ./metadata.json ./Vagrantfile
+```
+
+This box works by using Vagrant's built-in Vagrantfile merging to setup
+defaults for Cloudstack. These defaults can easily be overwritten by higher-level
+Vagrantfiles (such as project root Vagrantfiles).

data/example_box/metadata.json

@@ -0,0 +1,3 @@
+{
+    "provider": "cloudstack"
+}

data/lib/vagrant-cloudstack.rb

@@ -0,0 +1,18 @@
+require "pathname"
+
+require "vagrant-cloudstack/plugin"
+
+module VagrantPlugins
+  module Cloudstack
+    lib_path = Pathname.new(File.expand_path("../vagrant-cloudstack", __FILE__))
+    autoload :Action, lib_path.join("action")
+    autoload :Errors, lib_path.join("errors")
+
+    # This returns the path to the source of this plugin.
+    #
+    # @return [Pathname]
+    def self.source_root
+      @source_root ||= Pathname.new(File.expand_path("../../", __FILE__))
+    end
+  end
+end

data/lib/vagrant-cloudstack/action.rb

@@ -0,0 +1,121 @@
+require "pathname"
+
+require "vagrant/action/builder"
+
+module VagrantPlugins
+  module Cloudstack
+    module Action
+      # Include the built-in modules so we can use them as top-level things.
+      include Vagrant::Action::Builtin
+
+      # This action is called to terminate the remote machine.
+      def self.action_destroy
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use ConnectCloudstack
+          b.use TerminateInstance
+        end
+      end
+
+      # This action is called when `vagrant provision` is called.
+      def self.action_provision
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use Call, IsCreated do |env, b2|
+            if !env[:result]
+              b2.use MessageNotCreated
+              next
+            end
+
+            b2.use Provision
+            b2.use SyncFolders
+          end
+        end
+      end
+
+      # This action is called to read the SSH info of the machine. The
+      # resulting state is expected to be put into the `:machine_ssh_info`
+      # key.
+      def self.action_read_ssh_info
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use ConnectCloudstack
+          b.use ReadSSHInfo
+        end
+      end
+
+      # This action is called to read the state of the machine. The
+      # resulting state is expected to be put into the `:machine_state_id`
+      # key.
+      def self.action_read_state
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use ConnectCloudstack
+          b.use ReadState
+        end
+      end
+
+      # This action is called to SSH into the machine.
+      def self.action_ssh
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use Call, IsCreated do |env, b2|
+            if !env[:result]
+              b2.use MessageNotCreated
+              next
+            end
+
+            b2.use SSHExec
+          end
+        end
+      end
+
+      def self.action_ssh_run
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use Call, IsCreated do |env, b2|
+            if !env[:result]
+              b2.use MessageNotCreated
+              next
+            end
+
+            b2.use SSHRun
+          end
+        end
+      end
+
+      # This action is called to bring the box up from nothing.
+      def self.action_up
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use ConnectCloudstack
+          b.use Call, IsCreated do |env, b2|
+            if env[:result]
+              b2.use MessageAlreadyCreated
+              next
+            end
+
+            b2.use TimedProvision
+            b2.use SyncFolders
+            b2.use WarnNetworks
+            b2.use RunInstance
+          end
+        end
+      end
+
+      # The autoload farm
+      action_root = Pathname.new(File.expand_path("../action", __FILE__))
+      autoload :ConnectCloudstack, action_root.join("connect_cloudstack")
+      autoload :IsCreated, action_root.join("is_created")
+      autoload :MessageAlreadyCreated, action_root.join("message_already_created")
+      autoload :MessageNotCreated, action_root.join("message_not_created")
+      autoload :ReadSSHInfo, action_root.join("read_ssh_info")
+      autoload :ReadState, action_root.join("read_state")
+      autoload :RunInstance, action_root.join("run_instance")
+      autoload :SyncFolders, action_root.join("sync_folders")
+      autoload :TimedProvision, action_root.join("timed_provision")
+      autoload :WarnNetworks, action_root.join("warn_networks")
+      autoload :TerminateInstance, action_root.join("terminate_instance")
+    end
+  end
+end