knife-vsphere 1.0.0.pre.2 → 1.0.0.pre.3

data/lib/chef/knife/vsphere_vlan_list.rb

@@ -1,37 +1,37 @@
-# Author: Jesse Campbell
-#
-# Permission to use, copy, modify, and/or distribute this software for
-# any purpose with or without fee is hereby granted, provided that the
-# above copyright notice and this permission notice appear in all
-# copies.
-#
-# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
-# WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
-# WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
-# AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
-# DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
-# OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
-# TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-# PERFORMANCE OF THIS SOFTWARE
-
-require 'chef/knife'
-require 'chef/knife/base_vsphere_command'
-
-# Lists all known data stores in datacenter with sizes
-class Chef::Knife::VsphereVlanList < Chef::Knife::BaseVsphereCommand
-
-  banner "knife vsphere vlan list"
-
-  get_common_options
-
-  def run
-    $stdout.sync = true
-
-    vim = get_vim_connection
-    dc = get_datacenter
-    dc.network.each do |network|
-      puts "#{ui.color("VLAN", :cyan)}: #{network.name}"
-    end
-  end
-end
-
+# Author: Jesse Campbell
+#
+# Permission to use, copy, modify, and/or distribute this software for
+# any purpose with or without fee is hereby granted, provided that the
+# above copyright notice and this permission notice appear in all
+# copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
+# WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
+# AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
+# DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
+# OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+# TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+# PERFORMANCE OF THIS SOFTWARE
+
+require 'chef/knife'
+require 'chef/knife/base_vsphere_command'
+
+# Lists all known data stores in datacenter with sizes
+class Chef::Knife::VsphereVlanList < Chef::Knife::BaseVsphereCommand
+
+  banner "knife vsphere vlan list"
+
+  get_common_options
+
+  def run
+    $stdout.sync = true
+
+    vim = get_vim_connection
+    dc = get_datacenter
+    dc.network.each do |network|
+      puts "#{ui.color("VLAN", :cyan)}: #{network.name}"
+    end
+  end
+end
+

data/lib/chef/knife/vsphere_vm_clone.rb

