knife-vsphere 0.1.5 → 0.1.6

data/lib/chef/knife/BaseVsphereCommand.rb

@@ -1,111 +1,167 @@
-#
-# Author:: Ezra Pagel (<ezra@cpan.org>)
-# License:: Apache License, Version 2.0
-#
-
-require 'chef/knife'
-require 'rbvmomi'
-
-# Base class for vsphere knife commands
-class Chef
-  class Knife
-    class BaseVsphereCommand < Knife
-
-      deps do
-        require 'chef/knife/bootstrap'
-        Chef::Knife::Bootstrap.load_deps
-        require 'fog'
-        require 'socket'
-        require 'net/ssh/multi'
-        require 'readline'
-        require 'chef/json_compat'
-      end
-
-
-      def self.get_common_options
-
-      option :vsphere_user,
-      :short => "-u USERNAME",
-      :long => "--user USERNAME",
-      :description => "The username for the host"
-      
-      option :password,
-      :short => "-p PASSWORD",
-      :long => "--password PASSWORD",
-      :description => "The password for the host"
-
-      option :datacenter,
-      :short => "-d DATACENTER",
-      :long => "--datacenter DATACENTER",
-      :description => "The Datacenter to create the VM in"
-      
-      option :path,
-      :long => "--path SOAP_PATH",
-      :description => "The SOAP endpoint path",
-      :proc => Proc.new { |p| Chef::Config[:knife][:path] = p },
-      :default => "/sdk"
-
-      option :port,
-      :long => "--port PORT",
-      :description => "The VI SDK port number to use",
-      :proc => Proc.new { |p| Chef::Config[:knife][:port] = p },
-      :default => 443
-
-      option :use_ssl,
-      :long => "--ssl USE_SSL",
-      :description => "Whether to use SSL connection",
-      :default => true
-
-      option :insecure,
-      :short => "-i USE_INSECURE_SSL",
-      :long => "--insecure USE_INSECURE_SSL",
-      :description => "Determines whether SSL certificate verification is skipped",
-      :default => true
-      
-      end
-
-      def get_vim_connection
-        
-        conn_opts = {
-          :host => config[:host] || Chef::Config[:knife][:vsphere_host],
-          :path => config[:path],
-          :port => config[:port],
-          :use_ssl => config[:ssl],
-          :user => config[:vsphere_user] || Chef::Config[:knife][:vsphere_user],
-          :password => config[:password] || Chef::Config[:knife][:vsphere_pass],
-          :insecure => config[:insecure]
-        }
-
-        #    opt :insecure, "don't verify ssl certificate", :short => 'k', :default => (ENV['RBVMOMI_INSECURE'] == '1')
-        #    opt :debug, "Log SOAP messages", :short => 'd', :default => (ENV['RBVMOMI_DEBUG'] || false)
-
-        vim = RbVmomi::VIM.connect conn_opts
-        return vim
-      end
-
-      def get_folders(folder)
-        folder.childEntity.grep(RbVmomi::VIM::Folder) << folder
-      end
-
-      def find_all_in_folders(folder, type)
-        get_folders(folder).
-          collect { |f| f.childEntity.grep(type) }.
-          flatten
-      end
-
-      def find_in_folders(folder, type, name)
-        get_folders(folder).
-          collect { |f| f.childEntity.grep(type) }.
-          flatten.
-          find { |o| o.name == name }
-      end
-
-      def fatal_exit(msg)
-        ui.fatal(msg)
-        exit 1
-      end
-     
-
-    end
-  end
-end
+#
+# Author:: Ezra Pagel (<ezra@cpan.org>)
+# Contributor:: Jesse Campbell (<hikeit@gmail.com>)
+# License:: Apache License, Version 2.0
+#
+
+require 'chef/knife'
+require 'rbvmomi'
+
+# Base class for vsphere knife commands
+class Chef
+	class Knife
+		class BaseVsphereCommand < Knife
+
+			deps do
+				require 'chef/knife/bootstrap'
+				Chef::Knife::Bootstrap.load_deps
+				require 'fog'
+				require 'socket'
+				require 'net/ssh/multi'
+				require 'readline'
+				require 'chef/json_compat'
+			end
+
+
+			def self.get_common_options
+
+				option :vsphere_user,
+					:short => "-u USERNAME",
+					:long => "--user USERNAME",
+					:description => "The username for the host"
+
+				option :vsphere_pass,
+					:short => "-p PASSWORD",
+					:long => "--password PASSWORD",
+					:description => "The password for the host"
+
+				option :datacenter,
+					:short => "-d DATACENTER",
+					:long => "--datacenter DATACENTER",
+					:description => "The Datacenter to create the VM in"
+
+				option :path,
+					:long => "--path SOAP_PATH",
+					:description => "The SOAP endpoint path",
+					:proc => Proc.new { |p| Chef::Config[:knife][:path] = p },
+					:default => "/sdk"
+
+				option :port,
+					:long => "--port PORT",
+					:description => "The VI SDK port number to use",
+					:proc => Proc.new { |p| Chef::Config[:knife][:port] = p },
+					:default => 443
+
+				option :use_ssl,
+					:long => "--ssl USE_SSL",
+					:description => "Whether to use SSL connection",
+					:default => true
+
+				option :insecure,
+					:short => "-i USE_INSECURE_SSL",
+					:long => "--insecure USE_INSECURE_SSL",
+					:description => "Determines whether SSL certificate verification is skipped",
+					:default => true
+
+				option :folder,
+					:short => "-f FOLDER",
+					:long => "--folder FOLDER",
+					:description => "The folder to get VMs from",
+					:default => ''
+
+			end
+
+			def locate_config_value(key)
+				key = key.to_sym
+				Chef::Config[:knife][key] || config[key]
+			end
+
+			def get_vim_connection
+
+				conn_opts = {
+					:host => locate_config_value(:vsphere_host),
+					:path => config[:path],
+					:port => config[:port],
+					:use_ssl => config[:ssl],
+					:user => locate_config_value(:vsphere_user),
+					:password => locate_config_value(:vsphere_pass),
+					:insecure => config[:insecure]
+				}
+
+				#    opt :insecure, "don't verify ssl certificate", :short => 'k', :default => (ENV['RBVMOMI_INSECURE'] == '1')
+				#    opt :debug, "Log SOAP messages", :short => 'd', :default => (ENV['RBVMOMI_DEBUG'] || false)
+
+				vim = RbVmomi::VIM.connect conn_opts
+				config[:vim] = vim
+				return vim
+			end
+
+			def find_folder(folderName)
+				dcname = config[:vsphere_dc] || Chef::Config[:knife][:vsphere_dc]
+				dc = config[:vim].serviceInstance.find_datacenter(dcname) or abort "datacenter not found"
+				baseEntity = dc.vmFolder
+				entityArray = folderName.split('/')
+				entityArray.each do |entityArrItem|
+					if entityArrItem != ''
+						baseEntity = baseEntity.childEntity.grep(RbVmomi::VIM::Folder).find { |f| f.name == entityArrItem } or
+              abort "no such folder #{folderName} while looking for #{entityArrItem}"
+					end
+				end
+				baseEntity
+			end
+
+			def find_network(networkName)
+				dcname = config[:vsphere_dc] || Chef::Config[:knife][:vsphere_dc]
+				dc = config[:vim].serviceInstance.find_datacenter(dcname) or abort "datacenter not found"
+				baseEntity = dc.network
+				baseEntity.find { |f| f.name == networkName } or abort "no such network #{networkName}"
+			end
+
+			def find_pool(poolName)
+				dcname = config[:vsphere_dc] || Chef::Config[:knife][:vsphere_dc]
+				dc = config[:vim].serviceInstance.find_datacenter(dcname) or abort "datacenter not found"
+				baseEntity = dc.hostFolder
+				entityArray = poolName.split('/')
+				entityArray.each do |entityArrItem|
+					if entityArrItem != ''
+						if baseEntity.is_a? RbVmomi::VIM::Folder
+							baseEntity = baseEntity.childEntity.find { |f| f.name == entityArrItem } or
+                abort "no such pool #{poolName} while looking for #{entityArrItem}"
+						elsif baseEntity.is_a? RbVmomi::VIM::ClusterComputeResource
+							baseEntity = baseEntity.resourcePool.resourcePool.find { |f| f.name == entityArrItem } or
+                abort "no such pool #{poolName} while looking for #{entityArrItem}"
+						elsif baseEntity.is_a? RbVmomi::VIM::ResourcePool
+							baseEntity = baseEntity.resourcePool.find { |f| f.name == entityArrItem } or
+                abort "no such pool #{poolName} while looking for #{entityArrItem}"
+						else
+							abort "Unexpected Object type encountered #{baseEntity.type} while finding resourcePool"
+						end
+					end
+				end
+				baseEntity
+			end
+
+			def find_datastore(dsName)
+				dcname = config[:vsphere_dc] || Chef::Config[:knife][:vsphere_dc]
+				dc = config[:vim].serviceInstance.find_datacenter(dcname) or abort "datacenter not found"
+				baseEntity = dc.datastore
+				baseEntity.find { |f| f.info.name == dsName } or abort "no such datastore #{dsName}"
+			end
+
+
+			def find_all_in_folder(folder, type)
+				folder.childEntity.grep(type)
+			end
+
+			def find_in_folder(folder, type, name)
+				folder.childEntity.grep(type).find { |o| o.name == name }
+			end
+
+			def fatal_exit(msg)
+				ui.fatal(msg)
+				exit 1
+			end
+
+		end
+	end
+end

