test-kitchen 1.23.2 → 1.23.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (173) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +7 -0
  3. data/.gitmodules +0 -0
  4. data/.travis.yml +0 -4
  5. data/CHANGELOG.md +40 -0
  6. data/MAINTAINERS.md +2 -1
  7. data/Rakefile +9 -0
  8. data/docs/CONTRIBUTING.md +8 -0
  9. data/docs/LICENSE +22 -0
  10. data/docs/README.md +78 -0
  11. data/docs/archetypes/default.md +6 -0
  12. data/docs/config.toml +36 -0
  13. data/docs/content/docs/_index.md +5 -0
  14. data/docs/content/docs/drivers/_index.md +27 -0
  15. data/docs/content/docs/drivers/azurerm.md +44 -0
  16. data/docs/content/docs/drivers/vagrant.md +39 -0
  17. data/docs/content/docs/getting-started/00-introduction.md +14 -0
  18. data/docs/content/docs/getting-started/01-installing.md +64 -0
  19. data/docs/content/docs/getting-started/02-getting-help.md +59 -0
  20. data/docs/content/docs/getting-started/03-creating-cookbook.md +46 -0
  21. data/docs/content/docs/getting-started/04-kitchen-yml.md +56 -0
  22. data/docs/content/docs/getting-started/05-instances.md +79 -0
  23. data/docs/content/docs/getting-started/06-writing-recipe.md +21 -0
  24. data/docs/content/docs/getting-started/07-running-converge.md +134 -0
  25. data/docs/content/docs/getting-started/08-manually-verifying.md +55 -0
  26. data/docs/content/docs/getting-started/09-writing-test.md +49 -0
  27. data/docs/content/docs/getting-started/10-running-verify.md +120 -0
  28. data/docs/content/docs/getting-started/11-running-test.md +168 -0
  29. data/docs/content/docs/getting-started/12-adding-platform.md +206 -0
  30. data/docs/content/docs/getting-started/13-adding-feature.md +30 -0
  31. data/docs/content/docs/getting-started/14-adding-suite.md +60 -0
  32. data/docs/content/docs/getting-started/15-adding-test.md +66 -0
  33. data/docs/content/docs/getting-started/16-adding-recipe.md +53 -0
  34. data/docs/content/docs/getting-started/17-excluding-platforms.md +101 -0
  35. data/docs/content/docs/getting-started/18-next-steps.md +23 -0
  36. data/docs/content/docs/getting-started/_index.md +5 -0
  37. data/docs/content/docs/provisioners/_index.md +36 -0
  38. data/docs/content/docs/provisioners/chef.md +69 -0
  39. data/docs/content/docs/provisioners/shell.md +31 -0
  40. data/docs/content/docs/reference/_index.md +5 -0
  41. data/docs/content/docs/reference/configuration.md +53 -0
  42. data/docs/content/docs/reference/examples.md +97 -0
  43. data/docs/content/docs/reference/faq.md +58 -0
  44. data/docs/content/docs/reference/fixtures.md +32 -0
  45. data/docs/content/docs/reference/glossary.md +34 -0
  46. data/docs/content/docs/reference/lifecycle-hooks.md +68 -0
  47. data/docs/content/docs/reference/reboots.md +24 -0
  48. data/docs/content/docs/verifiers/_index.md +14 -0
  49. data/docs/content/docs/verifiers/inspec.md +44 -0
  50. data/docs/content/docs/verifiers/serverspec.md +20 -0
  51. data/docs/static/images/chef-logo.png +0 -0
  52. data/docs/static/images/chef-logo.svg +1 -0
  53. data/docs/static/images/github-banner.png +0 -0
  54. data/docs/static/images/github-banner.svg +71 -0
  55. data/docs/static/images/kitchen-logo.png +0 -0
  56. data/docs/static/images/logo-block.svg +222 -0
  57. data/docs/static/images/logo.png +0 -0
  58. data/docs/static/images/logos-group.png +0 -0
  59. data/docs/static/images/terminal-1.png +0 -0
  60. data/docs/static/images/terminal-1.svg +589 -0
  61. data/docs/static/images/terminal-2.png +0 -0
  62. data/docs/static/images/terminal-2.svg +235 -0
  63. data/docs/static/images/terminal-3.png +0 -0
  64. data/docs/static/images/terminal-3.svg +439 -0
  65. data/docs/static/index.html +59 -0
  66. data/docs/static/javascripts/all.js +348 -0
  67. data/docs/static/javascripts/vendor/foundation.min.js +4 -0
  68. data/docs/static/javascripts/vendor/jquery.min.js +5 -0
  69. data/docs/static/javascripts/vendor/what-input.js +336 -0
  70. data/docs/static/stylesheets/site.css +4667 -0
  71. data/docs/themes/kitchen/layouts/_default/baseof.html +53 -0
  72. data/docs/themes/kitchen/layouts/_default/list.html +4 -0
  73. data/docs/themes/kitchen/layouts/_default/redirect.html +10 -0
  74. data/docs/themes/kitchen/layouts/_default/single.html +6 -0
  75. data/docs/themes/kitchen/layouts/partials/core/head.html +6 -0
  76. data/docs/themes/kitchen/layouts/partials/kitchen/footer.html +18 -0
  77. data/docs/themes/kitchen/layouts/partials/kitchen/head.html +4 -0
  78. data/docs/themes/kitchen/layouts/partials/kitchen/header.html +26 -0
  79. data/docs/themes/kitchen/layouts/partials/search-docs.html +3 -0
  80. data/docs/themes/kitchen/layouts/partials/sidebar.html +33 -0
  81. data/docs/themes/kitchen/layouts/shortcodes/button.html +1 -0
  82. data/docs/themes/kitchen/layouts/shortcodes/codeblock.html +8 -0
  83. data/docs/themes/kitchen/layouts/shortcodes/cta.html +5 -0
  84. data/docs/themes/kitchen/layouts/shortcodes/danger.html +1 -0
  85. data/docs/themes/kitchen/layouts/shortcodes/example_fqdn.html +1 -0
  86. data/docs/themes/kitchen/layouts/shortcodes/info.html +1 -0
  87. data/docs/themes/kitchen/layouts/shortcodes/ol-styled.html +3 -0
  88. data/docs/themes/kitchen/layouts/shortcodes/success.html +1 -0
  89. data/docs/themes/kitchen/layouts/shortcodes/tip.html +1 -0
  90. data/docs/themes/kitchen/layouts/shortcodes/warning.html +1 -0
  91. data/docs/themes/kitchen/static/css/kitchen.css +10 -0
  92. data/docs/themes/kitchen/static/css/kitchen.css.map +7 -0
  93. data/docs/themes/kitchen/static/fonts/Muli-Bold.ttf +0 -0
  94. data/docs/themes/kitchen/static/fonts/Muli-Regular.ttf +0 -0
  95. data/docs/themes/kitchen/static/fonts/Muli-SemiBold.ttf +0 -0
  96. data/docs/themes/kitchen/static/fonts/fontawesome/fa-brands-400.eot +0 -0
  97. data/docs/themes/kitchen/static/fonts/fontawesome/fa-brands-400.svg +1104 -0
  98. data/docs/themes/kitchen/static/fonts/fontawesome/fa-brands-400.ttf +0 -0
  99. data/docs/themes/kitchen/static/fonts/fontawesome/fa-brands-400.woff +0 -0
  100. data/docs/themes/kitchen/static/fonts/fontawesome/fa-brands-400.woff2 +0 -0
  101. data/docs/themes/kitchen/static/fonts/fontawesome/fa-regular-400.eot +0 -0
  102. data/docs/themes/kitchen/static/fonts/fontawesome/fa-regular-400.svg +372 -0
  103. data/docs/themes/kitchen/static/fonts/fontawesome/fa-regular-400.ttf +0 -0
  104. data/docs/themes/kitchen/static/fonts/fontawesome/fa-regular-400.woff +0 -0
  105. data/docs/themes/kitchen/static/fonts/fontawesome/fa-regular-400.woff2 +0 -0
  106. data/docs/themes/kitchen/static/fonts/fontawesome/fa-solid-900.eot +0 -0
  107. data/docs/themes/kitchen/static/fonts/fontawesome/fa-solid-900.svg +1896 -0
  108. data/docs/themes/kitchen/static/fonts/fontawesome/fa-solid-900.ttf +0 -0
  109. data/docs/themes/kitchen/static/fonts/fontawesome/fa-solid-900.woff +0 -0
  110. data/docs/themes/kitchen/static/fonts/fontawesome/fa-solid-900.woff2 +0 -0
  111. data/docs/themes/kitchen/static/images/chef-logo-light.svg +36 -0
  112. data/docs/themes/kitchen/static/images/chef-logo-white.svg +38 -0
  113. data/docs/themes/kitchen/static/images/chef-logo.svg +37 -0
  114. data/docs/themes/kitchen/static/images/favicon.ico +0 -0
  115. data/docs/themes/kitchen/static/js/scripts-all.js +7 -0
  116. data/docs/themes/kitchen/static/js/source/chef-hugo.js +116 -0
  117. data/docs/themes/kitchen/static/js/source/omnitruck.js +82 -0
  118. data/docs/themes/kitchen/static/js/source/segment.js +52 -0
  119. data/docs/themes/kitchen/static/sass/_buttons.scss +161 -0
  120. data/docs/themes/kitchen/static/sass/_core.scss +24 -0
  121. data/docs/themes/kitchen/static/sass/_forms.scss +14 -0
  122. data/docs/themes/kitchen/static/sass/_mixins.scss +133 -0
  123. data/docs/themes/kitchen/static/sass/_typography.scss +34 -0
  124. data/docs/themes/kitchen/static/sass/_variables.scss +82 -0
  125. data/docs/themes/kitchen/static/sass/kitchen.scss +7 -0
  126. data/docs/themes/kitchen/static/sass/kitchen/_footer.scss +50 -0
  127. data/docs/themes/kitchen/static/sass/kitchen/_header.scss +187 -0
  128. data/docs/themes/kitchen/static/sass/kitchen/_homepage.scss +27 -0
  129. data/docs/themes/kitchen/static/sass/kitchen/_utility-bar.scss +173 -0
  130. data/docs/themes/kitchen/static/sass/partials/_alerts.scss +32 -0
  131. data/docs/themes/kitchen/static/sass/partials/_bg.scss +19 -0
  132. data/docs/themes/kitchen/static/sass/partials/_blurbs.scss +25 -0
  133. data/docs/themes/kitchen/static/sass/partials/_callout.scss +15 -0
  134. data/docs/themes/kitchen/static/sass/partials/_cards.scss +54 -0
  135. data/docs/themes/kitchen/static/sass/partials/_dropdown.scss +77 -0
  136. data/docs/themes/kitchen/static/sass/partials/_grid.scss +87 -0
  137. data/docs/themes/kitchen/static/sass/partials/_padding.scss +73 -0
  138. data/docs/themes/kitchen/static/sass/partials/_sidebar.scss +71 -0
  139. data/docs/themes/kitchen/static/sass/partials/_tabs.scss +125 -0
  140. data/docs/themes/kitchen/static/sass/typography/_chroma.scss +366 -0
  141. data/docs/themes/kitchen/static/sass/typography/_code.scss +72 -0
  142. data/docs/themes/kitchen/static/sass/typography/_headers.scss +90 -0
  143. data/docs/themes/kitchen/static/sass/typography/_links.scss +127 -0
  144. data/docs/themes/kitchen/static/sass/typography/_lists.scss +155 -0
  145. data/docs/themes/kitchen/static/sass/typography/_prose.scss +29 -0
  146. data/docs/themes/kitchen/static/sass/typography/_text.scss +221 -0
  147. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_animated.scss +20 -0
  148. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_bordered-pulled.scss +20 -0
  149. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_core.scss +16 -0
  150. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_fixed-width.scss +6 -0
  151. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_icons.scss +992 -0
  152. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_larger.scss +23 -0
  153. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_list.scss +18 -0
  154. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_mixins.scss +57 -0
  155. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_rotated-flipped.scss +23 -0
  156. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_screen-reader.scss +5 -0
  157. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_stacked.scss +31 -0
  158. data/docs/themes/kitchen/static/sass/vendor/fontawesome/_variables.scss +1005 -0
  159. data/docs/themes/kitchen/static/sass/vendor/fontawesome/fa-brands.scss +21 -0
  160. data/docs/themes/kitchen/static/sass/vendor/fontawesome/fa-regular.scss +22 -0
  161. data/docs/themes/kitchen/static/sass/vendor/fontawesome/fa-solid.scss +23 -0
  162. data/docs/themes/kitchen/static/sass/vendor/fontawesome/fontawesome.scss +16 -0
  163. data/docs/themes/kitchen/theme.toml +8 -0
  164. data/lib/kitchen/provisioner/chef_base.rb +6 -6
  165. data/lib/kitchen/transport/ssh.rb +2 -2
  166. data/lib/kitchen/transport/winrm.rb +32 -9
  167. data/lib/kitchen/version.rb +1 -1
  168. data/spec/kitchen/data_munger_spec.rb +13 -13
  169. data/spec/kitchen/driver/exec_spec.rb +1 -1
  170. data/spec/kitchen/lifecycle_hooks_spec.rb +6 -6
  171. data/spec/kitchen/provisioner/chef_base_spec.rb +26 -26
  172. data/spec/kitchen/transport/winrm_spec.rb +46 -10
  173. metadata +160 -3
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9219cf297ee744f00b2e77febd43103a4cfbbb4b8e12c31e4be80cf66cf30127
4
- data.tar.gz: d2bad7b27981a7dad6b2a3437a828c91626c196233bd5d81060e6cc91cfc8a9c
3
+ metadata.gz: f1bfec4fe44eff1b8640b167fba7a0323858851c665ece2531ad771006c7ac5c
4
+ data.tar.gz: b1973b75fc30bc473b7ed6bd1fa5c1cea1fc6fb08ce075e823aae824c2268904
5
5
  SHA512:
