Class: Kitchen::Verifier::Base
- Inherits:
-
Object
- Object
- Kitchen::Verifier::Base
- Includes:
- Configurable, Logging
- Defined in:
- lib/kitchen/verifier/base.rb
Overview
Base class for a verifier.
Instance Attribute Summary
Attributes included from Configurable
Class Method Summary collapse
-
.kitchen_verifier_api_version(version) ⇒ Object
Sets the API version for this verifier.
Instance Method Summary collapse
-
#call(state) ⇒ Object
Runs the verifier on the instance.
-
#cleanup_sandbox ⇒ Object
Deletes the sandbox path.
-
#create_sandbox ⇒ Object
Creates a temporary directory on the local workstation into which verifier related files and directories can be copied or created.
-
#init_command ⇒ String
Generates a command string which will perform any data initialization or configuration required after the verifier software is installed but before the sandbox has been transferred to the instance.
-
#initialize(config = {}) ⇒ Base
constructor
Creates a new Verifier object using the provided configuration data which will be merged with any default configuration.
-
#install_command ⇒ String
Generates a command string which will install and configure the verifier software on an instance.
-
#prepare_command ⇒ String
Generates a command string which will perform any commands or configuration required just before the main verifier run command but after the sandbox has been transferred to the instance.
-
#run_command ⇒ String
Generates a command string which will invoke the main verifier command on the prepared instance.
-
#sandbox_path ⇒ String
Returns the absolute path to the sandbox directory or raises an exception if
#create_sandbox
has not yet been called.
Methods included from Logging
#banner, #debug, #error, #fatal, #info, #warn
Methods included from Configurable
#[], #bourne_shell?, #calculate_path, #config_keys, #diagnose, #diagnose_plugin, #finalize_config!, included, #name, #powershell_shell?, #remote_path_join, #unix_os?, #verify_dependencies, #windows_os?
Constructor Details
#initialize(config = {}) ⇒ Base
Creates a new Verifier object using the provided configuration data which will be merged with any default configuration.
58 59 60 |
# File 'lib/kitchen/verifier/base.rb', line 58 def initialize(config = {}) init_config(config) end |
Class Method Details
.kitchen_verifier_api_version(version) ⇒ Object
Sets the API version for this verifier. If the verifier does not set
this value, then nil
will be used and reported.
Sets the API version for this verifier
185 186 187 |
# File 'lib/kitchen/verifier/base.rb', line 185 def self.kitchen_verifier_api_version(version) @api_version = version end |
Instance Method Details
#call(state) ⇒ Object
Runs the verifier on the instance.
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 |
# File 'lib/kitchen/verifier/base.rb', line 66 def call(state) create_sandbox sandbox_dirs = Dir.glob(File.join(sandbox_path, "*")) instance.transport.connection(state) do |conn| conn.execute(install_command) conn.execute(init_command) info("Transferring files to #{instance.to_str}") conn.upload(sandbox_dirs, config[:root_path]) debug("Transfer complete") conn.execute(prepare_command) conn.execute(run_command) end rescue Kitchen::Transport::TransportFailed => ex raise ActionFailed, ex. ensure cleanup_sandbox end |
#cleanup_sandbox ⇒ Object
Deletes the sandbox path. Without calling this method, the sandbox path will persist after the process terminates. In other words, cleanup is explicit. This method is safe to call multiple times.
88 89 90 91 92 93 |
# File 'lib/kitchen/verifier/base.rb', line 88 def cleanup_sandbox return if sandbox_path.nil? debug("Cleaning up local sandbox in #{sandbox_path}") FileUtils.rmtree(sandbox_path) end |
#create_sandbox ⇒ Object
Creates a temporary directory on the local workstation into which verifier related files and directories can be copied or created. The contents of this directory will be copied over to the instance before invoking the verifier's run command. After this method completes, it is expected that the contents of the sandbox is complete and ready for copy to the remote instance.
Note: any subclasses would be well advised to call super first when overriding this method, for example:
113 114 115 116 117 118 |
# File 'lib/kitchen/verifier/base.rb', line 113 def create_sandbox @sandbox_path = Dir.mktmpdir("#{instance.name}-sandbox-") File.chmod(0755, sandbox_path) info("Preparing files for transfer") debug("Creating local sandbox in #{sandbox_path}") end |
#init_command ⇒ String
Generates a command string which will perform any data initialization
or configuration required after the verifier software is installed
but before the sandbox has been transferred to the instance. If no work
is required, then nil
will be returned.
134 135 |
# File 'lib/kitchen/verifier/base.rb', line 134 def init_command end |
#install_command ⇒ String
Generates a command string which will install and configure the
verifier software on an instance. If no work is required, then nil
will be returned.
125 126 |
# File 'lib/kitchen/verifier/base.rb', line 125 def install_command end |
#prepare_command ⇒ String
Generates a command string which will perform any commands or
configuration required just before the main verifier run command but
after the sandbox has been transferred to the instance. If no work is
required, then nil
will be returned.
143 144 |
# File 'lib/kitchen/verifier/base.rb', line 143 def prepare_command end |
#run_command ⇒ String
Generates a command string which will invoke the main verifier
command on the prepared instance. If no work is required, then nil
will be returned.
151 152 |
# File 'lib/kitchen/verifier/base.rb', line 151 def run_command end |
#sandbox_path ⇒ String
Returns the absolute path to the sandbox directory or raises an
exception if #create_sandbox
has not yet been called.
160 161 162 163 164 |
# File 'lib/kitchen/verifier/base.rb', line 160 def sandbox_path @sandbox_path || (raise ClientError, "Sandbox directory has not yet " \ "been created. Please run #{self.class}#create_sandox before " \ "trying to access the path.") end |