data/lib/chef/knife/vsphere_customization_list.rb

@@ -1,29 +1,29 @@
-#
-# Author:: Ezra Pagel (<ezra@cpan.org>)
-# License:: Apache License, Version 2.0
-#
-require 'chef/knife'
-require 'chef/knife/BaseVsphereCommand'
-
-# Lists all customization specifications in the configured datacenter
-class Chef::Knife::VsphereCustomizationList < Chef::Knife::BaseVsphereCommand
-
-  banner "knife vsphere customization list"
-
-  get_common_options
-  
-  def run
-
-    $stdout.sync = true
-    
-    vim = get_vim_connection
-
-    csm = vim.serviceContent.customizationSpecManager
-    csm.info.each do |c|
-      puts "#{ui.color("Customization Name", :cyan)}: #{c.name}"
-      
-    end
-
-  end
-end
-
+#
+# Author:: Ezra Pagel (<ezra@cpan.org>)
+# License:: Apache License, Version 2.0
+#
+require 'chef/knife'
+require 'chef/knife/BaseVsphereCommand'
+
+# Lists all customization specifications in the configured datacenter
+class Chef::Knife::VsphereCustomizationList < Chef::Knife::BaseVsphereCommand
+
+  banner "knife vsphere customization list"
+
+  get_common_options
+
+  def run
+
+    $stdout.sync = true
+
+    vim = get_vim_connection
+
+    csm = vim.serviceContent.customizationSpecManager
+    csm.info.each do |c|
+      puts "#{ui.color("Customization Name", :cyan)}: #{c.name}"
+
+    end
+
+  end
+end
+