@@ -1,539 +1,567 @@
-#
-# Author:: Ezra Pagel (<ezra@cpan.org>)
-# Contributor:: Jesse Campbell (<hikeit@gmail.com>)
-# Contributor:: Bethany Erskine (<bethany@paperlesspost.com>)
-# Contributor:: Adrian Stanila (https://github.com/sacx)
-# License:: Apache License, Version 2.0
-#
-
-require 'chef/knife'
-require 'chef/knife/base_vsphere_command'
-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 :datastorecluster,
-         :long => "--datastorecluster STORE",
-         :description => "The datastorecluster 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"
-
-  option :source_vm,
-         :long => "--template TEMPLATE",
-         :description => "The source VM / Template to clone from",
-         :required => true
-
-  option :linked_clone,
-         :long => "--linked-clone",
-         :description => "Indicates whether to use linked clones.",
-         :boolean => false
-
-  option :annotation,
-         :long => "--annotation TEXT",
-         :description => "Add TEXT in Notes field from annotation"
-
-  option :customization_spec,
-         :long => "--cspec CUST_SPEC",
-         :description => "The name of any customization specification to apply"
-
-  option :customization_plugin,
-         :long => "--cplugin CUST_PLUGIN_PATH",
-         :description => "Path to plugin that implements KnifeVspherePlugin.customize_clone_spec and/or KnifeVspherePlugin.reconfig_vm"
-
-  option :customization_plugin_data,
-         :long => "--cplugin-data CUST_PLUGIN_DATA",
-         :description => "String of data to pass to the plugin.  Use any format you wish."
-
-  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_dns_ips,
-         :long => "--cdnsips CUST_DNS_IPS",
-         :description => "Comma-delimited list of DNS IP addresses"
-
-  option :customization_dns_suffixes,
-         :long => "--cdnssuffix CUST_DNS_SUFFIXES",
-         :description => "Comma-delimited list of DNS search suffixes"
-
-  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",
-         :description => "Indicates whether to start the VM after a successful clone",
-         :boolean => false
-
-  option :bootstrap,
-         :long => "--bootstrap",
-         :description => "Indicates whether to bootstrap the VM",
-         :boolean => false
-
-  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[:ssh_user] = "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[:ssh_port] = 22
-
-  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",
-         :boolean => false
-
-  option :bootstrap_version,
-         :long => "--bootstrap-version VERSION",
-         :description => "The version of Chef to install",
-         :proc => Proc.new { |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"
-
-  option :template_file,
-         :long => "--template-file TEMPLATE",
-         :description => "Full path to location of template to use"
-
-  option :run_list,
-         :short => "-r RUN_LIST",
-         :long => "--run-list RUN_LIST",
-         :description => "Comma separated list of roles/recipes to apply"
-  $default[:run_list] = ''
-
-  option :secret_file,
-         :long => "--secret-file SECRET_FILE",
-         :description => "A file containing the secret key to use to encrypt data bag item values"
-  $default[:secret_file] = ''
-
-  option :no_host_key_verify,
-         :long => "--no-host-key-verify",
-         :description => "Disable host key verification",
-         :boolean => true
-
-  option :first_boot_attributes,
-         :short => "-j JSON_ATTRIBS",
-         :long => "--json-attributes",
-         :description => "A JSON string to be added to the first run of chef-client",
-         :proc => lambda { |o| JSON.parse(o) },
-         :default => {}
-
-  option :disable_customization,
-         :long => "--disable-customization",
-         :description => "Disable default customization",
-         :boolean => true,
-         :default => false
-
-  option :log_level,
-         :short => "-l LEVEL",
-         :long => "--log_level",
-         :description => "Set the log level (debug, info, warn, error, fatal) for chef-client",
-         :proc => lambda { |l| l.to_sym }
-
-  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[:chef_node_name] = vmname unless config[:chef_node_name]
-    config[:vmname] = vmname
-
-    if get_config(:bootstrap) && get_config(:distro) && !@@chef_config_dir
-      fatal_exit("Can't find .chef for bootstrap files. chdir to a location with a .chef directory and try again")
-    end
-
-    vim = get_vim_connection
-
-    dc = get_datacenter
-
-    src_folder = find_folder(get_config(:folder)) || dc.vmFolder
-
-    src_vm = find_in_folder(src_folder, RbVmomi::VIM::VirtualMachine, config[:source_vm]) or
-        abort "VM/Template not found"
-
-    if get_config(:linked_clone)
-      create_delta_disk(src_vm)  
-    end
-    
-    clone_spec = generate_clone_spec(src_vm.config)
-
-    cust_folder = config[:dest_folder] || get_config(:folder)
-
-    dest_folder = cust_folder.nil? ? src_vm.vmFolder : find_folder(cust_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 customization_plugin && customization_plugin.respond_to?(:reconfig_vm)
-      target_vm = find_in_folder(dest_folder, RbVmomi::VIM::VirtualMachine, vmname) or abort "VM could not be found in #{dest_folder}"
-      customization_plugin.reconfig_vm(target_vm)
-    end
-
-    if get_config(:power) || get_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 get_config(:bootstrap)
-      sleep 2 until vm.guest.ipAddress
-      config[:fqdn] = vm.guest.ipAddress unless config[:fqdn]
-      print "Waiting for sshd..."
-      print "." until tcp_test_ssh(config[:fqdn])
-      puts "done"
-
-      bootstrap_for_node.run
-    end
-  end
-
-  def create_delta_disk(src_vm)
-    disks = src_vm.config.hardware.device.grep(RbVmomi::VIM::VirtualDisk)
-    disks.select { |disk| disk.backing.parent == nil }.each do |disk|
-      spec = {
-          :deviceChange => [
-              {
-                  :operation => :remove,
-                  :device => disk
-              },
-              {
-                  :operation => :add,
-                  :fileOperation => :create,
-                  :device => disk.dup.tap { |new_disk|
-                    new_disk.backing = new_disk.backing.dup
-                    new_disk.backing.fileName = "[#{disk.backing.datastore.name}]"
-                    new_disk.backing.parent = disk.backing
-                  },
-              }
-          ]
-      }
-      src_vm.ReconfigVM_Task(:spec => spec).wait_for_completion
-      end
-  end
-
-  # Builds a CloneSpec
-  def generate_clone_spec (src_config)
-
-    rspec = nil
-    if get_config(:resource_pool)
-      rspec = RbVmomi::VIM.VirtualMachineRelocateSpec(:pool => find_pool(get_config(:resource_pool)))
-    else
-      dc = get_datacenter
-      hosts = find_all_in_folder(dc.hostFolder, RbVmomi::VIM::ComputeResource)
-      rp = hosts.first.resourcePool
-      rspec = RbVmomi::VIM.VirtualMachineRelocateSpec(:pool => rp)
-    end
-
-    if get_config(:linked_clone)
-      rspec = RbVmomi::VIM.VirtualMachineRelocateSpec(:diskMoveType => :moveChildMostDiskBacking)
-    end
-
-    if get_config(:datastore) && get_config(:datastorecluster)
-      abort "Please select either datastore or datastorecluster"
-    end
-
-    if get_config(:datastore)
-      rspec.datastore = find_datastore(get_config(:datastore))
-    end
-
-    if get_config(:datastorecluster)
-      dsc = find_datastorecluster(get_config(:datastorecluster))
-
-      dsc.childEntity.each do |store|
-        if (rspec.datastore == nil or rspec.datastore.summary[:freeSpace] < store.summary[:freeSpace])
-          rspec.datastore = store
-        end
-      end
-    end
-
-    clone_spec = RbVmomi::VIM.VirtualMachineCloneSpec(:location => rspec,
-                                                      :powerOn => false,
-                                                      :template => false)
-
-    clone_spec.config = RbVmomi::VIM.VirtualMachineConfigSpec(:deviceChange => Array.new)
-
-    if get_config(:annotation)
-      clone_spec.config.annotation = get_config(:annotation)
-    end
-
-    if get_config(:customization_cpucount)
-      clone_spec.config.numCPUs = get_config(:customization_cpucount)
-    end
-
-    if get_config(:customization_memory)
-      clone_spec.config.memoryMB = Integer(get_config(:customization_memory)) * 1024
-    end
-
-    if get_config(:customization_vlan)
-      network = find_network(get_config(:customization_vlan))
-      card = src_config.hardware.device.grep(RbVmomi::VIM::VirtualEthernetCard).first or
-          abort "Can't find source network card to customize"
-      begin
-        switch_port = RbVmomi::VIM.DistributedVirtualSwitchPortConnection(:switchUuid => network.config.distributedVirtualSwitch.uuid, :portgroupKey => network.key)
-        card.backing.port = switch_port
-      rescue
-        # not connected to a distibuted switch?
-        card.backing.deviceName = network.name
-      end
-      dev_spec = RbVmomi::VIM.VirtualDeviceConfigSpec(:device => card, :operation => "edit")
-      clone_spec.config.deviceChange.push dev_spec
-    end
-
-    if get_config(:customization_spec)
-      csi = find_customization(get_config(:customization_spec)) or
-          fatal_exit("failed to find customization specification named #{get_config(:customization_spec)}")
-
-      if csi.info.type != "Linux"
-        fatal_exit("Only Linux customization specifications are currently supported")
-      end
-      cust_spec = csi.spec
-    else
-      global_ipset = RbVmomi::VIM.CustomizationGlobalIPSettings
-      cust_spec = RbVmomi::VIM.CustomizationSpec(:globalIPSettings => global_ipset)
-    end
-
-    if get_config(:customization_dns_ips)
-      cust_spec.globalIPSettings.dnsServerList = get_config(:customization_dns_ips).split(',')
-    end
-
-    if get_config(:customization_dns_suffixes)
-      cust_spec.globalIPSettings.dnsSuffixList = get_config(:customization_dns_suffixes).split(',')
-    end
-
-    if config[:customization_ips]
-      if get_config(:customization_gw)
-        cust_spec.nicSettingMap = config[:customization_ips].split(',').map { |i| generate_adapter_map(i, get_config(:customization_gw)) }
-      else
-        cust_spec.nicSettingMap = config[:customization_ips].split(',').map { |i| generate_adapter_map(i) }
-      end
-    end
-
-    unless get_config(:disable_customization)
-      use_ident = !config[:customization_hostname].nil? || !get_config(:customization_domain).nil? || cust_spec.identity.nil?
-
-
-      if use_ident
-        # TODO - verify that we're deploying a linux spec, at least warn
-        ident = RbVmomi::VIM.CustomizationLinuxPrep
-
-        ident.hostName = RbVmomi::VIM.CustomizationFixedName
-        if config[:customization_hostname]
-          ident.hostName.name = config[:customization_hostname]
-        else
-          ident.hostName.name = config[:vmname]
-        end
-
-        if get_config(:customization_domain)
-          ident.domain = get_config(:customization_domain)
-        else
-          ident.domain = ''
-        end
-
-        cust_spec.identity = ident
-      end
-
-      clone_spec.customization = cust_spec
-
-      if customization_plugin && customization_plugin.respond_to?(:customize_clone_spec)
-        clone_spec = customization_plugin.customize_clone_spec(src_config, clone_spec)
-      end
-    end
-    clone_spec
-  end
-
-  # Loads the customization plugin if one was specified
-  # @return [KnifeVspherePlugin] the loaded and initialized plugin or nil
-  def customization_plugin
-    if @customization_plugin.nil?
-      if cplugin_path = get_config(:customization_plugin)
-        if File.exists? cplugin_path
-          require cplugin_path
-        else
-          abort "Customization plugin could not be found at #{cplugin_path}"
-        end
-
-        if Object.const_defined? 'KnifeVspherePlugin'
-          @customization_plugin = Object.const_get('KnifeVspherePlugin').new
-          if cplugin_data = get_config(:customization_plugin_data)
-            if @customization_plugin.respond_to?(:data=)
-              @customization_plugin.data = cplugin_data
-            else
-              abort "Customization plugin has no :data= accessor to receive the --cplugin-data argument.  Define both or neither."
-            end
-          end
-        else
-          abort "KnifeVspherePlugin class is not defined in #{cplugin_path}"
-        end
-      end
-    end
-
-    @customization_plugin
-  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] = get_config(:run_list).split(/[\s,]+/)
-    bootstrap.config[:secret_file] = get_config(:secret_file)
-    bootstrap.config[:ssh_user] = get_config(:ssh_user)
-    bootstrap.config[:ssh_password] = get_config(:ssh_password)
-    bootstrap.config[:ssh_port] = get_config(:ssh_port)
-    bootstrap.config[:identity_file] = get_config(:identity_file)
-    bootstrap.config[:chef_node_name] = get_config(:chef_node_name)
-    bootstrap.config[:prerelease] = get_config(:prerelease)
-    bootstrap.config[:bootstrap_version] = get_config(:bootstrap_version)
-    bootstrap.config[:distro] = get_config(:distro)
-    bootstrap.config[:use_sudo] = true unless get_config(:ssh_user) == 'root'
-    bootstrap.config[:template_file] = get_config(:template_file)
-    bootstrap.config[:environment] = get_config(:environment)
-    bootstrap.config[:first_boot_attributes] = get_config(:first_boot_attributes)
-    bootstrap.config[:log_level] = get_config(:log_level)
-    # may be needed for vpc_mode
-    bootstrap.config[:no_host_key_verify] = get_config(:no_host_key_verify)
-    bootstrap
-  end
-
-  def tcp_test_ssh(hostname)
-    tcp_socket = TCPSocket.new(hostname, get_config(:ssh_port))
-    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, Errno::ENETUNREACH
-    sleep 2
-    false
-  ensure
-    tcp_socket && tcp_socket.close
-  end
-end
+#
+# Author:: Ezra Pagel (<ezra@cpan.org>)
+# Contributor:: Jesse Campbell (<hikeit@gmail.com>)
+# Contributor:: Bethany Erskine (<bethany@paperlesspost.com>)
+# Contributor:: Adrian Stanila (https://github.com/sacx)
+# License:: Apache License, Version 2.0
+#
+
+require 'chef/knife'
+require 'chef/knife/base_vsphere_command'
+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 :datastorecluster,
+         :long => "--datastorecluster STORE",
+         :description => "The datastorecluster 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"
+
+  option :source_vm,
+         :long => "--template TEMPLATE",
+         :description => "The source VM / Template to clone from"
+
+  option :linked_clone,
+         :long => "--linked-clone",
+         :description => "Indicates whether to use linked clones.",
+         :boolean => false
+
+  option :annotation,
+         :long => "--annotation TEXT",
+         :description => "Add TEXT in Notes field from annotation"
+
+  option :customization_spec,
+         :long => "--cspec CUST_SPEC",
+         :description => "The name of any customization specification to apply"
+
+  option :customization_plugin,
+         :long => "--cplugin CUST_PLUGIN_PATH",
+         :description => "Path to plugin that implements KnifeVspherePlugin.customize_clone_spec and/or KnifeVspherePlugin.reconfig_vm"
+
+  option :customization_plugin_data,
+         :long => "--cplugin-data CUST_PLUGIN_DATA",
+         :description => "String of data to pass to the plugin.  Use any format you wish."
+
+  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_dns_ips,
+         :long => "--cdnsips CUST_DNS_IPS",
+         :description => "Comma-delimited list of DNS IP addresses"
+
+  option :customization_dns_suffixes,
+         :long => "--cdnssuffix CUST_DNS_SUFFIXES",
+         :description => "Comma-delimited list of DNS search suffixes"
+
+  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",
+         :description => "Indicates whether to start the VM after a successful clone",
+         :boolean => false
+
+  option :bootstrap,
+         :long => "--bootstrap",
+         :description => "Indicates whether to bootstrap the VM",
+         :boolean => false
+
+  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[:ssh_user] = "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[:ssh_port] = 22
+
+  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",
+         :boolean => false
+
+  option :bootstrap_version,
+         :long => "--bootstrap-version VERSION",
+         :description => "The version of Chef to install",
+         :proc => Proc.new { |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"
+
+  option :template_file,
+         :long => "--template-file TEMPLATE",
+         :description => "Full path to location of template to use"
+
+  option :run_list,
+         :short => "-r RUN_LIST",
+         :long => "--run-list RUN_LIST",
+         :description => "Comma separated list of roles/recipes to apply"
+  $default[:run_list] = ''
+
+  option :secret_file,
+         :long => "--secret-file SECRET_FILE",
+         :description => "A file containing the secret key to use to encrypt data bag item values"
+  $default[:secret_file] = ''
+
+  option :hint,
+         :long => "--hint HINT_NAME[=HINT_FILE]",
+         :description => "Specify Ohai Hint to be set on the bootstrap target.  Use multiple --hint options to specify multiple hints.",
+         :proc => Proc.new { |h|
+           Chef::Config[:knife][:hints] ||= Hash.new
+           name, path = h.split("=")
+           Chef::Config[:knife][:hints][name] = path ? JSON.parse(::File.read(path)) : Hash.new  }
+  $default[:hint] = ''
+
+  option :no_host_key_verify,
+         :long => "--no-host-key-verify",
+         :description => "Disable host key verification",
+         :boolean => true
+
+  option :first_boot_attributes,
+         :short => "-j JSON_ATTRIBS",
+         :long => "--json-attributes",
+         :description => "A JSON string to be added to the first run of chef-client",
+         :proc => lambda { |o| JSON.parse(o) },
+         :default => {}
+
+  option :disable_customization,
+         :long => "--disable-customization",
+         :description => "Disable default customization",
+         :boolean => true,
+         :default => false
+
+  option :log_level,
+         :short => "-l LEVEL",
+         :long => "--log_level",
+         :description => "Set the log level (debug, info, warn, error, fatal) for chef-client",
+         :proc => lambda { |l| l.to_sym }
+
+  option :mark_as_template,
+         :long => "--mark_as_template",
+         :description => "Indicates whether to mark the new vm as a template",
+         :boolean => 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[:chef_node_name] = vmname unless config[:chef_node_name]
+    config[:vmname] = vmname
+
+    if get_config(:bootstrap) && get_config(:distro) && !@@chef_config_dir
+      fatal_exit("Can't find .chef for bootstrap files. chdir to a location with a .chef directory and try again")
+    end
+
+    vim = get_vim_connection
+
+    dc = get_datacenter
+
+    src_folder = find_folder(get_config(:folder)) || dc.vmFolder
+
+    abort "--template or knife[:source_vm] must be specified" unless config[:source_vm]
+
+    src_vm = find_in_folder(src_folder, RbVmomi::VIM::VirtualMachine, config[:source_vm]) or
+        abort "VM/Template not found"
+
+    if get_config(:linked_clone)
+      create_delta_disk(src_vm)
+    end
+
+    clone_spec = generate_clone_spec(src_vm.config)
+
+    cust_folder = config[:dest_folder] || get_config(:folder)
+
+    dest_folder = cust_folder.nil? ? src_vm.vmFolder : find_folder(cust_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 customization_plugin && customization_plugin.respond_to?(:reconfig_vm)
+      target_vm = find_in_folder(dest_folder, RbVmomi::VIM::VirtualMachine, vmname) or abort "VM could not be found in #{dest_folder}"
+      customization_plugin.reconfig_vm(target_vm)
+    end
+
+    if !get_config(:mark_as_template)
+      if get_config(:power) || get_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 get_config(:bootstrap)
+        sleep 2 until vm.guest.ipAddress
+        config[:fqdn] = vm.guest.ipAddress unless config[:fqdn]
+        print "Waiting for sshd..."
+        print "." until tcp_test_ssh(config[:fqdn])
+        puts "done"
+
+        bootstrap_for_node.run
+      end
+    end
+  end
+
+  def create_delta_disk(src_vm)
+    disks = src_vm.config.hardware.device.grep(RbVmomi::VIM::VirtualDisk)
+    disks.select { |disk| disk.backing.parent == nil }.each do |disk|
+      spec = {
+          :deviceChange => [
+              {
+                  :operation => :remove,
+                  :device => disk
+              },
+              {
+                  :operation => :add,
+                  :fileOperation => :create,
+                  :device => disk.dup.tap { |new_disk|
+                    new_disk.backing = new_disk.backing.dup
+                    new_disk.backing.fileName = "[#{disk.backing.datastore.name}]"
+                    new_disk.backing.parent = disk.backing
+                  },
+              }
+          ]
+      }
+      src_vm.ReconfigVM_Task(:spec => spec).wait_for_completion
+      end
+  end
+
+  # Builds a CloneSpec
+  def generate_clone_spec (src_config)
+
+    rspec = nil
+    if get_config(:resource_pool)
+      rspec = RbVmomi::VIM.VirtualMachineRelocateSpec(:pool => find_pool(get_config(:resource_pool)))
+    else
+      dc = get_datacenter
+      hosts = find_all_in_folder(dc.hostFolder, RbVmomi::VIM::ComputeResource)
+      rp = hosts.first.resourcePool
+      rspec = RbVmomi::VIM.VirtualMachineRelocateSpec(:pool => rp)
+    end
+
+    if get_config(:linked_clone)
+      rspec = RbVmomi::VIM.VirtualMachineRelocateSpec(:diskMoveType => :moveChildMostDiskBacking)
+    end
+
+    if get_config(:datastore) && get_config(:datastorecluster)
+      abort "Please select either datastore or datastorecluster"
+    end
+
+    if get_config(:datastore)
+      rspec.datastore = find_datastore(get_config(:datastore))
+    end
+
+    if get_config(:datastorecluster)
+      dsc = find_datastorecluster(get_config(:datastorecluster))
+
+      dsc.childEntity.each do |store|
+        if (rspec.datastore == nil or rspec.datastore.summary[:freeSpace] < store.summary[:freeSpace])
+          rspec.datastore = store
+        end
+      end
+    end
+
+    if get_config(:mark_as_template)
+      clone_spec = RbVmomi::VIM.VirtualMachineCloneSpec(:location => rspec,
+                                                        :powerOn => false,
+                                                        :template => true)
+    else
+      clone_spec = RbVmomi::VIM.VirtualMachineCloneSpec(:location => rspec,
+                                                        :powerOn => false,
+                                                        :template => false)      
+    end
+    clone_spec.config = RbVmomi::VIM.VirtualMachineConfigSpec(:deviceChange => Array.new)
+
+    if get_config(:annotation)
+      clone_spec.config.annotation = get_config(:annotation)
+    end
+
+    if get_config(:customization_cpucount)
+      clone_spec.config.numCPUs = get_config(:customization_cpucount)
+    end
+
+    if get_config(:customization_memory)
+      clone_spec.config.memoryMB = Integer(get_config(:customization_memory)) * 1024
+    end
+
+    if get_config(:customization_vlan)
+      network = find_network(get_config(:customization_vlan))
+      card = src_config.hardware.device.grep(RbVmomi::VIM::VirtualEthernetCard).first or
+          abort "Can't find source network card to customize"
+      begin
+        switch_port = RbVmomi::VIM.DistributedVirtualSwitchPortConnection(:switchUuid => network.config.distributedVirtualSwitch.uuid, :portgroupKey => network.key)
+        card.backing.port = switch_port
+      rescue
+        # not connected to a distibuted switch?
+        card.backing.deviceName = network.name
+      end
+      dev_spec = RbVmomi::VIM.VirtualDeviceConfigSpec(:device => card, :operation => "edit")
+      clone_spec.config.deviceChange.push dev_spec
+    end
+
+    if get_config(:customization_spec)
+      csi = find_customization(get_config(:customization_spec)) or
+          fatal_exit("failed to find customization specification named #{get_config(:customization_spec)}")
+
+      cust_spec = csi.spec
+    else
+      global_ipset = RbVmomi::VIM.CustomizationGlobalIPSettings
+      cust_spec = RbVmomi::VIM.CustomizationSpec(:globalIPSettings => global_ipset)
+    end
+
+    if get_config(:customization_dns_ips)
+      cust_spec.globalIPSettings.dnsServerList = get_config(:customization_dns_ips).split(',')
+    end
+
+    if get_config(:customization_dns_suffixes)
+      cust_spec.globalIPSettings.dnsSuffixList = get_config(:customization_dns_suffixes).split(',')
+    end
+
+    if config[:customization_ips]
+      if get_config(:customization_gw)
+        cust_spec.nicSettingMap = config[:customization_ips].split(',').map { |i| generate_adapter_map(i, get_config(:customization_gw)) }
+      else
+        cust_spec.nicSettingMap = config[:customization_ips].split(',').map { |i| generate_adapter_map(i) }
+      end
+    end
+
+    unless get_config(:disable_customization)
+      use_ident = !config[:customization_hostname].nil? || !get_config(:customization_domain).nil? || cust_spec.identity.nil?
+
+      if use_ident
+        hostname = if config[:customization_hostname]
+          config[:customization_hostname]
+        else
+          config[:vmname]
+        end
+
+        if src_config.guestId.downcase.include?("linux")
+          ident = RbVmomi::VIM.CustomizationLinuxPrep
+
+          ident.hostName = RbVmomi::VIM.CustomizationFixedName(:name => hostname)
+
+          if get_config(:customization_domain)
+            ident.domain = get_config(:customization_domain)
+          else
+            ident.domain = ''
+          end
+
+          cust_spec.identity = ident
+        elsif src_config.guestId.downcase.include?("windows")
+          if cust_spec.identity.nil?
+            fatal_exit("Please provide Windows Guest Customization")
+          else
+            cust_spec.identity.userData.computerName = RbVmomi::VIM.CustomizationFixedName(:name => hostname)
+          end
+        end
+      end
+
+      clone_spec.customization = cust_spec
+
+      if customization_plugin && customization_plugin.respond_to?(:customize_clone_spec)
+        clone_spec = customization_plugin.customize_clone_spec(src_config, clone_spec)
+      end
+    end
+    clone_spec
+  end
+
+  # Loads the customization plugin if one was specified
+  # @return [KnifeVspherePlugin] the loaded and initialized plugin or nil
+  def customization_plugin
+    if @customization_plugin.nil?
+      if cplugin_path = get_config(:customization_plugin)
+        if File.exists? cplugin_path
+          require cplugin_path
+        else
+          abort "Customization plugin could not be found at #{cplugin_path}"
+        end
+
+        if Object.const_defined? 'KnifeVspherePlugin'
+          @customization_plugin = Object.const_get('KnifeVspherePlugin').new
+          if cplugin_data = get_config(:customization_plugin_data)
+            if @customization_plugin.respond_to?(:data=)
+              @customization_plugin.data = cplugin_data
+            else
+              abort "Customization plugin has no :data= accessor to receive the --cplugin-data argument.  Define both or neither."
+            end
+          end
+        else
+          abort "KnifeVspherePlugin class is not defined in #{cplugin_path}"
+        end
+      end
+    end
+
+    @customization_plugin
+  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] = get_config(:run_list).split(/[\s,]+/)
+    bootstrap.config[:secret_file] = get_config(:secret_file)
+    bootstrap.config[:hint] = get_config(:hint)
+    bootstrap.config[:ssh_user] = get_config(:ssh_user)
+    bootstrap.config[:ssh_password] = get_config(:ssh_password)
+    bootstrap.config[:ssh_port] = get_config(:ssh_port)
+    bootstrap.config[:identity_file] = get_config(:identity_file)
+    bootstrap.config[:chef_node_name] = get_config(:chef_node_name)
+    bootstrap.config[:prerelease] = get_config(:prerelease)
+    bootstrap.config[:bootstrap_version] = get_config(:bootstrap_version)
+    bootstrap.config[:distro] = get_config(:distro)
+    bootstrap.config[:use_sudo] = true unless get_config(:ssh_user) == 'root'
+    bootstrap.config[:template_file] = get_config(:template_file)
+    bootstrap.config[:environment] = get_config(:environment)
+    bootstrap.config[:first_boot_attributes] = get_config(:first_boot_attributes)
+    bootstrap.config[:log_level] = get_config(:log_level)
+    # may be needed for vpc_mode
+    bootstrap.config[:no_host_key_verify] = get_config(:no_host_key_verify)
+    bootstrap
+  end
+
+  def tcp_test_ssh(hostname)
+    tcp_socket = TCPSocket.new(hostname, get_config(:ssh_port))
+    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, Errno::ENETUNREACH
+    sleep 2
+    false
+  ensure
+    tcp_socket && tcp_socket.close
+  end
+end