rbvmomi 1.11.3 → 3.0.0

data/examples/power.rb

@@ -1,62 +0,0 @@
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-require 'trollop'
-require 'rbvmomi'
-require 'rbvmomi/trollop'
-
-VIM = RbVmomi::VIM
-CMDS = %w(on off reset suspend destroy)
-
-opts = Trollop.options do
-  banner <<-EOS
-Perform VM power operations.
-
-Usage:
-    power.rb [options] cmd VM
-
-Commands: #{CMDS * ' '}
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-
-  stop_on CMDS
-end
-
-cmd = ARGV[0] or Trollop.die("no command given")
-vm_name = ARGV[1] or Trollop.die("no VM name given")
-Trollop.die("must specify host") unless opts[:host]
-
-vim = VIM.connect opts
-
-dc = vim.serviceInstance.content.rootFolder.traverse(opts[:datacenter], VIM::Datacenter) or abort "datacenter not found"
-vm = dc.vmFolder.traverse(vm_name, VIM::VirtualMachine) or abort "VM not found"
-
-case cmd
-when 'on'
-  vm.PowerOnVM_Task.wait_for_completion
-when 'off'
-  vm.PowerOffVM_Task.wait_for_completion
-when 'reset'
-  vm.ResetVM_Task.wait_for_completion
-when 'suspend'
-  vm.SuspendVM_Task.wait_for_completion
-when 'destroy'
-  vm.Destroy_Task.wait_for_completion
-else
-  abort "invalid command"
-end

data/examples/readme-1.rb

@@ -1,38 +0,0 @@
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-require 'rbvmomi'
-require 'rbvmomi/trollop'
-
-opts = Trollop.options do
-  banner <<-EOS
-Example 1 from the README: Power on a VM.
-
-Usage:
-    readme-1.rb [options] VM name
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-end
-
-Trollop.die("must specify host") unless opts[:host]
-vm_name = ARGV[0] or abort "must specify VM name"
-
-vim = RbVmomi::VIM.connect opts
-dc = vim.serviceInstance.find_datacenter(opts[:datacenter]) or fail "datacenter not found"
-vm = dc.find_vm(vm_name) or fail "VM not found"
-vm.PowerOnVM_Task.wait_for_completion

data/examples/readme-2.rb

@@ -1,54 +0,0 @@
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-require 'rbvmomi'
-require 'rbvmomi/trollop'
-
-opts = Trollop.options do
-  banner <<-EOS
-Example 2 from the README: Power on a VM the hard way.
-
-Usage:
-    readme-2.rb [options] VM name
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-end
-
-Trollop.die("must specify host") unless opts[:host]
-vm_name = ARGV[0] or abort "must specify VM name"
-
-vim = RbVmomi::VIM.connect opts
-rootFolder = vim.serviceInstance.content.rootFolder
-dc = rootFolder.childEntity.grep(RbVmomi::VIM::Datacenter).find { |x| x.name == opts[:datacenter] } or fail "datacenter not found"
-vm = dc.vmFolder.childEntity.grep(RbVmomi::VIM::VirtualMachine).find { |x| x.name == vm_name } or fail "VM not found"
-task = vm.PowerOnVM_Task
-filter = vim.propertyCollector.CreateFilter(
-  :spec => {
-    :propSet => [{ :type => 'Task', :all => false, :pathSet => ['info.state']}],
-    :objectSet => [{ :obj => task }]
-  },
-  :partialUpdates => false
-)
-ver = ''
-while true
-  result = vim.propertyCollector.WaitForUpdates(:version => ver)
-  ver = result.version
-  break if ['success', 'error'].member? task.info.state
-end
-filter.DestroyPropertyFilter
-raise task.info.error if task.info.state == 'error'

data/examples/run.sh

