Class: Kitchen::Driver::Vagrant
- Inherits:
-
Base
- Object
- Base
- Kitchen::Driver::Vagrant
- Includes:
- ShellOut
- Defined in:
- lib/kitchen/driver/vagrant.rb
Overview
Vagrant driver for Kitchen. It communicates to Vagrant via the CLI.
Class Attribute Summary collapse
-
.vagrant_version ⇒ String
private
The version of Vagrant installed on the workstation.
-
.winrm_plugin_passed ⇒ true, false
private
Whether or not the vagrant-winrm plugin is installed.
Instance Method Summary collapse
-
#cache_directory ⇒ Object
Setting up the ‘cache_directory` to store omnibus packages in cache and share a local folder to that directory so that we don’t pull them down every single time.
-
#create(state) ⇒ Object
Creates a Vagrant VM instance.
-
#default_box ⇒ String?
The Vagrant box for this Instance.
-
#default_box_url ⇒ String?
The Vagrant box URL for this Instance.
-
#destroy(state) ⇒ Object
Destroys an instance.
-
#finalize_config!(instance) ⇒ self
A lifecycle method that should be invoked when the object is about ready to be used.
-
#verify_dependencies ⇒ Object
Performs whatever tests that may be required to ensure that this driver will be able to function in the current environment.
-
#winrm_transport? ⇒ TrueClass, FalseClass
private
Whether or not the transport’s name implies a WinRM-based transport.
Class Attribute Details
.vagrant_version ⇒ String
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Returns the version of Vagrant installed on the workstation.
203 204 205 |
# File 'lib/kitchen/driver/vagrant.rb', line 203 def vagrant_version @vagrant_version end |
.winrm_plugin_passed ⇒ true, false
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Returns whether or not the vagrant-winrm plugin is installed.
199 200 201 |
# File 'lib/kitchen/driver/vagrant.rb', line 199 def winrm_plugin_passed @winrm_plugin_passed end |
Instance Method Details
#cache_directory ⇒ Object
Setting up the ‘cache_directory` to store omnibus packages in cache and share a local folder to that directory so that we don’t pull them down every single time
184 185 186 187 |
# File 'lib/kitchen/driver/vagrant.rb', line 184 def cache_directory return if disable_cache? config[:cache_directory] end |
#create(state) ⇒ Object
Creates a Vagrant VM instance.
101 102 103 104 105 106 107 108 |
# File 'lib/kitchen/driver/vagrant.rb', line 101 def create(state) create_vagrantfile run_pre_create_command run_vagrant_up update_state(state) instance.transport.connection(state).wait_until_ready info("Vagrant instance #{instance.to_str} created.") end |
#default_box ⇒ String?
Returns the Vagrant box for this Instance.
111 112 113 114 115 116 117 |
# File 'lib/kitchen/driver/vagrant.rb', line 111 def default_box if bento_box?(instance.platform.name) "bento/#{instance.platform.name}" else instance.platform.name end end |
#default_box_url ⇒ String?
Returns the Vagrant box URL for this Instance.
120 121 122 |
# File 'lib/kitchen/driver/vagrant.rb', line 120 def default_box_url nil end |
#destroy(state) ⇒ Object
Destroys an instance.
128 129 130 131 132 133 134 135 136 137 138 |
# File 'lib/kitchen/driver/vagrant.rb', line 128 def destroy(state) return if state[:hostname].nil? create_vagrantfile @vagrantfile_created = false instance.transport.connection(state).close run("#{config[:vagrant_binary]} destroy -f") FileUtils.rm_rf(vagrant_root) info("Vagrant instance #{instance.to_str} destroyed.") state.delete(:hostname) end |
#finalize_config!(instance) ⇒ self
A lifecycle method that should be invoked when the object is about ready to be used. A reference to an Instance is required as configuration dependant data may be access through an Instance. This also acts as a hook point where the object may wish to perform other last minute checks, validations, or configuration expansions.
149 150 151 152 153 154 155 156 |
# File 'lib/kitchen/driver/vagrant.rb', line 149 def finalize_config!(instance) super finalize_vm_hostname! finalize_pre_create_command! finalize_synced_folders! finalize_ca_cert! self end |
#verify_dependencies ⇒ Object
Performs whatever tests that may be required to ensure that this driver will be able to function in the current environment. This may involve checking for the presence of certain directories, software installed, etc.
165 166 167 168 169 170 171 172 |
# File 'lib/kitchen/driver/vagrant.rb', line 165 def verify_dependencies super if Gem::Version.new(vagrant_version) < Gem::Version.new(MIN_VER.dup) raise UserError, "Detected an old version of Vagrant " \ "(#{vagrant_version})." \ " Please upgrade to version #{MIN_VER} or higher from #{WEBSITE}." end end |
#winrm_transport? ⇒ TrueClass, FalseClass
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Returns whether or not the transport’s name implies a WinRM-based transport.
177 178 179 |
# File 'lib/kitchen/driver/vagrant.rb', line 177 def winrm_transport? instance.transport.name.downcase =~ /win_?rm/ end |