Class: Beaker::Hypervisor

Inherits:
Object
  • Object
show all
Includes:
HostPrebuiltSteps
Defined in:
lib/beaker/hypervisor.rb

Overview

The Beaker class that interacts to all the supported hypervisors

Direct Known Subclasses

Noop

Constant Summary collapse

CHARMAP =

Generates an array with all letters a thru z and numbers 0 thru 9

('a'..'z').to_a + ('0'..'9').to_a
DEFAULT_CONNECTION_PREFERENCE =
[:ip, :vmhostname, :hostname]

Constants included from HostPrebuiltSteps

Beaker::HostPrebuiltSteps::APT_CFG, Beaker::HostPrebuiltSteps::ARCHLINUX_PACKAGES, Beaker::HostPrebuiltSteps::CUMULUS_PACKAGES, Beaker::HostPrebuiltSteps::DEBIAN_PACKAGES, Beaker::HostPrebuiltSteps::ETC_HOSTS_PATH, Beaker::HostPrebuiltSteps::ETC_HOSTS_PATH_SOLARIS, Beaker::HostPrebuiltSteps::FREEBSD_PACKAGES, Beaker::HostPrebuiltSteps::IPS_PKG_REPO, Beaker::HostPrebuiltSteps::NTPSERVER, Beaker::HostPrebuiltSteps::OPENBSD_PACKAGES, Beaker::HostPrebuiltSteps::PSWINDOWS_PACKAGES, Beaker::HostPrebuiltSteps::RHEL8_PACKAGES, Beaker::HostPrebuiltSteps::ROOT_KEYS_SCRIPT, Beaker::HostPrebuiltSteps::ROOT_KEYS_SYNC_CMD, Beaker::HostPrebuiltSteps::ROOT_KEYS_SYNC_CMD_AIX, Beaker::HostPrebuiltSteps::SLEEPWAIT, Beaker::HostPrebuiltSteps::SLES10_PACKAGES, Beaker::HostPrebuiltSteps::SLES_PACKAGES, Beaker::HostPrebuiltSteps::SOLARIS10_PACKAGES, Beaker::HostPrebuiltSteps::SOLARIS11_PACKAGES, Beaker::HostPrebuiltSteps::TRIES, Beaker::HostPrebuiltSteps::UNIX_PACKAGES, Beaker::HostPrebuiltSteps::WINDOWS_PACKAGES

Class Method Summary collapse

Instance Method Summary collapse

Methods included from HostPrebuiltSteps

#add_el_extras, #additive_hash_merge, #apt_get_update, #check_and_install_packages_if_needed, #construct_env, #copy_file_to_remote, #copy_ssh_to_root, #disable_iptables, #disable_se_linux, #disable_updates, #enable_root_login, #get_domain_name, #get_ip, #hack_etc_hosts, #install_one_of_packages, #package_proxy, #proxy_config, #set_env, #set_etc_hosts, #sync_root_keys, #timesync, #validate_host

Methods included from DSL::Patterns

#block_on

Constructor Details

#initialize(hosts, options) ⇒ Hypervisor

Returns a new instance of Hypervisor.



42
43
44
45
# File 'lib/beaker/hypervisor.rb', line 42

def initialize(hosts, options)
  @hosts = hosts
  @options = options
end

Class Method Details

.create(type, hosts_to_provision, options) ⇒ Object

Hypervisor creator method. Creates the appropriate hypervisor class object based upon the provided hypervisor type selected, then provisions hosts with hypervisor.

Parameters:

  • type (String)

    The type of hypervisor to create - one of aix, solaris, vsphere, fusion, blimpy, vcloud or vagrant

  • hosts_to_provision (Array<Host>)

    The hosts to be provisioned with the selected hypervisor

  • options (Hash)

    options Options to alter execution

Options Hash (options):

  • :host_name_prefix (String) — default: nil

    Prefix host name if set



20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
# File 'lib/beaker/hypervisor.rb', line 20