data/lib/chef/knife/vsphere_template_list.rb

@@ -1,35 +1,32 @@
-#
-# Author:: Ezra Pagel (<ezra@cpan.org>)
-# License:: Apache License, Version 2.0
-#
-
-require 'chef/knife'
-require 'chef/knife/BaseVsphereCommand'
-
-# Lists all known VM templates in the configured datacenter
-class Chef::Knife::VsphereTemplateList < Chef::Knife::BaseVsphereCommand
-
-  banner "knife vsphere template list"
-
-  get_common_options
-  
-  def run
-
-    $stdout.sync = true
-    $stderr.sync = true
-
-    vim = get_vim_connection
-
-    dcname = config[:vsphere_dc] || Chef::Config[:knife][:vsphere_dc]
-    dc = vim.serviceInstance.find_datacenter(dcname) or abort "datacenter not found"
-    
-    vmFolders = get_folders(dc.vmFolder)
-
-    vms = find_all_in_folders(dc.vmFolder, RbVmomi::VIM::VirtualMachine).
-      select {|v| !v.config.nil? && v.config.template == true }
-    
-    vms.each do |vm|          
-      puts "#{ui.color("Template Name", :cyan)}: #{vm.name}"
-    end
-  end
-end
+#
+# Author:: Ezra Pagel (<ezra@cpan.org>)
+# License:: Apache License, Version 2.0
+#
+
+require 'chef/knife'
+require 'chef/knife/BaseVsphereCommand'
+
+# Lists all known VM templates in the configured datacenter
+class Chef::Knife::VsphereTemplateList < Chef::Knife::BaseVsphereCommand
+
+  banner "knife vsphere template list"
+
+  get_common_options
+  
+  def run
+
+    $stdout.sync = true
+    $stderr.sync = true
+
+    vim = get_vim_connection
+
+    baseFolder = find_folder(config[:folder]);
+
+    vms = find_all_in_folder(baseFolder, RbVmomi::VIM::VirtualMachine).
+      select {|v| !v.config.nil? && v.config.template == true }
+    
+    vms.each do |vm|          
+      puts "#{ui.color("Template Name", :cyan)}: #{vm.name}"
+    end
+  end
+end

