vcloud-net_launcher 0.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+/Gemfile.lock
+results.html

data/Gemfile

@@ -0,0 +1,9 @@
+source 'http://rubygems.org'
+
+gemspec
+
+if ENV['VCLOUD_CORE_DEV_MASTER']
+  gem 'vcloud-core', :git => 'git@github.com:alphagov/vcloud-core.git', :branch => 'master'
+elsif ENV['VCLOUD_CORE_DEV_LOCAL']
+  gem 'vcloud-core', :path => '../vcloud-core'
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 HM Government (Government Digital Service)
+
+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,104 @@
+vCloud Net Launcher
+===================
+
+A tool that takes a YAML configuration file describing vCloud networks and configures each of them.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'vcloud-net_launcher'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install vcloud-net_launcher
+
+## Usage
+
+vCloud-tools uses Fog.
+
+To use it you need a `.fog` file in your home directory.
+
+For example:
+
+    test:
+      vcloud_director_username: 'username@org_name'
+      vcloud_director_password: 'password'
+      vcloud_director_host: 'host.api.example.com'
+
+Unfortunately current usage of fog requires the password in this file. Multiple sets of credentials can be specified in the fog file, using the following format:
+
+    test:
+      vcloud_director_username: 'username@org_name'
+      vcloud_director_password: 'password'
+      vcloud_director_host: 'host.api.example.com'
+
+    test2:
+      vcloud_director_username: 'username@org_name'
+      vcloud_director_password: 'password'
+      vcloud_director_host: 'host.api.vendor.net'
+
+You can then pass the `FOG_CREDENTIAL` environment variable at the start of your command. The value of the `FOG_CREDENTIAL` environment variable is the name of the credential set in your fog file which you wish to use.  For instance:
+
+    FOG_CREDENTIAL=test2 vcloud-net-launch node.yaml
+
+An example configuration file is located in [examples/vcloud-net-launch][example_yaml]
+
+
+##Supports
+
+* Configuration of multiple networks
+* Supports natRouted and isolated network types
+* Accepts multiple ip address ranges
+* Defaults
+  * IsShared : false
+  * IpScope -> IsEnabled : true
+  * IpScope -> IsInherited : false
+
+Limitations
+
+* Not currently reentrant - if the process errors part of the way through, the previously applied network config
+will need to be removed from the file before it is corrected and run again.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## Other settings
+
+vCloud Net Launcher uses vCloud Core. If you want to use the latest version of vCloud Core, or a local version, you can export some variables. See the Gemfile for details.
+
+## Testing
+
+Default target: `bundle exec rake` runs the integration tests.
+
+You need access to a suitable vCloud Director organization to run the
+integration tests. It is not necessarily safe to run them against an existing
+environment, unless care is taken with the entities being tested.
+
+The easiest thing to do is create a local shell script called
+`vcloud_env.sh` and set the contents:
+
+    export FOG\_CREDENTIAL=test
+    export VCLOUD\_VDC\_NAME="Name of the VDC"
+    export VCLOUD\_CATALOG\_NAME="catalog-name"
+    export VCLOUD\_TEMPLATE\_NAME="name-of-template"
+    export VCLOUD\_NETWORK1\_NAME="name-of-primary-network"
+    export VCLOUD\_NETWORK2\_NAME="name-of-secondary-network"
+    export VCLOUD\_NETWORK1\_IP="ip-on-primary-network"
+    export VCLOUD\_NETWORK2\_IP="ip-on-secondary-network"
+    export VCLOUD\_TEST\_STORAGE\_PROFILE="storage-profile-name"
+    export VCLOUD\_EDGE\_GATEWAY="name-of-edge-gateway-in-vdc"
+
+Then run this before you run the integration tests.
+
+[example_yaml]: ../examples/vcloud-net-launch/
+

data/Rakefile