@@ -1,41 +0,0 @@
-#!/bin/bash
-set -e
-
-if [ -z "$RBVMOMI_HOST" ]
-then
-  echo "export at least RBVMOMI_HOST"
-  exit 1
-fi
-
-EXAMPLES="$(dirname $(which $0))"
-export RUBYOPT="-I$EXAMPLES/../lib -rubygems"
-
-source "$HOME/.rvm/scripts/rvm"
-rvm use 1.8.7
-ruby -v
-RUBY=ruby
-
-echo Creating VM
-$RUBY $EXAMPLES/create_vm.rb foo
-echo Powering on VM
-$RUBY $EXAMPLES/power.rb on foo
-echo Resetting VM
-$RUBY $EXAMPLES/power.rb reset foo
-echo Powering off VM
-$RUBY $EXAMPLES/power.rb off foo
-echo "Powering on VM (1)"
-$RUBY $EXAMPLES/readme-1.rb foo
-echo Powering off VM
-$RUBY $EXAMPLES/power.rb off foo
-echo "Powering on VM (2)"
-$RUBY $EXAMPLES/readme-2.rb foo
-echo "Setting extraConfig"
-$RUBY $EXAMPLES/extraConfig.rb foo set guestinfo.bar=baz
-echo "Listing extraConfig"
-$RUBY $EXAMPLES/extraConfig.rb foo list | grep guestinfo.bar
-echo Powering off VM
-$RUBY $EXAMPLES/power.rb off foo
-echo Querying datastore utilization
-$RUBY $EXAMPLES/vdf.rb
-echo Destroying VM
-$RUBY $EXAMPLES/power.rb destroy foo

data/examples/screenshot.rb

@@ -1,51 +0,0 @@
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-# Based on takeVMScreenshot.pl by William Lam
-require 'trollop'
-require 'rbvmomi'
-require 'rbvmomi/trollop'
-
-VIM = RbVmomi::VIM
-
-opts = Trollop.options do
-  banner <<-EOS
-Take a screenshot.
-
-Usage:
-    screenshot.rb [options] vm filename
-
-A PNG image will be saved to the given filename.
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-end
-
-Trollop.die("must specify host") unless opts[:host]
-vm_name = ARGV[0] or abort("must specify VM name")
-output_path = ARGV[1] or abort("must specify output filename")
-
-vim = VIM.connect opts
-dc = vim.serviceInstance.find_datacenter(opts[:datacenter])
-vm = dc.find_vm vm_name
-abort "VM must be running" unless vm.runtime.powerState == 'poweredOn'
-remote_path = vm.CreateScreenshot_Task.wait_for_completion
-remote_path =~ /^(\/vmfs\/volumes\/[^\/]+)\// or fail
-datastore_prefix = $1
-datastore_path = $'
-datastore = vm.datastore.find { |ds| ds.info.url == datastore_prefix }
-datastore.download datastore_path, output_path

data/examples/vdf.rb

@@ -1,84 +0,0 @@
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-# Translation of vGhetto vdf, originally by William Lam
-require 'trollop'
-require 'rbvmomi'
-require 'rbvmomi/trollop'
-
-VIM = RbVmomi::VIM
-
-opts = Trollop.options do
-  banner <<-EOS
-Display utilization of each datastore in the datacenter.
-
-Usage:
-    vdf.rb [options]
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-Datacenter selection:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-end
-
-Trollop.die("must specify host") unless opts[:host]
-
-vim = VIM.connect opts
-
-dc = vim.serviceInstance.find_datacenter(opts[:datacenter]) or abort "datacenter not found"
-
-def si n
-  ['', 'K', 'M', 'G', 'T', 'P'].each_with_index do |x,i|
-    v = n.to_f/(1000**i)
-    return v,x if v < 1000 or x == 'P'
-  end
-end
-
-def unit n, u, p
-  "%.*g%s%s" % [p, si(n), u].flatten
-end
-
-def b n
-  unit(n,'B',3)
-end
-
-puts "Filesystem#{' '*53}Size     Used     Avail    Use%     Mounted on"
-fmt = "%-62s %-8s %-8s %-8s %-8s %s"
-
-if false
-  # simple version
-  dc.datastore.sort_by { |ds| ds.info.url }.each do |ds|
-    s = ds.summary
-    next unless s.accessible
-    size = s.capacity
-    free = s.freeSpace
-    used = size - free
-    pct_used = used*100.0/size
-    puts(fmt % [ds.info.url, b(size), b(used), b(free), unit(pct_used,'%',3), ds.name])
-  end
-else
-  # fast version
-  paths = %w(name info.url summary.accessible summary.capacity summary.freeSpace)
-  propSet = [{ :type => 'Datastore', :pathSet => paths }]
-  filterSpec = { :objectSet => dc.datastore.map { |ds| { :obj => ds } }, :propSet => propSet }
-  data = vim.propertyCollector.RetrieveProperties(:specSet => [filterSpec])
-  data.select { |d| d['summary.accessible'] }.sort_by { |d| d['info.url'] }.each do |d|
-    size = d['summary.capacity']
-    free = d['summary.freeSpace']
-    used = size - free
-    pct_used = used*100.0/size
-    puts(fmt % [d['info.url'], b(size), b(used), b(free), unit(pct_used,'%',3), d['name']])
-  end
-end