6
- metadata.gz: e09373f94e6b8cde1525c248a87c722b629a28d4afa005ca0f512699968898ca119778f8cddc35b8ae03d85802567019e9edd69c8566470df693f6bf0c7ae4fb
7
- data.tar.gz: 354ab8c97efd79db86a6c2e49533057281c76bbb85a683ef69c2cf640ac8c294db04ee5dd4e0501f7978026b2460cd585f83b7aafc374f6202606fc5d85c6bfa
6
+ metadata.gz: 21b54008f37b7c73709f4f2d8594a0d47407b9f37240c481a8653aebffbf69cc451cd7bf02c04c564e48601521d60a1afb370965939e77ccd0271fccdf1fe0bf
7
+ data.tar.gz: b77cdca63287e4e87f1ea28151b66583c6ba73e24ad89be37a4dd405e544fb0e3b23abad3a67cf390647753ecdd8f57cb249007321c3d8e62bba0171ab10435b
data/.gitignore CHANGED
@@ -29,3 +29,10 @@ kitchen.yml
29
29
  kitchen.local.yml
30
30
  Berksfile.lock
31
31
  *.swp
32
+ *~
33
+ .sass-cache
34
+ _site/
35
+ _cache
36
+ .tddium*
37
+ docs/public
38
+
File without changes
@@ -27,10 +27,6 @@ branches:
27
27
 
