Class: PDQTest::Puppet
- Inherits:
-
Object
- Object
- PDQTest::Puppet
- Defined in:
- lib/pdqtest/puppet.rb
Constant Summary collapse
- METADATA =
'metadata.json'
- MODULE_DIR =
'/etc/puppetlabs/code/modules'
- MAGIC_MARKER =
'@PDQTest'
- MAGIC_MARKER_RE =
/#\s*#{MAGIC_MARKER}/
- BATS_TESTS =
'./spec/acceptance'
- SETUP_SUFFIX =
'__setup.sh'
- BEFORE_SUFFIX =
'__before.bats'
- AFTER_SUFFIX =
'.bats'
- EXAMPLES_DIR =
'./examples'
- MANIFESTS_DIR =
'./manifests'
- CLASS_RE =
/^class /
- FIXTURES =
'fixtures.yml'
- @@bats_executed =
[]
- @@setup_executed =
[]
Class Method Summary collapse
- .bats_test(container, example, suffix) ⇒ Object
- .class2filename(c) ⇒ Object
- .filename2class(f) ⇒ Object
-
.find_classes ⇒ Object
find the available classes in this module.
- .find_examples ⇒ Object
- .get_bats_executed ⇒ Object
- .get_setup_executed ⇒ Object
-
.git_fixtures ⇒ Object
process fixtures->repositories->* from fixtures.yml if present to generate an array of commands to run ON THE DOCKER VM to checkout the required modules from git.
- .info ⇒ Object
- .install_deps ⇒ Object
- .link_module ⇒ Object
- .module_metadata ⇒ Object
- .module_name ⇒ Object
- .puppet_apply(example) ⇒ Object
- .reset_bats_executed ⇒ Object
- .reset_setup_executed ⇒ Object
- .run(container, example = nil) ⇒ Object
- .run_example(container, example) ⇒ Object
- .setup_test(container, example) ⇒ Object
- .test_basename(t) ⇒ Object
Class Method Details
.bats_test(container, example, suffix) ⇒ Object
154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 |
# File 'lib/pdqtest/puppet.rb', line 154 def self.bats_test(container, example, suffix) testcase = BATS_TESTS + '/' + test_basename(example) + suffix if File.exists?(testcase) Escort::Logger.output.puts "*** bats test **** bats #{PDQTest::Instance::TEST_DIR}/#{testcase}" res = PDQTest::Docker.exec(container, "bats #{PDQTest::Instance::TEST_DIR}/#{testcase}") status = PDQTest::Docker.exec_status(res) PDQTest::Docker.log_out(res) @@bats_executed << testcase else Escort::Logger.error.error "no #{suffix} tests for #{example} (should be at #{testcase})" status = true end status end |
.class2filename(c) ⇒ Object
63 64 65 66 67 68 69 70 71 |
# File 'lib/pdqtest/puppet.rb', line 63 def self.class2filename(c) if c == module_name f = "#{MANIFESTS_DIR}/init.pp" else f = c.gsub(module_name, MANIFESTS_DIR).gsub('::', File::SEPARATOR) + '.pp' end f end |
.filename2class(f) ⇒ Object
73 74 75 76 77 78 79 80 81 |
# File 'lib/pdqtest/puppet.rb', line 73 def self.filename2class(f) if f == "#{MANIFESTS_DIR}/init.pp" c = module_name else c = f.gsub(MANIFESTS_DIR, "#{module_name}").gsub(File::SEPARATOR, '::').gsub('.pp','') end c end |
.find_classes ⇒ Object
find the available classes in this module
127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 |
# File 'lib/pdqtest/puppet.rb', line 127 def self.find_classes() mod_name = module_name classes = [] if Dir.exists?(MANIFESTS_DIR) Find.find(MANIFESTS_DIR) do |m| if m =~ /\.pp$/ # check the file contains a valid class if ! File.readlines(m).grep(CLASS_RE).empty? # Class detected, work out class name and add to list of found classes classes << filename2class(m) else Escort::Logger.output.puts "no puppet class found in #{m}" end end end end classes end |
.find_examples ⇒ Object
83 84 85 86 87 88 89 90 91 92 93 94 |
# File 'lib/pdqtest/puppet.rb', line 83 def self.find_examples() examples = [] if Dir.exists?(EXAMPLES_DIR) Find.find(EXAMPLES_DIR) do |e| if ! File.directory?(e) and ! File.readlines(e).grep(MAGIC_MARKER_RE).empty? examples << e end end end Escort::Logger.output.puts "examples to run" + examples.to_s examples end |
.get_bats_executed ⇒ Object
32 33 34 |
# File 'lib/pdqtest/puppet.rb', line 32 def self.get_bats_executed @@bats_executed end |
.get_setup_executed ⇒ Object
36 37 38 |
# File 'lib/pdqtest/puppet.rb', line 36 def self.get_setup_executed @@setup_executed end |
.git_fixtures ⇒ Object
process fixtures->repositories->* from fixtures.yml if present to generate an array of commands to run ON THE DOCKER VM to checkout the required modules from git
99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 |
# File 'lib/pdqtest/puppet.rb', line 99 def self.git_fixtures() refresh_cmd = [] if File.exists?(FIXTURES) fixtures = YAML.load_file(FIXTURES) if fixtures.has_key?('repositories') fixtures['repositories'].each { |fixture, opts| target = "spec/fixtures/modules/#{fixture}" if opts.instance_of?(String) source = opts ref = 'master' elsif opts.instance_of?(Hash) source = opts['repo'] if opts.has_key? 'ref' ref = opts['ref'] else ref = 'master' end end refresh_cmd << "git_refresh refresh --target-dir #{target} --source-url #{source} --ref #{ref}" } end end refresh_cmd end |
.info ⇒ Object
275 276 277 278 |
# File 'lib/pdqtest/puppet.rb', line 275 def self.info Escort::Logger.output.puts "Parsed module name: #{module_name}" Escort::Logger.output.puts "Link module command: #{link_module}" end |
.install_deps ⇒ Object
53 54 55 56 57 58 59 60 61 |
# File 'lib/pdqtest/puppet.rb', line 53 def self.install_deps # Install dependencies for module steps = [] steps << "cd #{PDQTest::Instance::TEST_DIR}" steps << "librarian-puppet install --path #{MODULE_DIR} --destructive" steps + git_fixtures steps.join(' && ') end |
.link_module ⇒ Object
49 50 51 |
# File 'lib/pdqtest/puppet.rb', line 49 def self.link_module "mkdir -p #{MODULE_DIR} && ln -s #{PDQTest::Instance::TEST_DIR} #{MODULE_DIR}/#{module_name}" end |
.module_metadata ⇒ Object
40 41 42 43 |
# File 'lib/pdqtest/puppet.rb', line 40 def self. file = File.read(Dir.pwd + File::SEPARATOR + METADATA) JSON.parse(file) end |
.module_name ⇒ Object
45 46 47 |
# File 'lib/pdqtest/puppet.rb', line 45 def self.module_name ['name'].split(/[\/-]/)[1] end |
.puppet_apply(example) ⇒ Object
271 272 273 |
# File 'lib/pdqtest/puppet.rb', line 271 def self.puppet_apply(example) "cd #{PDQTest::Instance::TEST_DIR} && puppet apply --detailed-exitcodes #{example}" end |
.reset_bats_executed ⇒ Object
24 25 26 |
# File 'lib/pdqtest/puppet.rb', line 24 def self.reset_bats_executed @@bats_executed = [] end |
.reset_setup_executed ⇒ Object
28 29 30 |
# File 'lib/pdqtest/puppet.rb', line 28 def self.reset_setup_executed @@setup_executed = [] end |
.run(container, example = nil) ⇒ Object
230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 |
# File 'lib/pdqtest/puppet.rb', line 230 def self.run(container, example=nil) status = true Escort::Logger.output.puts "...fetch deps" cmd = install_deps res = PDQTest::Docker.exec(container, cmd) status &= PDQTest::Docker.exec_status(res) if status Escort::Logger.output.puts "...linking" cmd = link_module res = PDQTest::Docker.exec(container, cmd) status &= PDQTest::Docker.exec_status(res) if status Escort::Logger.output.puts "...run tests" if example status &= run_example(container, example) if ! status Escort::Logger.error.error "Example #{example} failed!" end else find_examples.each { |e| if status status &= run_example(container, e) if ! status Escort::Logger.error.error "Example #{e} failed! - skipping rest of tests" end end } end else PDQTest::Docker.log_all(res) Escort::Logger.error.error "Error linking module, see previous error, command was: #{cmd}" end else PDQTest::Docker.log_all(res) Escort::Logger.error.error "Error installing dependencies, see previous error, command was: #{cmd}" end PDQTest::Emoji.partial_status(status, 'Puppet') status end |
.run_example(container, example) ⇒ Object
188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 |
# File 'lib/pdqtest/puppet.rb', line 188 def self.run_example(container, example) if ! example.start_with?('./') # must prepend ./ to the example or we will not match the correct regexp # in test_basename example = "./#{example}" end Escort::Logger.output.puts "testing #{example}" status = false if setup_test(container, example) # see if we should run a bats test before running puppet if bats_test(container, example, BEFORE_SUFFIX) # run puppet apply - 1st run res = PDQTest::Docker.exec(container, puppet_apply(example)) PDQTest::Docker.log_out(res) if PDQTest::Docker.exec_status(res, true) # allow 2 as exit status # run puppet apply - 2nd run (check for idempotencey/no more changes) res = PDQTest::Docker.exec(container, puppet_apply(example)) PDQTest::Docker.log_out(res) # run the bats test if nothing failed yet if PDQTest::Docker.exec_status(res) # only allow 0 as exit status status = bats_test(container, example, AFTER_SUFFIX) else Escort::Logger.error.error "Not idempotent: #{example}" end else Escort::Logger.error.error "First puppet run of #{example} failed" end else Escort::Logger.error.error "Bats tests to run before #{example} failed" end else Escort::Logger.error.error "Setup script for #{example} failed" end status end |
.setup_test(container, example) ⇒ Object
170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 |
# File 'lib/pdqtest/puppet.rb', line 170 def self.setup_test(container, example) setup = BATS_TESTS + '/' + test_basename(example) + SETUP_SUFFIX if File.exists?(setup) Escort::Logger.output.puts "Setting up test for #{example}" script = File.read(setup) res = PDQTest::Docker.exec(container, script) status = PDQTest::Docker.exec_status(res) PDQTest::Docker.log_out(res) @@setup_executed << setup else Escort::Logger.output.puts "no setup file for #{example} (should be in #{setup})" status = true end status end |
.test_basename(t) ⇒ Object
147 148 149 150 151 152 |
# File 'lib/pdqtest/puppet.rb', line 147 def self.test_basename(t) # remove examples/ and .pp # eg ./examples/apache/mod/mod_php.pp --> apache/mod/mod_php t.gsub(EXAMPLES_DIR + '/','').gsub('.pp','') end |