data/examples/vm_drs_behavior.rb

@@ -1,80 +0,0 @@
-#!/usr/bin/env ruby
-
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-require 'trollop'
-require 'rbvmomi'
-require 'rbvmomi/trollop'
-
-VIM = RbVmomi::VIM
-CMDS = %w(get set)
-BEHAVIOR = %w(fullyAutomated manual partiallyAutomated default)
-
-opts = Trollop.options do
-  banner <<-EOS
-Configure VM DRS behavior.
-
-Usage:
-    vm_drs_behavior.rb [options] VM get
-    vm_drs_behavior.rb [options] VM set #{BEHAVIOR.join('|')}
-
-Commands: #{CMDS * ' '}
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-
-  stop_on CMDS
-end
-
-Trollop.die("must specify host") unless opts[:host]
-
-vm_name = ARGV[0] or Trollop.die("no VM name given")
-cmd = ARGV[1] or Trollop.die("no command given")
-abort "invalid command" unless CMDS.member? cmd
-
-vim = VIM.connect opts
-dc = vim.serviceInstance.find_datacenter(opts[:datacenter]) or abort "datacenter not found"
-vm = dc.find_vm(vm_name) or abort "VM not found"
-
-cluster = vm.runtime.host.parent
-config = cluster.configurationEx.drsVmConfig.select {|c| c.key.name == vm.name }.first
-default = cluster.configurationEx.drsConfig.defaultVmBehavior
-
-case cmd
-when 'get'
-  if config
-    behavior = config.behavior
-  else
-    behavior = "#{default} (default)"
-  end
-  puts "#{vm.name} is #{behavior}"
-when 'set'
-  behavior = ARGV[2] or Trollop.die("no behavior given")
-  abort "invalid behavior" unless BEHAVIOR.member? behavior
-
-  if behavior == "default"
-    behavior = default
-  end
-  vm_spec =
-    VIM.ClusterDrsVmConfigSpec(:operation => VIM.ArrayUpdateOperation(config ? "edit" : "add"),
-                               :info => VIM.ClusterDrsVmConfigInfo(:key => vm,
-                                                                   :behavior => VIM.DrsBehavior(behavior)))
-  spec = VIM.ClusterConfigSpecEx(:drsVmConfigSpec => [vm_spec])
-  cluster.ReconfigureComputeResource_Task(:spec => spec, :modify => true).wait_for_completion
-end
-

data/rbvmomi.gemspec

@@ -1,33 +0,0 @@
-# Copyright (c) 2016-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-$LOAD_PATH.unshift(File.expand_path('../lib', __FILE__))
-
-require 'rbvmomi/version'
-
-Gem::Specification.new do |spec|
-  spec.name    = 'rbvmomi'
-  spec.summary = 'Ruby interface to the VMware vSphere API'
-  spec.version = RbVmomi::VERSION
-
-  spec.authors  = ['Rich Lane', 'Christian Dickmann']
-  spec.email    = 'jrg@vmware.com'
-  spec.homepage = 'https://github.com/vmware/rbvmomi'
-  spec.license  = 'MIT'
-
-  spec.bindir = 'exe'
-  spec.files  = `git ls-files -z`.split("\x0").reject { |f| f.match(/^test\//) }
-  spec.executables << 'rbvmomish'
-
-  spec.add_runtime_dependency('builder', '~> 3.0')
-  spec.add_runtime_dependency('json', '>= 1.8')
-  spec.add_runtime_dependency('nokogiri', '~> 1.5')
-  spec.add_runtime_dependency('trollop', '~> 2.1')
-
-  spec.add_development_dependency('rake', '~> 10.5')
-  spec.add_development_dependency('simplecov', '~> 0.12.0')
-  spec.add_development_dependency('yard', '~> 0.9.5')
-  spec.add_development_dependency('test-unit', '>= 2.5')
-
-  spec.required_ruby_version = '>= 1.8.7'
-end