def self.create(type, hosts_to_provision, options)
  @logger = options[:logger]
  @logger.notify("Beaker::Hypervisor, found some #{type} boxes to create")

  hyper_class = case type
    when /^noop$/
      Beaker::Noop
    when /^(default)|(none)$/
      Beaker::Hypervisor
    else
      # Custom hypervisor
      require "beaker/hypervisor/#{type}"
      Beaker.const_get(type.split('_').collect(&:capitalize).join)
    end

  hypervisor = hyper_class.new(hosts_to_provision, options)
  self.set_ssh_connection_preference(hosts_to_provision, hypervisor)
  hypervisor.provision if options[:provision]

  hypervisor
end

.set_ssh_connection_preference(hosts_to_provision, hypervisor) ⇒ Object



63
64
65
66
67
68
69
70
71
72
73
# File 'lib/beaker/hypervisor.rb', line 63

def self.set_ssh_connection_preference(hosts_to_provision, hypervisor)
  hosts_to_provision.each do |host|
    ssh_methods = hypervisor.connection_preference(host) + DEFAULT_CONNECTION_PREFERENCE
    if host[:ssh_preference]
      # If user has provided ssh_connection_preference in hosts file then concat the preference provided by hypervisor
      # Followed by concatenating the default preference and keeping the unique once
      ssh_methods = host[:ssh_preference] + ssh_methods
    end
    host[:ssh_connection_preference] = ssh_methods.uniq
  end
end

Instance Method Details

#cleanupObject

Cleanup steps to be run for a given hypervisor. Default is nil.



53
54
55
# File 'lib/beaker/hypervisor.rb', line 53

def cleanup
  nil
end

#configure(opts = {}) ⇒ Object

Default configuration steps to be run for a given hypervisor. Any additional configuration to be done to the provided SUT for test execution to be successful.



84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
# File 'lib/beaker/hypervisor.rb', line 84

def configure(opts = {})
  begin
    return unless @options[:configure]
    run_in_parallel = run_in_parallel? opts, @options, 'configure'
    block_on @hosts, { :run_in_parallel => run_in_parallel} do |host|
      if host[:timesync]
        timesync(host, @options)
      end
    end
    if @options[:root_keys]
      sync_root_keys(@hosts, @options)
    end
    if @options[:add_el_extras]
      add_el_extras(@hosts, @options)
    end
    if @options[:disable_iptables]
      disable_iptables @hosts, @options
    end
    if @options[:set_env]
      set_env(@hosts, @options)
    end
    if @options[:disable_updates]
      disable_updates(@hosts, @options)
    end
  rescue SignalException => ex
    if ex.signo == 15 #SIGTERM
      report_and_raise(@logger, ex, "configure")
    end
    raise
  end
end

#connection_preference(host) ⇒ Object

SSH connection method preference. Can be overwritten by hypervisor to change the order



59
60
61
# File 'lib/beaker/hypervisor.rb', line 59

def connection_preference(host)
  DEFAULT_CONNECTION_PREFERENCE
end

#generate_host_nameObject

Generate a random string composted of letter and numbers prefixed with value of create option :host_name_prefix



126
127
128
129
130
131
132
# File 'lib/beaker/hypervisor.rb', line 126

def generate_host_name
  n = CHARMAP[rand(25)] + (0...14).map{CHARMAP[rand(CHARMAP.length)]}.join
  if @options[:host_name_prefix]
    return @options[:host_name_prefix] + n
  end
  n
end

#provisionObject

Provisioning steps for be run for a given hypervisor. Default is nil.



48
49
50
# File 'lib/beaker/hypervisor.rb', line 48

def provision
  nil
end

#proxy_package_managerObject

Proxy package managers on tests hosts created by this hypervisor, runs before validation and configuration.



76
77
78
79
80
# File 'lib/beaker/hypervisor.rb', line 76

def proxy_package_manager
  if @options[:package_proxy]
    package_proxy(@hosts, @options)
  end
end

#validateObject

Default validation steps to be run for a given hypervisor. Ensures that SUTs meet requirements to be beaker test nodes.



118
119
120
121
122
# File 'lib/beaker/hypervisor.rb', line 118

def validate
  if @options[:validate]
    validate_host(@hosts, @options)
  end
end