boxgrinder-esx-delivery-plugin 0.1

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Sergio Rubio <rubiojr@frameos.org>
+
+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,52 @@
+# Boxgrinder ESX Delivery Plugin 
+
+Deliver appliances to VMWare ESX hypervisors 
+
+# Pre-requisites
+
+* Boxgrinder
+* VMWare ESX/ESXi hypervisor with SSH service enabled
+
+# Install 
+
+    $ gem install --no-ri --no-rdoc boxgrinder-esx-delivery-plugin
+
+# Usage
+    
+    $ boxgrinder-build -l esx-delivery-plugin \
+                       -p vmware --platform-config type:personal,thin_disk:true \
+                       -d esx --delivery-config esx_host:esx-test-host,esx_user:root,esx_password:secret \
+                       my-appliance.appl
+
+Boxgrinder will build the appliance, convert the appliance disk image to
+a suitable VMDK variant and the resulting VMDK will be uploaded to the ESX host via SSH
+and used to creat a virtual machine in that ESX host.
+
+
+#ESX delivery plugin configuration parameters
+
+The ESX Boxgrinder delivery plugin accepts the following list of config parameters:
+
+**esx_host:** the ESX hostname/ipaddress. Default is 127.0.0.1.
+
+**esx_user:** the ESX user to use. Default is root.
+
+**esx_password:** the ESX password to use. Default is secret.
+
+**datastore:** the ESX datastore to use. Default is datastore1.
+
+**name:** the target virtual machine name. Default is Virtual Appliance name.
+
+**memory:** the amount of RAM the appliance will have. Default is 512 MB.
+
+**cpu:** the number of CPUs the appliance will have. Default 1.
+
+All the config parameters have default values. Use the **--delivery-config** Boxgrinder parameter to configure the appliance upload to fit your needs.
+
+Make sure you define at lease **esx_host, esx_user and esx_password** parametes to fit your needs.
+
+# Copyright
+
+Copyright (c) 2011 Sergio Rubio. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,30 @@
+require 'rubygems'
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.version = "0.1"
+  gem.name = "boxgrinder-esx-delivery-plugin"
+  gem.homepage = "http://github.com/rubiojr/boxgrinder-esx-delivery-plugin"
+  gem.license = "MIT"
+  gem.summary = %Q{Deliver Boxgrider appliances to VMWare ESX/ESXi}
+  gem.description = %Q{Deliver Boxgrider appliances to VMWare ESX/ESXi}
+  gem.email = "rubiojr@frameos.org"
+  gem.authors = ["Sergio Rubio"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  gem.add_runtime_dependency 'esx'
+  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :build
+

data/lib/esx-delivery-plugin.rb

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'esx'
+require 'boxgrinder-build/plugins/base-plugin'
+
+module BoxGrinder
+  class ESXDelivery < BasePlugin
+    def validate
+      set_default_config_value('datastore', 'datastore1')
+      set_default_config_value('name', @appliance_config.name)
+      set_default_config_value('esx_user', 'root')
+      set_default_config_value('esx_password', '')
+      set_default_config_value('esx_host', '127.0.0.1')
+      set_default_config_value('cpu', '1')
+      set_default_config_value('guest_id', 'otherGuest')
+      set_default_config_value('memory', '512')
+      set_default_config_value('power_on', 'yes')
+    end
+
+    def execute
+      @log.info "Uploading #{@appliance_config.name} to ESX host #{@plugin_config['esx_host']}..."
+
+      begin
+        #TODO move to a block
+        create_vm(@previous_deliverables[:disk])
+        @log.info "Appliance #{@appliance_config.name} uploaded."
+      rescue => e
+        @log.error e
+        @log.error "An error occurred while uploading files."
+      end
+    end
+    
+    def create_vm(disk_file)
+      host = ESX::Host.connect @plugin_config['esx_host'], @plugin_config['esx_user'], @plugin_config['esx_password']
+      datastore = @plugin_config['datastore']
+      memory = @plugin_config['memory']
+      name = @appliance_config.name
+      guest_id = @plugin_config['otherGuest']
+      @log.info "Creating VM using #{File.basename(disk_file)}..."
+
+      @log.info "Uploading and converting disk..."
+      @log.debug "Creating remote dir /vmfs/volumes/#{datastore}/#{name}"
+      host.remote_command "mkdir /vmfs/volumes/#{datastore}/#{name}"
+      host.import_disk disk_file, "/vmfs/volumes/#{datastore}/#{name}/#{name}.vmdk"
+      vm = host.create_vm :vm_name => name,
+                          :disk_file => "#{name}/#{name}.vmdk",
+                          :datastore => datastore, :disk_type => :flat, :memory => memory,
+                          :guest_id => guest_id
+      vm.power_on
+    end
+
+  end
+end
+
+plugin :class => BoxGrinder::ESXDelivery, :type => :delivery, :name => :esx, :full_name  => "Deliver the appliance to an ESX/ESXi host"

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: boxgrinder-esx-delivery-plugin
+version: !ruby/object:Gem::Version
+  version: '0.1'
+  prerelease: 
+platform: ruby
+authors:
+- Sergio Rubio
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: esx
+  requirement: &11398420 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *11398420
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &11397460 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>'
+      - !ruby/object:Gem::Version
+        version: 1.2.3
+  type: :development
+  prerelease: false
+  version_requirements: *11397460
+description: Deliver Boxgrider appliances to VMWare ESX/ESXi
+email: rubiojr@frameos.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/esx-delivery-plugin.rb
+homepage: http://github.com/rubiojr/boxgrinder-esx-delivery-plugin
+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: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Deliver Boxgrider appliances to VMWare ESX/ESXi
+test_files: []