@@ -0,0 +1,29 @@
+require 'cucumber/rake/task'
+require 'rspec/core/rake_task'
+
+CUKE_RESULTS = 'results.html'
+
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format html -o #{CUKE_RESULTS} --format pretty --no-source -x"
+  t.fork = false
+end
+
+RSpec::Core::RakeTask.new(:spec) do |task|
+  # Set a bogus Fog credential, otherwise it's possible for the unit
+  # tests to accidentially run (and succeed against!) an actual 
+  # environment, if Fog connection is not stubbed correctly.
+  ENV['FOG_CREDENTIAL'] = 'random_nonsense_owiejfoweijf'
+  task.pattern = FileList['spec/vcloud/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new('integration') do |t|
+  t.pattern = FileList['spec/integration/**/*_spec.rb']
+end
+
+task :default => [:integration]
+
+require "gem_publisher"
+task :publish_gem do |t|
+  gem = GemPublisher.publish_if_updated("vcloud-net_launcher.gemspec", :rubygems)
+  puts "Published #{gem}" if gem
+end

data/bin/vcloud-net-launch

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'bundler/setup'
+require 'optparse'
+require 'methadone'
+
+require 'vcloud/net_launcher'
+
+class App
+  include Methadone::Main
+  include Methadone::CLILogging
+  include Vcloud
+
+  main do |net_config_file|
+    NetLauncher::NetLaunch.new.run(net_config_file, options)
+  end
+
+  on("-m", "--mock", "Fog Mock mode enabled")
+
+  arg :net_config_file
+
+  examples_dir = File.absolute_path(
+    File.join(
+      File.dirname(__FILE__),
+      "..",
+      "examples",
+      File.basename(__FILE__),
+  ))
+
+  description "
+  vcloud-net-launch takes a configuration describing a vCloud network,
+  and tries to make it a reality.
+
+  See https://github.com/alphagov/vcloud-tools for more info
+
+  Example configuration files can be found in:
+    #{examples_dir}
+  "
+
+  version Vcloud::NetLauncher::VERSION
+
+  go!
+end

data/examples/.fog-example.fog

@@ -0,0 +1,15 @@
+p1-production:
+  vcloud_director_username: '<username_from_top_right_of_skyscape_flash_ui>@<org_id_from_url_in_skyscape_flash_ui>'
+  vcloud_director_password: '<your_skyscape_password>'
+  vcloud_director_host: 'vcd.portal.skyscapecloud.com'
+
+# You can extract this information by logging into skyscape portal
+performance-platform-production:
+  vcloud_director_username: '<xxx.x.xxxxxx>@<x-x-xx-xxxxxx>'
+  vcloud_director_password: '<your_skyscape_password>'
+  vcloud_director_host: 'vcd.portal.skyscapecloud.com'
+
+carrenza-preview:
+  vcloud_director_username: '<email>@<org_id>'
+  vcloud_director_password: ''
+  vcloud_director_host: 'myvdc.carrenza.net'

data/examples/vcloud-net-launch/example-config.yaml

@@ -0,0 +1,41 @@
+# This example creates two orgVdcNetworks - one natRouted, the other isolated
+#
+# dns settings and ip_ranges are optional
+#
+# example-net-isolated-shared has is_shared set, which means that it will be
+# available across all vDCs in the org (though is 'owned' by 'Our vDC').
+#
+---
+org_vdc_networks:
+
+- name: example-net-routed-1
+  description: "Frontend example network" 
+  vdc_name: 'Our vDC'
+  fence_mode: natRouted
+  edge_gateway: Gateway-FRONTEND
+  netmask: 255.255.255.0
+  gateway: 192.0.2.1
+  dns1: 8.8.8.8
+  dns2: 8.8.4.4
+  dns_suffix: testing.example.com
+  ip_ranges:
+    - start_address: 192.0.2.11
+      end_address: 192.0.2.40
+    - start_address: 192.0.2.101
+      end_address: 192.0.2.140
+
+- name: example-net-isolated-shared
+  vdc_name: 'Our vDC'
+  fence_mode: isolated
+  is_shared: true
+  netmask: 255.255.255.0
+  gateway: 198.51.100.1
+  dns1: 8.8.8.8
+  dns2: 8.8.4.4
+  dns_suffix: testing.example.com
+  ip_ranges:
+    - start_address: 198.51.100.11
+      end_address: 198.51.100.40
+    - start_address: 198.51.100.101
+      end_address: 198.51.100.140
+

data/features/step_definitions/vcloud-launch_steps.rb

@@ -0,0 +1,3 @@
+Then(/^the banner should document that this app takes (\d+) argument$/) do |arg1|
+   pending # express the regexp above with the code you wish you had
+end

data/features/support/env.rb

@@ -0,0 +1,16 @@
+require 'aruba/cucumber'
+require 'methadone/cucumber'
+
+ENV['PATH'] = "#{File.expand_path(File.dirname(__FILE__) + '/../../bin')}#{File::PATH_SEPARATOR}#{ENV['PATH']}"
+LIB_DIR = File.join(File.expand_path(File.dirname(__FILE__)),'..','..','lib')
+
+Before do
+  # Using "announce" causes massive warnings on 1.9.2
+  @puts = true
+  @original_rubylib = ENV['RUBYLIB']
+  ENV['RUBYLIB'] = LIB_DIR + File::PATH_SEPARATOR + ENV['RUBYLIB'].to_s
+end
+
+After do
+  ENV['RUBYLIB'] = @original_rubylib
+end

data/features/vcloud-net-launch.feature

@@ -0,0 +1,15 @@
+Feature: "vcloud-net-launch" works as a useful command-line tool
+  In order to use "vcloud-net-launch" from the CLI
+  I want to have it behave like a typical Unix tool
+  So I don't get surpised
+
+  Scenario: Common arguments work
+    When I get help for "vcloud-net-launch"
+    Then the exit status should be 0
+    And the banner should be present
+    And the banner should document that this app takes options
+    And the following options should be documented:
+      |--version|
+      |--mock|
+    And the banner should document that this app's arguments are:
+      |net_config_file|

data/jenkins.sh

@@ -0,0 +1,13 @@
+#!/bin/bash -x
+set -e
+bundle install --path "${HOME}/bundles/${JOB_NAME}"
+# commented out for now as there are no unit tests
+# and rake aefault is currently integration test
+# bundle exec rake
+
+./scripts/generate_fog_conf_file.sh
+export FOG_RC=fog_integration_test.config
+bundle exec rake integration
+rm fog_integration_test.config
+
+bundle exec rake publish_gem

data/jenkins_integration_tests.sh

@@ -0,0 +1,8 @@
+#!/bin/bash -x
+set -e
+bundle install --path "${HOME}/bundles/${JOB_NAME}"
+
+./scripts/generate_fog_conf_file.sh
+export FOG_RC=fog_integration_test.config
+bundle exec rake integration
+rm fog_integration_test.config

data/lib/vcloud/net_launcher/net_launch.rb

@@ -0,0 +1,31 @@
+require 'fog'
+
+module Vcloud
+  module NetLauncher
+    class NetLaunch
+
+      def initialize
+        @config_loader = Vcloud::Core::ConfigLoader.new
+      end
+
+      def run(config_file = nil, options = {})
+        config = @config_loader.load_config(config_file)
+
+        if options[:mock] || ENV['FOG_MOCK']
+          ::Fog.mock!
+        end
+
+        config[:org_vdc_networks].each do |net_config|
+          net_config[:fence_mode] ||= 'isolated'
+          Vcloud::NetLauncher.logger.info("Provisioning orgVdcNetwork #{net_config[:name]}.")
+          begin
+            net = Vcloud::Core::OrgVdcNetwork.provision(net_config)
+          rescue RuntimeError => e
+            Vcloud::NetLauncher.logger.error("Could not provision orgVdcNetwork: #{e.message}")
+            raise
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vcloud/net_launcher/version.rb

@@ -0,0 +1,5 @@
+module Vcloud
+  module NetLauncher
+    VERSION = '0.0.1'
+  end
+end

data/lib/vcloud/net_launcher.rb

@@ -0,0 +1,24 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'json'
+require 'yaml'
+require 'csv'
+require 'open3'
+require 'pp'
+
+require 'vcloud/net_launcher/version'
+
+require 'vcloud/fog'
+require 'vcloud/core'
+
+require 'vcloud/net_launcher/net_launch'
+
+module Vcloud
+  module NetLauncher
+
+    def self.logger
+      @logger ||= Logger.new(STDOUT)
+    end
+
+  end
+end

data/scripts/basic.erb

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+(
+echo "============================================================"
+echo "in ${1}:"
+echo "vapp_name: <%= vapp_name -%>"
+echo "role: <%= vars[:role] -%>"
+echo "environment: <%= vars[:environment] -%>"
+echo
+env 
+) >> /PREAMBLE_OUT
+
+

data/scripts/generate_fog_conf_file.sh

@@ -0,0 +1,6 @@
+cat <<EOF >fog_integration_test.config
+default:
+    vcloud_director_username: '$API_USERNAME'
+    vcloud_director_password: '$API_PASSWORD'
+    vcloud_director_host: '$API_HOST'
+EOF

data/spec/erb_helper.rb

@@ -0,0 +1,11 @@
+class ErbHelper
+  def self.convert_erb_template_to_yaml test_namespace, input_erb_config
+    input_erb_config = input_erb_config
+    e = ERB.new(File.open(input_erb_config).read)
+    output_yaml_config = File.join(File.dirname(input_erb_config), "output_#{Time.now.strftime('%s')}.yaml")
+    File.open(output_yaml_config, 'w') { |f|
+      f.write e.result(OpenStruct.new(test_namespace).instance_eval { binding })
+    }
+    output_yaml_config
+  end
+end

data/spec/integration/net_launcher/data/minimum_data_setup.yaml.erb

@@ -0,0 +1,9 @@
+---
+org_vdc_networks:
+
+- name: <%= network_name %>
+  vdc_name: <%= vdc_name %>
+  fence_mode: <%= fence_mode %>
+  netmask: <%= netmask %>
+  gateway: <%= gateway %>
+  edge_gateway: <%= edgeGateway %>

data/spec/integration/net_launcher/org_vdc_network_spec.rb

@@ -0,0 +1,151 @@
+require 'spec_helper'
+require 'pp'
+
+describe Vcloud::Core::OrgVdcNetwork do
+
+  context "natRouted network" do
+
+    before(:all) do
+      test_data = define_test_data
+      @config = {
+        :name => test_data[:name],
+        :description => "Integration Test network #{@name}",
+        :vdc_name => test_data[:vdc_name],
+        :fence_mode => 'natRouted',
+        :edge_gateway => test_data[:edge_gateway_name],
+        :gateway => '10.88.11.1',
+        :netmask => '255.255.255.0',
+        :dns1 => '8.8.8.8',
+        :dns2 => '8.8.4.4',
+        :ip_ranges => [
+            { :start_address => '10.88.11.100',
+              :end_address   => '10.88.11.150' },
+            { :start_address => '10.88.11.200',
+              :end_address   => '10.88.11.250' },
+          ],
+      }
+      @net = Vcloud::Core::OrgVdcNetwork.provision(@config)
+    end
+
+    it 'should be an OrgVdcNetwork' do
+      expect(@net.class).to be(Vcloud::Core::OrgVdcNetwork)
+    end
+
+    it 'should have an id' do
+      expect(@net.id).to match(/^[0-9a-f-]+$/)
+    end
+
+    it 'should have a name' do
+      expect(@net.name) == @config[:name]
+    end
+
+    it 'should have a :gateway attribute' do
+      expect(@net.vcloud_attributes[:gateway]) == @config[:gateway]
+    end
+
+    it 'should have a :netmask attribute' do
+      expect(@net.vcloud_attributes[:gateway]) == @config[:netmask]
+    end
+
+    it 'should have a :dns1 attribute' do
+      expect(@net.vcloud_attributes[:dns1]) == @config[:dns1]
+    end
+
+    it 'should have a :dns2 attribute' do
+      expect(@net.vcloud_attributes[:dns2]) == @config[:dns2]
+    end
+
+    it 'should have an :ip_ranges attribute' do
+      expect(@net.vcloud_attributes[:ip_ranges]) == [
+        {:start_address=>"10.88.11.200", :end_address=>"10.88.11.250"},
+        {:start_address=>"10.88.11.100", :end_address=>"10.88.11.150"}
+      ]
+    end
+
+    after(:all) do
+      unless ENV['VCLOUD_TOOLS_RSPEC_NO_DELETE_ORG_VDC_NETWORK']
+        Vcloud::Fog::ServiceInterface.new.delete_network(@net.id) if @net
+      end
+    end
+
+  end
+
+  context "isolated network" do
+
+    before(:all) do
+      test_data = define_test_data
+      @config = {
+        :name => test_data[:name],
+        :description => "Integration Test network #{@name}",
+        :vdc_name => test_data[:vdc_name],
+        :fence_mode => 'isolated',
+        :gateway => '10.88.11.1',
+        :netmask => '255.255.255.0',
+        :dns1 => '8.8.8.8',
+        :dns2 => '8.8.4.4',
+        :ip_ranges => [
+            { :start_address => '10.88.11.100',
+              :end_address   => '10.88.11.150' },
+            { :start_address => '10.88.11.200',
+              :end_address   => '10.88.11.250' },
+          ],
+      }
+      @net = Vcloud::Core::OrgVdcNetwork.provision(@config)
+    end
+
+    it 'should be an OrgVdcNetwork' do
+      expect(@net.class).to be(Vcloud::Core::OrgVdcNetwork)
+    end
+
+    it 'should have an id' do
+      expect(@net.id).to match(/^[0-9a-f-]+$/)
+    end
+
+    it 'should have a name' do
+      expect(@net.name) == @config[:name]
+    end
+
+    it 'should have a :gateway attribute' do
+      expect(@net.vcloud_attributes[:gateway]) == @config[:gateway]
+    end
+
+    it 'should have a :netmask attribute' do
+      expect(@net.vcloud_attributes[:gateway]) == @config[:netmask]
+    end
+
+    it 'should have a :dns1 attribute' do
+      expect(@net.vcloud_attributes[:dns1]) == @config[:dns1]
+    end
+
+    it 'should have a :dns2 attribute' do
+      expect(@net.vcloud_attributes[:dns2]) == @config[:dns2]
+    end
+
+    it 'should have an :ip_ranges attribute' do
+      expect(@net.vcloud_attributes[:ip_ranges]) == [
+        {:start_address=>"10.88.11.200", :end_address=>"10.88.11.250"},
+        {:start_address=>"10.88.11.100", :end_address=>"10.88.11.150"}
+      ]
+    end
+
+    after(:all) do
+      unless ENV['VCLOUD_TOOLS_RSPEC_NO_DELETE_ORG_VDC_NETWORK']
+        Vcloud::Fog::ServiceInterface.new.delete_network(@net.id) if @net
+      end
+    end
+
+  end
+
+  def define_test_data
+    [ 'VCLOUD_VDC_NAME', 'VCLOUD_EDGE_GATEWAY' ].each do |n|
+      raise "Need #{n} set" unless ENV[n]
+    end
+    {
+      :name => "orgVdcNetwork-vcloud-tools-tests #{Time.now.strftime('%s')}",
+      :vdc_name => ENV['VCLOUD_VDC_NAME'],
+      :edge_gateway_name => ENV['VCLOUD_EDGE_GATEWAY'],
+    }
+  end
+
+end
+

data/spec/integration/net_launcher/vcloud_net_launcher_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+require 'pp'
+require 'erb'
+
+module Vcloud
+  module NetLauncher
+    describe NetLaunch do
+
+      context 'with minimum input setup' do
+
+        it 'should create an isolated network' do
+          test_data = default_test_data('isolated')
+          @minimum_data_yaml = generate_data_file(test_data)
+
+          Vcloud::NetLauncher::NetLaunch.new.run(@minimum_data_yaml)
+
+          @found_networks = find_network(test_data[:network_name])
+          @found_networks.length.should == 1
+          provisioned_network = @found_networks[0]
+          provisioned_network[:gateway].should == test_data[:gateway]
+          provisioned_network[:netmask].should == test_data[:netmask]
+          provisioned_network[:isLinked].should == 'false'
+        end
+
+        it 'should create an nat routed network' do
+          test_data = default_test_data('natRouted')
+          test_data[:edgeGateway] =  ENV['VCLOUD_EDGE_GATEWAY']  #only needed for natRouted networks
+          @minimum_data_yaml = generate_data_file(test_data)
+
+          Vcloud::NetLauncher::NetLaunch.new.run(@minimum_data_yaml)
+
+          @found_networks = find_network(test_data[:network_name])
+
+          @found_networks.length.should == 1
+          provisioned_network = @found_networks[0]
+          provisioned_network[:gateway].should == test_data[:gateway]
+          provisioned_network[:netmask].should == test_data[:netmask]
+          provisioned_network[:isLinked].should == 'true'
+        end
+
+        after(:each) do
+          unless ENV['VCLOUD_TOOLS_RSPEC_NO_DELETE_VAPP']
+            File.delete @minimum_data_yaml
+            fog_interface = Vcloud::Fog::ServiceInterface.new
+            provisioned_network_id = @found_networks[0][:href].split('/').last
+            fog_interface.delete_network(provisioned_network_id).should == true
+          end
+        end
+
+      end
+
+      def default_test_data(type)
+        {
+          network_name: "vapp-vcloud-tools-tests-#{Time.now.strftime('%s')}",
+          vdc_name: ENV['VCLOUD_VDC_NAME'],
+          fence_mode: type,
+          netmask: '255.255.255.0',
+          gateway: '192.0.2.1',
+        }
+      end
+
+      def find_network(network_name)
+        query = Vcloud::QueryRunner.new()
+        query.run('orgNetwork', :filter => "name==#{network_name}")
+      end
+
+      def generate_data_file(test_data)
+        minimum_data_erb = File.join(File.dirname(__FILE__), 'data/minimum_data_setup.yaml.erb')
+        ErbHelper.convert_erb_template_to_yaml(test_data, minimum_data_erb)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'erb_helper'
+require 'bundler/setup'
+require 'vcloud/net_launcher'
+require 'support/stub_fog_interface.rb'

data/spec/support/stub_fog_interface.rb

@@ -0,0 +1,59 @@
+require 'ostruct'
+
+class StubFogInterface
+
+  def name
+    'Test vDC 1'
+  end
+
+  def vdc_object_by_name(vdc_name)
+    vdc = OpenStruct.new
+    vdc.name = 'test-vdc-1'
+    vdc
+  end
+
+  def template
+    { :href => '/vappTemplate-12345678-90ab-cdef-0123-4567890abcde' }
+  end
+
+  def find_networks(network_names, vdc_name)
+    [{
+      :name => 'org-vdc-1-net-1',
+      :href => '/org-vdc-1-net-1-id',
+    }]
+  end
+
+  def get_vapp(id)
+    { :name => 'test-vapp-1' }
+  end
+
+  def get_edge_gateway(id)
+    { 
+      :name => 'test-edgegw-1',
+      :href => "/#{id}",
+    }
+  end
+
+  def vdc(name)
+    { }
+  end
+
+  def post_instantiate_vapp_template(vdc, template, name, params)
+    {
+      :href => '/test-vapp-1-id',
+      :Children => {
+        :Vm => ['bogus vm data']
+      }
+    }
+  end
+
+  def get_vapp_by_vdc_and_name
+    { }
+  end
+
+  def template(catalog_name, name)
+    { :href => '/vappTemplate-12345678-90ab-cdef-0123-4567890abcde' }
+  end
+
+
+end

data/vcloud-net_launcher.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+
+lib = File.expand_path('../lib/', __FILE__)
+$LOAD_PATH.unshift lib unless $LOAD_PATH.include?(lib)
+
+require 'vcloud/net_launcher/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'vcloud-net_launcher'
+  s.version     = Vcloud::NetLauncher::VERSION
+  s.authors     = ['Anna Shipman']
+  s.email       = ['anna.shipman@digital.cabinet-office.gov.uk']
+  s.summary     = 'Tool to launch and configure vCloud networks'
+  s.description = 'Tool to launch and configure vCloud networks. Uses vcloud-core.'
+  s.homepage    = 'http://github.com/alphagov/vcloud-net_launcher'
+  s.license     = 'MIT'
+
+  s.files         = `git ls-files`.split($/)
+  s.executables   = s.files.grep(%r{^bin/}) {|f| File.basename(f)}
+  s.test_files    = s.files.grep(%r{^(test|spec|features)/})
+  s.require_paths = ['lib']
+
+  s.required_ruby_version = '>= 1.9.2'
+
+  s.add_runtime_dependency 'vcloud-core', '>= 0.0.9'
+  s.add_runtime_dependency 'methadone'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rspec', '~> 2.14.1'
+  s.add_development_dependency 'cucumber', '~> 1.3.10'
+  s.add_development_dependency 'gem_publisher', '1.2.0'
+end
+

metadata

@@ -0,0 +1,180 @@
+--- !ruby/object:Gem::Specification
+name: vcloud-net_launcher
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Anna Shipman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: vcloud-core
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.0.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.0.9
+- !ruby/object:Gem::Dependency
+  name: methadone
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.10
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.10
+- !ruby/object:Gem::Dependency
+  name: gem_publisher
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+description: Tool to launch and configure vCloud networks. Uses vcloud-core.
+email:
+- anna.shipman@digital.cabinet-office.gov.uk
+executables:
+- vcloud-net-launch
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/vcloud-net-launch
+- examples/.fog-example.fog
+- examples/vcloud-net-launch/example-config.yaml
+- features/step_definitions/vcloud-launch_steps.rb
+- features/support/env.rb
+- features/vcloud-net-launch.feature
+- jenkins.sh
+- jenkins_integration_tests.sh
+- lib/vcloud/net_launcher.rb
+- lib/vcloud/net_launcher/net_launch.rb
+- lib/vcloud/net_launcher/version.rb
+- scripts/basic.erb
+- scripts/generate_fog_conf_file.sh
+- spec/erb_helper.rb
+- spec/integration/net_launcher/data/minimum_data_setup.yaml.erb
+- spec/integration/net_launcher/org_vdc_network_spec.rb
+- spec/integration/net_launcher/vcloud_net_launcher_spec.rb
+- spec/spec_helper.rb
+- spec/support/stub_fog_interface.rb
+- vcloud-net_launcher.gemspec
+homepage: http://github.com/alphagov/vcloud-net_launcher
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -783879997107424928
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Tool to launch and configure vCloud networks
+test_files:
+- features/step_definitions/vcloud-launch_steps.rb
+- features/support/env.rb
+- features/vcloud-net-launch.feature
+- spec/erb_helper.rb
+- spec/integration/net_launcher/data/minimum_data_setup.yaml.erb
+- spec/integration/net_launcher/org_vdc_network_spec.rb
+- spec/integration/net_launcher/vcloud_net_launcher_spec.rb
+- spec/spec_helper.rb
+- spec/support/stub_fog_interface.rb