data/lib/chef/knife/vsphere_vm_clone.rb

@@ -1,176 +1,360 @@
-#
-# Author:: Ezra Pagel (<ezra@cpan.org>)
-# License:: Apache License, Version 2.0
-#
-
-require 'chef/knife'
-require 'chef/knife/BaseVsphereCommand'
-require 'rbvmomi'
-require 'netaddr'
-
-# Clone an existing template into a new VM, optionally applying a customization specification.
-# 
-# usage:
-# knife vsphere vm clone NewNode UbuntuTemplate --cspec StaticSpec \
-#     --cips 192.168.0.99/24,192.168.1.99/24 \
-#     --chostname NODENAME --cdomain NODEDOMAIN
-class Chef::Knife::VsphereVmClone < Chef::Knife::BaseVsphereCommand
-
-  banner "knife vsphere vm clone VMNAME TEMPLATE (options)"
-
-  get_common_options
-
-  option :customization_spec,
-  :long => "--cspec CUST_SPEC",
-  :description => "The name of any customization specification to apply"
-
-  option :customization_ips,
-  :long => "--cips CUST_IPS",
-  :description => "Comma-delimited list of CIDR IPs for customization"
-
-  option :customization_hostname,
-  :long => "--chostname CUST_HOSTNAME",
-  :description => "Unqualified hostname for customization"
- 
-  option :customization_domain,
-  :long => "--cdomain CUST_DOMAIN",
-  :description => "Domain name for customization"
-
-  option :customization_tz,
-  :long => "--ctz CUST_TIMEZONE",
-  :description => "Timezone invalid 'Area/Location' format"
-
-  option :power,  
-  :long => "--start STARTVM",
-  :description => "Indicates whether to start the VM after a successful clone",
-  :default => true
-
-
-
-  def run
-  
-    $stdout.sync = true
-
-    vmname = @name_args[0]
-    if vmname.nil?
-      show_usage
-      fatal_exit("You must specify a virtual machine name")
-    end
-
-    template = @name_args[1]
-    if template.nil?
-      show_usage
-      fatal_exit("You must specify a template name")
-    end
-
-    vim = get_vim_connection
-
-    dcname = config[:vsphere_dc] || Chef::Config[:knife][:vsphere_dc]
-    dc = vim.serviceInstance.find_datacenter(dcname) or abort "datacenter not found"
-
-    hosts = find_all_in_folders(dc.hostFolder, RbVmomi::VIM::ComputeResource)
-    rp = hosts.first.resourcePool
-
-    src_vm = find_in_folders(dc.vmFolder, RbVmomi::VIM::VirtualMachine, template) or
-      abort "VM/Template not found"
-
-    rspec = RbVmomi::VIM.VirtualMachineRelocateSpec(:pool => rp)
-
-    
-    clone_spec = RbVmomi::VIM.VirtualMachineCloneSpec(:location => rspec,
-                                                      :powerOn => false,
-                                                      :template => false)
-
-    if config[:customization_spec]
-      csi = find_customization(vim, config[:customization_spec]) or
-        fatal_exit("failed to find customization specification named #{config[:customization_spec]}")
-
-      if csi.info.type != "Linux"
-        fatal_exit("Only Linux customization specifications are currently supported")
-      end
-
-      if config[:customization_ips]
-        csi.spec.nicSettingMap = config[:customization_ips].split(',').map { |i| generate_adapter_map(i) }
-      end
-
-      use_ident = !config[:customization_hostname].nil? || !config[:customization_domain].nil?
-
-      if use_ident
-        # TODO - verify that we're deploying a linux spec, at least warn
-        ident = RbVmomi::VIM.CustomizationLinuxPrep
-
-        if config[:customization_hostname]
-          ident.hostName = RbVmomi::VIM.CustomizationFixedName
-          ident.hostName.name = config[:customization_hostname]
-        else
-          ident.hostName = RbVmomi::VIM.CustomizationFixedName
-          ident.hostName.name = config[:customization_domain]
-        end
-        
-        if config[:customization_domain]
-          ident.domain = config[:customization_domain]
-        end
-        
-        csi.spec.identity = ident
-      end
-
-      clone_spec.customization = csi.spec
-
-    end
-
-    task = src_vm.CloneVM_Task(:folder => src_vm.parent, :name => vmname, :spec => clone_spec)
-    puts "Cloning template #{template} to new VM #{vmname}"
-    task.wait_for_completion
-    puts "Finished creating virtual machine #{vmname}"
-    
-    if config[:power]
-      vm = find_in_folders(dc.vmFolder, RbVmomi::VIM::VirtualMachine, vmname) or
-      fatal_exit("VM #{vmname} not found")
-      vm.PowerOnVM_Task.wait_for_completion
-      puts "Powered on virtual machine #{vmname}"
-    end
-        
-    
-  end
-  
-
-  # Retrieves a CustomizationSpecItem that matches the supplied name
-  # @param vim [Connection] VI Connection to use
-  # @param name [String] name of customization
-  # @return [RbVmomi::VIM::CustomizationSpecItem]
-  def find_customization(vim, name) 
-    csm = vim.serviceContent.customizationSpecManager
-    csm.GetCustomizationSpec(:name => name) 
-  end
-  
-  # Generates a CustomizationAdapterMapping (currently only single IPv4 address) object
-  # @param ip [String] Any static IP address to use, otherwise DHCP
-  # @param gw [String] If static, the gateway for the interface, otherwise network address + 1 will be used
-  # @return [RbVmomi::VIM::CustomizationIPSettings]
-  def generate_adapter_map (ip=nil, gw=nil, dns1=nil, dns2=nil, domain=nil)
-           
-    settings = RbVmomi::VIM.CustomizationIPSettings
-
-    if ip.nil?
-      settings.ip = RbVmomi::VIM::CustomizationDhcpIpGenerator
-    else
-      cidr_ip = NetAddr::CIDR.create(ip)
-      settings.ip = RbVmomi::VIM::CustomizationFixedIp(:ipAddress => cidr_ip.ip)
-      settings.subnetMask = cidr_ip.netmask_ext
-
-      # TODO - want to confirm gw/ip are in same subnet?
-      if gw.nil?
-        settings.gateway = [cidr_ip.network(:Objectify => true).next_ip]
-      else
-        gw_cidr = NetAddr::CIDR.create(gw)
-        settings.gateway = [gw_cidr.ip]
-      end
-    end
-    
-    adapter_map = RbVmomi::VIM.CustomizationAdapterMapping
-    adapter_map.adapter = settings
-    adapter_map
-   
-  end
-  
-end
+#
+# Author:: Ezra Pagel (<ezra@cpan.org>)
+# Contributor:: Jesse Campbell (<hikeit@gmail.com>)
+# License:: Apache License, Version 2.0
+#
+
+require 'chef/knife'
+require 'chef/knife/BaseVsphereCommand'
+require 'rbvmomi'
+require 'netaddr'
+
+# Clone an existing template into a new VM, optionally applying a customization specification.
+# 
+# usage:
+# knife vsphere vm clone NewNode UbuntuTemplate --cspec StaticSpec \
+#     --cips 192.168.0.99/24,192.168.1.99/24 \
+#     --chostname NODENAME --cdomain NODEDOMAIN
+class Chef::Knife::VsphereVmClone < Chef::Knife::BaseVsphereCommand
+
+	banner "knife vsphere vm clone VMNAME (options)"
+
+	get_common_options
+
+	option :dest_folder,
+		:long => "--dest-folder FOLDER",
+		:description => "The folder into which to put the cloned VM"
+
+	option :datastore,
+		:long => "--datastore STORE",
+		:description => "The datastore into which to put the cloned VM"
+
+	option :resource_pool,
+		:long => "--resource-pool POOL",
+		:description => "The resource pool into which to put the cloned VM",
+		:default => ''
+
+	option :source_vm,
+		:long => "--template TEMPLATE",
+		:description => "The source VM / Template to clone from",
+		:required => true
+
+	option :customization_spec,
+		:long => "--cspec CUST_SPEC",
+		:description => "The name of any customization specification to apply"
+
+	option :customization_vlan,
+		:long => "--cvlan CUST_VLAN",
+		:description => "VLAN name for network adapter to join"
+
+	option :customization_ips,
+		:long => "--cips CUST_IPS",
+		:description => "Comma-delimited list of CIDR IPs for customization"
+
+	option :customization_gw,
+		:long => "--cgw CUST_GW",
+		:description => "CIDR IP of gateway for customization"
+
+	option :customization_hostname,
+		:long => "--chostname CUST_HOSTNAME",
+		:description => "Unqualified hostname for customization"
+
+	option :customization_domain,
+		:long => "--cdomain CUST_DOMAIN",
+		:description => "Domain name for customization"
+
+	option :customization_tz,
+		:long => "--ctz CUST_TIMEZONE",
+		:description => "Timezone invalid 'Area/Location' format"
+
+	option :customization_cpucount,
+		:long => "--ccpu CUST_CPU_COUNT",
+		:description => "Number of CPUs"
+
+	option :customization_memory,
+		:long => "--cram CUST_MEMORY_GB",
+		:description => "Gigabytes of RAM"
+
+	option :power,  
+		:long => "--start STARTVM",
+		:description => "Indicates whether to start the VM after a successful clone",
+		:default => true
+
+	option :bootstrap,  
+		:long => "--bootstrap FALSE",
+		:description => "Indicates whether to bootstrap the VM",
+		:default => true
+
+	option :fqdn,
+		:long => "--fqdn SERVER_FQDN",
+		:description => "Fully qualified hostname for bootstrapping"
+
+	option :ssh_user,
+		:short => "-x USERNAME",
+		:long => "--ssh-user USERNAME",
+		:description => "The ssh username",
+		:default => "root"
+
+	option :ssh_password,
+		:short => "-P PASSWORD",
+		:long => "--ssh-password PASSWORD",
+		:description => "The ssh password"
+
+	option :ssh_port,
+		:short => "-p PORT",
+		:long => "--ssh-port PORT",
+		:description => "The ssh port",
+		:default => "22",
+		:proc => Proc.new { |key| Chef::Config[:knife][:ssh_port] = key }
+
+	option :identity_file,
+		:short => "-i IDENTITY_FILE",
+		:long => "--identity-file IDENTITY_FILE",
+		:description => "The SSH identity file used for authentication"
+
+	option :chef_node_name,
+		:short => "-N NAME",
+		:long => "--node-name NAME",
+		:description => "The Chef node name for your new node"
+
+	option :prerelease,
+		:long => "--prerelease",
+		:description => "Install the pre-release chef gems"
+
+	option :bootstrap_version,
+		:long => "--bootstrap-version VERSION",
+		:description => "The version of Chef to install",
+		:proc => lambda { |v| Chef::Config[:knife][:bootstrap_version] = v }
+
+	option :bootstrap_proxy,
+		:long => "--bootstrap-proxy PROXY_URL",
+		:description => "The proxy server for the node being bootstrapped",
+		:proc => Proc.new { |p| Chef::Config[:knife][:bootstrap_proxy] = p }
+
+	option :distro,
+		:short => "-d DISTRO",
+		:long => "--distro DISTRO",
+		:description => "Bootstrap a distro using a template",
+		:default => "ubuntu10.04-gems"
+
+	option :template_file,
+		:long => "--template-file TEMPLATE",
+		:description => "Full path to location of template to use",
+		:default => false
+
+	option :run_list,
+		:short => "-r RUN_LIST",
+		:long => "--run-list RUN_LIST",
+		:description => "Comma separated list of roles/recipes to apply",
+		:proc => lambda { |o| o.split(/[\s,]+/) },
+		:default => []
+
+	option :no_host_key_verify,
+		:long => "--no-host-key-verify",
+		:description => "Disable host key verification",
+		:boolean => true,
+		:default => false
+
+	def run
+
+		$stdout.sync = true
+
+		vmname = @name_args[0]
+		if vmname.nil?
+			show_usage
+			fatal_exit("You must specify a virtual machine name")
+		end
+		config[:fqdn] = vmname unless config[:fqdn]
+		config[:chef_node_name] = vmname unless config[:chef_node_name]
+
+		get_vim_connection
+
+		src_folder = find_folder(config[:folder])
+
+		src_vm = find_in_folder(src_folder, RbVmomi::VIM::VirtualMachine, config[:source_vm]) or
+		abort "VM/Template not found"
+
+		clone_spec = generate_clone_spec(src_vm.config)
+
+		dest_folder = find_folder(config[:dest_folder] || config[:folder]);
+
+		task = src_vm.CloneVM_Task(:folder => dest_folder, :name => vmname, :spec => clone_spec)
+		puts "Cloning template #{config[:source_vm]} to new VM #{vmname}"
+		task.wait_for_completion
+		puts "Finished creating virtual machine #{vmname}"
+
+		if config[:power] || config[:bootstrap]
+			vm = find_in_folder(dest_folder, RbVmomi::VIM::VirtualMachine, vmname) or
+			fatal_exit("VM #{vmname} not found")
+			vm.PowerOnVM_Task.wait_for_completion
+			puts "Powered on virtual machine #{vmname}"
+		end
+
+		if config[:bootstrap]
+			print "Waiting for sshd..."
+			print "." until tcp_test_ssh(config[:fqdn])
+			puts "done"
+
+			bootstrap_for_node.run
+		end
+	end
+
+	# Builds a CloneSpec
+	def generate_clone_spec (src_config)
+		rspec = RbVmomi::VIM.VirtualMachineRelocateSpec(:pool => find_pool(config[:resource_pool]))
+
+		if config[:datastore]
+			rspec.datastore = find_datastore(config[:datastore])
+		end
+
+		clone_spec = RbVmomi::VIM.VirtualMachineCloneSpec(:location => rspec,
+																											:powerOn => false,
+																											:template => false)
+
+		clone_spec.config = RbVmomi::VIM.VirtualMachineConfigSpec(:deviceChange => Array.new)
+
+		if config[:customization_cpucount]
+			clone_spec.config.numCPUs = config[:customization_cpucount]
+		end
+
+		if config[:customization_memory]
+			clone_spec.config.memoryMB = Integer(config[:customization_memory]) * 1024
+		end
+
+		if config[:customization_vlan]
+			network = find_network(config[:customization_vlan])
+			switch_port = RbVmomi::VIM.DistributedVirtualSwitchPortConnection(:switchUuid => network.config.distributedVirtualSwitch.uuid ,:portgroupKey => network.key)
+			card = src_config.hardware.device.find { |d| d.deviceInfo.label == "Network adapter 1" } or
+        abort "Can't find source network card to customize"
+			card.backing.port = switch_port
+			dev_spec = RbVmomi::VIM.VirtualDeviceConfigSpec(:device => card, :operation => "edit")
+			clone_spec.config.deviceChange.push dev_spec
+		end
+
+		if config[:customization_spec]
+			csi = find_customization(config[:customization_spec]) or
+			fatal_exit("failed to find customization specification named #{config[:customization_spec]}")
+
+			if csi.info.type != "Linux"
+				fatal_exit("Only Linux customization specifications are currently supported")
+			end
+
+			if config[:customization_ips]
+				if config[:customization_gw]
+					csi.spec.nicSettingMap = config[:customization_ips].split(',').map { |i| generate_adapter_map(i,config[:customization_gw]) }
+				else
+					csi.spec.nicSettingMap = config[:customization_ips].split(',').map { |i| generate_adapter_map(i) }
+				end
+			end
+
+			use_ident = !config[:customization_hostname].nil? || !config[:customization_domain].nil?
+
+			if use_ident
+				# TODO - verify that we're deploying a linux spec, at least warn
+				ident = RbVmomi::VIM.CustomizationLinuxPrep
+
+				if config[:customization_hostname]
+					ident.hostName = RbVmomi::VIM.CustomizationFixedName
+					ident.hostName.name = config[:customization_hostname]
+				else
+					ident.hostName = RbVmomi::VIM.CustomizationFixedName
+					ident.hostName.name = config[:customization_domain]
+				end
+
+				if config[:customization_domain]
+					ident.domain = config[:customization_domain]
+				end
+
+				csi.spec.identity = ident
+			end
+
+			clone_spec.customization = csi.spec
+		end
+		clone_spec
+	end
+
+	# Retrieves a CustomizationSpecItem that matches the supplied name
+	# @param vim [Connection] VI Connection to use
+	# @param name [String] name of customization
+	# @return [RbVmomi::VIM::CustomizationSpecItem]
+	def find_customization(name)
+		csm = config[:vim].serviceContent.customizationSpecManager
+		csm.GetCustomizationSpec(:name => name)
+	end
+
+	# Generates a CustomizationAdapterMapping (currently only single IPv4 address) object
+	# @param ip [String] Any static IP address to use, otherwise DHCP
+	# @param gw [String] If static, the gateway for the interface, otherwise network address + 1 will be used
+	# @return [RbVmomi::VIM::CustomizationIPSettings]
+	def generate_adapter_map (ip=nil, gw=nil, dns1=nil, dns2=nil, domain=nil)
+
+		settings = RbVmomi::VIM.CustomizationIPSettings
+
+		if ip.nil?
+			settings.ip = RbVmomi::VIM::CustomizationDhcpIpGenerator
+		else
+			cidr_ip = NetAddr::CIDR.create(ip)
+			settings.ip = RbVmomi::VIM::CustomizationFixedIp(:ipAddress => cidr_ip.ip)
+			settings.subnetMask = cidr_ip.netmask_ext
+
+			# TODO - want to confirm gw/ip are in same subnet?
+			# Only set gateway on first IP.
+			if config[:customization_ips].split(',').first == ip
+				if gw.nil?
+					settings.gateway = [cidr_ip.network(:Objectify => true).next_ip]
+				else
+					gw_cidr = NetAddr::CIDR.create(gw)
+					settings.gateway = [gw_cidr.ip]
+				end
+			end
+		end
+
+		adapter_map = RbVmomi::VIM.CustomizationAdapterMapping
+		adapter_map.adapter = settings
+		adapter_map
+	end
+
+	def bootstrap_for_node()
+		Chef::Knife::Bootstrap.load_deps
+		bootstrap = Chef::Knife::Bootstrap.new
+		bootstrap.name_args = [config[:fqdn]]
+		bootstrap.config[:run_list] = config[:run_list]
+		bootstrap.config[:ssh_user] = config[:ssh_user]
+		bootstrap.config[:ssh_password] = config[:ssh_password]
+		bootstrap.config[:ssh_port] = config[:ssh_port]
+		bootstrap.config[:identity_file] = config[:identity_file]
+		bootstrap.config[:chef_node_name] = config[:chef_node_name]
+		bootstrap.config[:prerelease] = config[:prerelease]
+		bootstrap.config[:bootstrap_version] = locate_config_value(:bootstrap_version)
+		bootstrap.config[:distro] = locate_config_value(:distro)
+		bootstrap.config[:use_sudo] = true unless config[:ssh_user] == 'root'
+		bootstrap.config[:template_file] = locate_config_value(:template_file)
+		bootstrap.config[:environment] = config[:environment]
+		# may be needed for vpc_mode
+		bootstrap.config[:no_host_key_verify] = config[:no_host_key_verify]
+		bootstrap
+	end
+
+	def tcp_test_ssh(hostname)
+		tcp_socket = TCPSocket.new(hostname, 22)
+		readable = IO.select([tcp_socket], nil, nil, 5)
+		if readable
+			Chef::Log.debug("sshd accepting connections on #{hostname}, banner is #{tcp_socket.gets}")
+			true
+		else
+			false
+		end
+	rescue Errno::ETIMEDOUT
+		false
+	rescue Errno::EPERM
+		false
+	rescue Errno::ECONNREFUSED
+		sleep 2
+		false
+	rescue Errno::EHOSTUNREACH
+		sleep 2
+		false
+	ensure
+		tcp_socket && tcp_socket.close
+	end
+end