28
28
  matrix:
29
29
  include:
30
- - rvm: 2.5.1
31
- before_install:
32
- # https://github.com/travis-ci/travis-ci/issues/8978
33
- - gem update --system
34
30
  - rvm: 2.4.4
35
31
  # To run the proxy tests we need additional gems than what Test Kitchen normally uses
36
32
  # for testing
@@ -1,5 +1,45 @@
1
1
  # Change Log
2
2
 
3
+ ## [v1.23.3](https://github.com/test-kitchen/test-kitchen/tree/v1.23.3) (2018-11-30)
4
+ [Full Changelog](https://github.com/test-kitchen/test-kitchen/compare/v1.23.2...v1.23.3)
5
+
6
+ **Fixed bugs:**
7
+
8
+ - Chef 13 Cookbook Root Aliases Not Found [\#1230](https://github.com/test-kitchen/test-kitchen/issues/1230)
9
+
10
+ **Closed issues:**
11
+
12
+ - WinRM transport leaves open connections [\#1495](https://github.com/test-kitchen/test-kitchen/issues/1495)
13
+ - Add Rake Tasks for doc gen and deployment [\#1467](https://github.com/test-kitchen/test-kitchen/issues/1467)
14
+ - Docs - migrate to Hugo [\#1458](https://github.com/test-kitchen/test-kitchen/issues/1458)
15
+ - Docs for fixture cookbooks [\#1457](https://github.com/test-kitchen/test-kitchen/issues/1457)
16
+ - Docs for Setting Environment for Chef provisioner [\#1455](https://github.com/test-kitchen/test-kitchen/issues/1455)
17
+ - Docs for Reboot [\#1454](https://github.com/test-kitchen/test-kitchen/issues/1454)
18
+ - Docs for Silencing Chef Deprecation Warnings [\#1452](https://github.com/test-kitchen/test-kitchen/issues/1452)
19
+ - Docs for Shell Provisioner [\#1451](https://github.com/test-kitchen/test-kitchen/issues/1451)
20
+ - Add documentation for elevated transport [\#1054](https://github.com/test-kitchen/test-kitchen/issues/1054)
21
+
22
+ **Merged pull requests:**
23
+
24
+ - Fixing failing travis test from PR merge [\#1499](https://github.com/test-kitchen/test-kitchen/pull/1499) ([tyler-ball](https://github.com/tyler-ball))
25
+ - LT Tyler Ball [\#1497](https://github.com/test-kitchen/test-kitchen/pull/1497) ([robbkidd](https://github.com/robbkidd))
26
+ - Close underlying winrm connections gracefully [\#1496](https://github.com/test-kitchen/test-kitchen/pull/1496) ([dwoz](https://github.com/dwoz))
27
+ - Fixing code block formatting [\#1494](https://github.com/test-kitchen/test-kitchen/pull/1494) ([cheeseplus](https://github.com/cheeseplus))
28
+ - Add more WinRM timeout config options [\#1493](https://github.com/test-kitchen/test-kitchen/pull/1493) ([dwoz](https://github.com/dwoz))
29
+ - Adding rake task for doc deployment [\#1492](https://github.com/test-kitchen/test-kitchen/pull/1492) ([cheeseplus](https://github.com/cheeseplus))
30
+ - Rename page and minor formatting fixes [\#1491](https://github.com/test-kitchen/test-kitchen/pull/1491) ([cheeseplus](https://github.com/cheeseplus))
31
+ - Fixing the doc for chef provisioners [\#1490](https://github.com/test-kitchen/test-kitchen/pull/1490) ([cheeseplus](https://github.com/cheeseplus))
32
+ - Add docs for fixtures and lifecycle hooks [\#1489](https://github.com/test-kitchen/test-kitchen/pull/1489) ([cheeseplus](https://github.com/cheeseplus))
33
+ - Fix \#1454 - add reboot doc [\#1488](https://github.com/test-kitchen/test-kitchen/pull/1488) ([cheeseplus](https://github.com/cheeseplus))
34
+ - Updating for chefstyle 0.11 [\#1487](https://github.com/test-kitchen/test-kitchen/pull/1487) ([cheeseplus](https://github.com/cheeseplus))
35
+ - Add Docs for Shell Provisioner [\#1486](https://github.com/test-kitchen/test-kitchen/pull/1486) ([pwelch](https://github.com/pwelch))
36
+ - Add retry support for WinRM [\#1480](https://github.com/test-kitchen/test-kitchen/pull/1480) ([bdwyertech](https://github.com/bdwyertech))
37
+ - DOCS - improve documentation language [\#1479](https://github.com/test-kitchen/test-kitchen/pull/1479) ([JohnVonNeumann](https://github.com/JohnVonNeumann))
38
+ - Acknowledge the existence of kitchen-azurerm and add an example configuration [\#1466](https://github.com/test-kitchen/test-kitchen/pull/1466) ([stuartpreston](https://github.com/stuartpreston))
39
+ - Middleman -\> Hugo conversion [\#1459](https://github.com/test-kitchen/test-kitchen/pull/1459) ([cheeseplus](https://github.com/cheeseplus))
40
+ - Docs merge [\#1450](https://github.com/test-kitchen/test-kitchen/pull/1450) ([cheeseplus](https://github.com/cheeseplus))
41
+ - Support cookbook root aliases and VERSION file [\#1446](https://github.com/test-kitchen/test-kitchen/pull/1446) ([cheeseplus](https://github.com/cheeseplus))
42
+
3
43
  ## [v1.23.2](https://github.com/test-kitchen/test-kitchen/tree/v1.23.2) (2018-08-06)
4
44
  [Full Changelog](https://github.com/test-kitchen/test-kitchen/compare/v1.23.0...v1.23.2)
5
45
 
@@ -10,7 +10,7 @@ receive a veto from the Lieutenant or the Project Lead.
10
10
  * [Fletcher Nichol](https://github.com/fnichol)
11
11
 
12
12
  ## Lieutenants
13
- * [Seth Thomas](https://github.com/cheeseplus)
13
+ * [Tyler Ball](https://github.com/tyler-ball)
14
14
 
15
15
  ## Maintainers
16
16
 
@@ -23,6 +23,7 @@ receive a veto from the Lieutenant or the Project Lead.
23
23
  * [Noah Kantrowitz](https://github.com/coderanger)
24
24
  * [Robb Kidd](https://github.com/robbkidd)
25
25
  * [Sean Omeara](http://github.com/someara)
26
+ * [Seth Thomas](https://github.com/cheeseplus)
26
27
  * [Steven Murawski](http://github.com/smurawski)
27
28
  * [Salim Afiune](http://github.com/afiune)
28
29
  * [Tim Smith](http://github.com/tas50)
data/Rakefile CHANGED
@@ -66,3 +66,12 @@ rescue LoadError
66
66
  puts "github_changelog_generator is not available." \
67
67
  " (sudo) gem install github_changelog_generator to generate changelogs"
68
68
  end
69
+
70
+ namespace :docs do
71
+ desc "Deploy docs"
72
+ task :deploy do
73
+ sh "cd docs && hugo"
74
+ sh "aws --profile chef-cd s3 sync docs/public s3://test-kitchen-legacy.cd.chef.co --delete --acl public-read"
75
+ sh "aws --profile chef-cd cloudfront create-invalidation --distribution-id EQD8MRW086SRT --paths '/*'"
76
+ end
77
+ end
@@ -0,0 +1,8 @@
1
+ ## Contributing
2
+
3
+ 1. Visit [#kitchenci](http://webchat.freenode.net/?channels=kitchenci) on Freenode IRC to discuss
4
+ 2. Fork https://github.com/test-kitchen/kitchen-docs
5
+ 3. Create your feature branch (`git checkout -b new-docs`)
6
+ 4. Commit your changes (`git commit -am 'Added some new documentation'`)
7
+ 5. Push your feature branch (`git push origin new-docs`)
8
+ 6. Create a Pull Request
@@ -0,0 +1,22 @@
1
+ Copyright (c) 2013 Fletcher Nichol
2
+
3
+ MIT License
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining
6
+ a copy of this software and associated documentation files (the
7
+ "Software"), to deal in the Software without restriction, including
8
+ without limitation the rights to use, copy, modify, merge, publish,
9
+ distribute, sublicense, and/or sell copies of the Software, and to
10
+ permit persons to whom the Software is furnished to do so, subject to
11
+ the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be
14
+ included in all copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
20
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,78 @@
1
+ Documentation for KitchenCI.
2
+
3
+ ## Overview
4
+
5
+ To preview the documentation in your browser run the following:
6
+
7
+ ~~~ shell
8
+ bundle install
9
+ bundle exec middleman server
10
+ ~~~
11
+
12
+ While the Getting Started guide is written in primarily [Markdown][markdown] a few pages use [Slim](http://slim-lang.com/), an HTML templating engine for Ruby.
13
+
14
+ Then go view the docs at [http://localhost:4567](http://localhost:4567). Edits to the documentation source files should cause the `middleman` server to reload so you can see your changes update live.
15
+
16
+ ## Hosting
17
+
18
+ All documentation will be hosted on the official Kitchen website (http://kitchen.ci), which is a static site built with [Middleman][middleman].
19
+
20
+ The important parts to familiarize yourself with for contributing to the KitchenCI documentation are the markdown renderer and syntax highlighting engines used to power http://kitchen.ci.
21
+
22
+ Markdown rendering is handled by [kramdown][kramdown]. It would be worth your while to briefly review the kramdown documentation as there are some subtle differences (as well as a number of helpful extensions) that deviate from the Markdown standard.
23
+
24
+ Syntax Highlighting is handled by [middleman-syntax][syntax], which uses [Rouge][rouge], which is a ruby-based syntax highlighting engine that is compatible with [Pygments][pygments] templates and supports things like "fenced code blocks" and language-specific syntax highlighting from Markdown.
25
+
26
+ ## Style Guide
27
+
28
+ There are four elements that may be used for "styling" the docs content: in-line code highlighting, code blocks, blockquotes, and a special hack around markdown tables that we'll use for what we call "Pro-Tips".
29
+
30
+ ### In-line Code Highlighting
31
+
32
+ To highlight `some code` inline with other content, just "quote" the text using backtick characters (`). See [the kramdown documentation](http://kramdown.gettalong.org/syntax.html#code-spans) for more details.
33
+
34
+ ### Fenced Code Blocks
35
+
36
+ To highlight a block of code, start and finish the block with three or more tilde characters (`~`). To enable syntax-highlighting, just indicate the code language after the tildes on the first line.
37
+
38
+ For example, this code:
39
+
40
+ ~~~yaml
41
+ ---
42
+ title: "KitchenCI Overview"
43
+ next:
44
+ url: installing-kitchen
45
+ text: "Installing KitchenCI"
46
+ ---
47
+ ~~~
48
+
49
+ ...will yield this output:
50
+
51
+ ~~~~yaml
52
+ ---
53
+ title: "KitchenCI Overview"
54
+ next:
55
+ url: installing-kitchen
56
+ text: "Installing KitchenCI"
57
+ ---
58
+ ~~~~
59
+
60
+ See [the kramdown documentation](http://kramdown.gettalong.org/syntax.html#fenced-code-blocks) for more information.
61
+
62
+ ### Blockquotes
63
+
64
+ To draw attention to some content with a blockquote, just start the line(s) with a `>` (right angle bracket / greater than symbol). See [the kramdown documentation](http://kramdown.gettalong.org/syntax.html#blockquotes) for more information.
65
+
66
+ ## License
67
+ The Kitchen Documentation is released under the [MIT license][mit-license].
68
+
69
+
70
+ [markdown]: http://daringfireball.net/projects/markdown/syntax
71
+ [kitchenci]: http://kitchen.ci
72
+ [middleman]: http://middlemanapp.com
73
+ [pages]: http://pages.github.com/
74
+ [kramdown]: http://kramdown.gettalong.org/
75
+ [syntax]: https://github.com/middleman/middleman-syntax
76
+ [rouge]: https://github.com/jayferd/rouge
77
+ [pygments]: http://pygments.org/
78
+ [mit-license]: MIT-LICENSE.txt
@@ -0,0 +1,6 @@
1
+ ---
2
+ title: "{{ replace .Name "-" " " | title }}"
3
+ date: {{ .Date }}
4
+ draft: true
5
+ ---
6
+
@@ -0,0 +1,36 @@
1
+ baseURL = "/"
2
+ languageCode = "en-us"
3
+ title = "Kitchen Documentation"
4
+ theme = "kitchen"
5
+ pygmentsCodeFences = true
6
+
7
+ [params]
8
+ enable_search = true # set to true to show search bar
9
+
10
+ [outputs]
11
+ home = [ "HTML", "RSS", "JSON"]
12
+
13
+ [[menu.docs]]
14
+ identifier = "getting_started"
15
+ name = "Getting Started"
16
+ weight = 5
17
+
18
+ [[menu.docs]]
19
+ identifier = "drivers"
20
+ name = "Drivers"
21
+ weight = 10
22
+
23
+ [[menu.docs]]
24
+ identifier = "provisioners"
25
+ name = "Provisioners"
26
+ weight = 15
27
+
28
+ [[menu.docs]]
29
+ identifier = "verifiers"
30
+ name = "Verifiers"
31
+ weight = 20
32
+
33
+ [[menu.docs]]
34
+ identifier = "reference"
35
+ name = "Reference"
36
+ weight = 50
@@ -0,0 +1,5 @@
1
+ ---
2
+ title: "Docs"
3
+ layout: redirect
4
+ redirect_url: /docs/getting-started
5
+ ---
@@ -0,0 +1,27 @@
1
+ ---
2
+ title: Drivers
3
+ menu:
4
+ docs:
5
+ parent: drivers
6
+ weight: 10
7
+ ---
8
+
9
+ A Test-Kitchen *driver* is what supports configuring the compute instance that is used for isolated testing. This is typically a local hypervisor, hypervisor abstraction layer (Vagrant), or cloud service (EC2).
10
+
11
+ ChefDK / Chef Workstation include:
12
+
13
+ * [kitchen-vagrant](https://github.com/test-kitchen/kitchen-vagrant)
14
+ * [kitchen-ec2](https://github.com/test-kitchen/kitchen-ec2)
15
+ * [kitchen-digitalocean](https://github.com/test-kitchen/kitchen-digitalocean)
16
+ * [kitchen-dokken](https://github.com/someara/kitchen-dokken)
17
+ * [kitchen-google](https://github.com/test-kitchen/kitchen-google)
18
+ * [kitchen-hyperv](https://github.com/test-kitchen/kitchen-hyperv)
19
+ * [kitchen-azurerm](https://github.com/test-kitchen/kitchen-azurerm)
20
+
21
+ Community Drivers:
22
+
23
+ * [kitchen-docker](https://github.com/test-kitchen/kitchen-docker)
24
+ * [kitchen-openstack](https://github.com/test-kitchen/kitchen-openstack)
25
+ * [kitchen-terraform](https://github.com/newcontext-oss/kitchen-terraform)
26
+
27
+ There are other drivers that have existed over the life of test-kitchen that we do not list here, either because they are un-maintained or have been supplanted by other drivers.
@@ -0,0 +1,44 @@
1
+ ---
2
+ title: AzureRM
3
+ menu:
4
+ docs:
5
+ parent: drivers
6
+ weight: 15
7
+ ---
8
+
9
+ kitchen-azurerm is a Test Kitchen *driver* for Microsoft Azure. A full example reference can be found [here](https://github.com/test-kitchen/kitchen-azurerm#kitchenyml-example-1---linuxubuntu).
10
+
11
+ Example **kitchen.yml**:
12
+
13
+ ```
14
+ ---
15
+ driver:
16
+ name: azurerm
17
+ subscription_id: '4801fa9d-YOUR-GUID-HERE-b265ff49ce21'
18
+ location: 'West Europe'
19
+ machine_size: 'Standard_D2_V2'
20
+
21
+ provisioner:
22
+ name: chef_zero
23
+ retry_on_exit_code:
24
+ - 20
25
+ - 35
26
+ max_retries: 10
27
+ wait_for_retry: 180
28
+ client_rb:
29
+ exit_status: :enabled
30
+
31
+ platforms:
32
+ - name: windows2016
33
+ driver:
34
+ image_urn: MicrosoftWindowsServer:WindowsServer:2016-Datacenter:latest
35
+ transport:
36
+ name: winrm
37
+ elevated: true
38
+
39
+ suites:
40
+ - name: default
41
+ run_list:
42
+ - recipe[mycookbook::default]
43
+ attributes:
44
+ ```
@@ -0,0 +1,39 @@
1
+ ---
2
+ title: Vagrant
3
+ menu:
4
+ docs:
5
+ parent: drivers
6
+ weight: 15
7
+ ---
8
+
9
+ Full example reference can be found [here](https://github.com/test-kitchen/kitchen-vagrant/blob/master/example/kitchen.vagrant.yml)
10
+
11
+
12
+ ```
13
+ ---
14
+ driver:
15
+ name: vagrant
16
+ provider: virtualbox
17
+
18
+ provisioner:
19
+ name: chef_zero
20
+
21
+ verifier:
22
+ name: inspec
23
+
24
+ platforms:
25
+ - name: ubuntu-16.04
26
+ - name: centos-7
27
+ - name: openbsd-5.6
28
+ driver:
29
+ box: openbsd-5.6
30
+ box_url: http://url.tld/openbsd-5.6.box
31
+
32
+ suites:
33
+ - name: default
34
+ attributes:
35
+ cookbook:
36
+ attribute: 'value'
37
+ run_list:
38
+ - recipe[cookbook::default]
39
+ ```
@@ -0,0 +1,14 @@
1
+ ---
2
+ title: "Introduction"
3
+ slug: introduction
4
+ menu:
5
+ docs:
6
+ parent: getting_started
7
+ weight: 1
8
+ ---
9
+
10
+ The best way to understand what kitchen does is to see it in action so we're going to use it to help us write a simple Chef cookbook. This cookbook will be complete with tests that verify the cookbook does what it's supposed to do. Kitchen comes at the process of software development with an approach that embraces the idea that writing the tests *first*, watching them fail, and then writing the code to make them pass is a great way to go. Also known as *red, green, refactor*, it's a great way to write quality software. By the end of this guide, you'll be familiar with this approach.
11
+
12
+ <div class="sidebar--footer">
13
+ <a class="button primary-cta" href="/docs/getting-started/installing">Next - Installing</a>
14
+ </div>
@@ -0,0 +1,64 @@
1
+ ---
2
+ title: "Installing"
3
+ slug: installing
4
+ menu:
5
+ docs:
6
+ parent: getting_started
7
+ weight: 10
8
+ ---
9
+
10
+ As this is a quick start guide, it doesn't assume any great familiarity with Chef or Ruby and takes you through the process of writing a Chef cookbook with automated testing as standard. In order to follow this guide, we'll need a few tools first.
11
+
12
+ ##### Pre-requisites
13
+
14
+ - 64 bit operating system
15
+ - CPU Virtualization enabled
16
+
17
+ In order to virtualize a 64 bit operating system, one must also be running a 64 bit operating system. Most importantly, the CPU itself must support hardware virtualization extensions and this must be enabled in the BIOS/EFI. Most modern processors support virtualization extensions in the form of VT-x (Intel) or AMD-V (AMD).
18
+
19
+ <div class="callout">
20
+ <h3 class="callout--title">Windows and Hyper-V</h3>
21
+ Unfortunately Hyper-V doesn't like other hypervisors running at the same time and it must be disabled as a Windows Feature for VirtualBox to function properly.
22
+ </div>
23
+
24
+ ##### ChefDK
25
+
26
+ First, install the [ChefDK](https://downloads.chef.io/chefdk). This package includes Chef, Kitchen, Berkshelf, and a variety of useful tools for the Chef ecosystem.
27
+
28
+ ~~~
29
+ $ chef --version
30
+ Chef Development Kit Version: 3.2.30
31
+ chef-client version: 14.4.56
32
+ delivery version: master (6862f27aba89109a9630f0b6c6798efec56b4efe)
33
+ berks version: 7.0.6
34
+ kitchen version: 1.23.2
35
+ inspec version: 2.2.70
36
+ ~~~
37
+
38
+ ##### VirtualBox
39
+
40
+ VirtualBox is a hypervisor that lets you run virtual machines on your local workstation. Obtain the correct installer for your platform [here](https://www.virtualbox.org/wiki/Downloads). Verify that the command is accessible and in the $PATH with the following:
41
+
42
+ ~~~
43
+ $ VBoxManage --version
44
+ 5.2.18r124319
45
+ ~~~
46
+
47
+ ##### Vagrant
48
+
49
+ Vagrant manages hypervisors such as VirtualBox and makes it easy to distribute pre-packaged virtual machines, known as "boxes". Obtain the correct installer for your platform [here](https://www.vagrantup.com/downloads.html).
50
+
51
+ ~~~
52
+ $ vagrant --version
53
+ Vagrant 2.1.5
54
+ ~~~
55
+
56
+ We've just installed ChefDK, VirtualBox, and Vagrant. The reason we have done so is that the default `driver` for test-kitchen is `kitchen-vagrant` which uses Vagrant to create, manage, and destroy local virtual machines. Vagrant itself supports many different hypervisors and clouds but for the purposes of this exercise we are interested in the default local virtualization provided by VirtualBox.
57
+
58
+ Kitchen is modular so that one may use a variety of different drivers (Vagrant, EC2, Docker), provisioners (Chef, Ansible, Puppet), or verifiers (InSpec, Serverspec, BATS) but for the purposes of the guide we're focusing on the default "happy path" of Vagrant with VirtualBox, Chef, and InSpec.
59
+
60
+
61
+ <div class="sidebar--footer">
62
+ <a class="button primary-cta" href="/docs/getting-started/getting-help">Next - Getting Help</a>
63
+ <a class="sidebar--footer--back" href="/docs/getting-started/">Back to previous step</a>
64
+ </div>