chef 13.11.3 → 13.12.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (261) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +4 -3
  3. data/README.md +35 -40
  4. data/Rakefile +18 -22
  5. data/chef-universal-mingw32.gemspec +1 -1
  6. data/chef.gemspec +3 -3
  7. data/lib/chef/client.rb +1 -1
  8. data/lib/chef/mixin/params_validate.rb +3 -1
  9. data/lib/chef/provider/script.rb +2 -2
  10. data/lib/chef/version.rb +1 -1
  11. data/spec/functional/http/simple_spec.rb +12 -6
  12. data/spec/functional/resource/remote_file_spec.rb +19 -15
  13. data/spec/support/platform_helpers.rb +2 -1
  14. data/tasks/announce.rb +1 -1
  15. data/tasks/dependencies.rb +5 -39
  16. data/tasks/maintainers.rb +10 -10
  17. data/tasks/rspec.rb +2 -2
  18. data/tasks/templates/prerelease.md.erb +11 -2
  19. data/tasks/templates/release.md.erb +9 -1
  20. metadata +6 -248
  21. data/CONTRIBUTING.md +0 -151
  22. data/VERSION +0 -1
  23. data/acceptance/.gitignore +0 -3
  24. data/acceptance/.shared/kitchen_acceptance/.kitchen.digitalocean.yml +0 -33
  25. data/acceptance/.shared/kitchen_acceptance/.kitchen.ec2.yml +0 -283
  26. data/acceptance/.shared/kitchen_acceptance/.kitchen.vagrant.yml +0 -59
  27. data/acceptance/.shared/kitchen_acceptance/libraries/kitchen.rb +0 -68
  28. data/acceptance/.shared/kitchen_acceptance/metadata.rb +0 -1
  29. data/acceptance/Gemfile +0 -19
  30. data/acceptance/Gemfile.lock +0 -266
  31. data/acceptance/README.md +0 -137
  32. data/acceptance/basics/.acceptance/acceptance-cookbook/.gitignore +0 -2
  33. data/acceptance/basics/.acceptance/acceptance-cookbook/metadata.rb +0 -3
  34. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  35. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  36. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  37. data/acceptance/basics/.kitchen.yml +0 -4
  38. data/acceptance/basics/test/integration/chef-current-install/serverspec/chef_client_spec.rb +0 -19
  39. data/acceptance/basics/test/integration/chef-current-install/serverspec/spec_helper.rb +0 -6
  40. data/acceptance/basics/test/integration/helpers/serverspec/Gemfile +0 -8
  41. data/acceptance/data-collector/.acceptance/acceptance-cookbook/.gitignore +0 -2
  42. data/acceptance/data-collector/.acceptance/acceptance-cookbook/metadata.rb +0 -3
  43. data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -2
  44. data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -2
  45. data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -2
  46. data/acceptance/data-collector/.acceptance/data-collector-test/.gitignore +0 -16
  47. data/acceptance/data-collector/.acceptance/data-collector-test/Berksfile +0 -3
  48. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/api.rb +0 -101
  49. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/apigemfile +0 -3
  50. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-both-mode.rb +0 -4
  51. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-client-mode.rb +0 -4
  52. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-no-endpoint.rb +0 -2
  53. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-solo-mode.rb +0 -4
  54. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/config.ru +0 -2
  55. data/acceptance/data-collector/.acceptance/data-collector-test/metadata.rb +0 -7
  56. data/acceptance/data-collector/.acceptance/data-collector-test/recipes/default.rb +0 -44
  57. data/acceptance/data-collector/.kitchen.yml +0 -9
  58. data/acceptance/data-collector/Berksfile +0 -3
  59. data/acceptance/data-collector/test/integration/default/serverspec/default_spec.rb +0 -208
  60. data/acceptance/data-collector/test/integration/helpers/serverspec/Gemfile +0 -8
  61. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/.gitignore +0 -2
  62. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/metadata.rb +0 -1
  63. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  64. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  65. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -61
  66. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/.gitignore +0 -2
  67. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/cookbook_kitchen.rb +0 -43
  68. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/top_cookbooks.rb +0 -41
  69. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/metadata.rb +0 -3
  70. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  71. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  72. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  73. data/acceptance/top-cookbooks/.gitignore +0 -1
  74. data/acceptance/top-cookbooks/.kitchen.chocolatey.yml +0 -6
  75. data/acceptance/top-cookbooks/.kitchen.iis.yml +0 -4
  76. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-rhel.yml +0 -7
  77. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-ubuntu.yml +0 -7
  78. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-windows.yml +0 -7
  79. data/acceptance/top-cookbooks/.kitchen.powershell.yml +0 -4
  80. data/acceptance/top-cookbooks/.kitchen.sql_server.yml +0 -5
  81. data/acceptance/top-cookbooks/.kitchen.winbox.yml +0 -8
  82. data/acceptance/top-cookbooks/.kitchen.windows.yml +0 -38
  83. data/acceptance/trivial/.acceptance/acceptance-cookbook/.gitignore +0 -2
  84. data/acceptance/trivial/.acceptance/acceptance-cookbook/metadata.rb +0 -2
  85. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  86. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  87. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  88. data/acceptance/trivial/.kitchen.yml +0 -7
  89. data/acceptance/trivial/test/integration/chef-current-install/inspec/chef_client_spec.rb +0 -5
  90. data/acceptance/windows-service/.acceptance/acceptance-cookbook/.gitignore +0 -2
  91. data/acceptance/windows-service/.acceptance/acceptance-cookbook/metadata.rb +0 -2
  92. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  93. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  94. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  95. data/acceptance/windows-service/.kitchen.yml +0 -7
  96. data/acceptance/windows-service/test/integration/chef-windows-service/inspec/chef_windows_service_spec.rb +0 -58
  97. data/distro/common/html/_sources/ctl_chef_client.txt +0 -36
  98. data/distro/common/html/_sources/ctl_chef_server.txt +0 -341
  99. data/distro/common/html/_sources/ctl_chef_shell.txt +0 -15
  100. data/distro/common/html/_sources/ctl_chef_solo.txt +0 -25
  101. data/distro/common/html/_sources/index.txt +0 -135
  102. data/distro/common/html/_sources/knife.txt +0 -74
  103. data/distro/common/html/_sources/knife_bootstrap.txt +0 -56
  104. data/distro/common/html/_sources/knife_client.txt +0 -151
  105. data/distro/common/html/_sources/knife_common_options.txt +0 -6
  106. data/distro/common/html/_sources/knife_configure.txt +0 -29
  107. data/distro/common/html/_sources/knife_cookbook.txt +0 -236
  108. data/distro/common/html/_sources/knife_cookbook_site.txt +0 -157
  109. data/distro/common/html/_sources/knife_data_bag.txt +0 -160
  110. data/distro/common/html/_sources/knife_delete.txt +0 -26
  111. data/distro/common/html/_sources/knife_deps.txt +0 -61
  112. data/distro/common/html/_sources/knife_diff.txt +0 -34
  113. data/distro/common/html/_sources/knife_download.txt +0 -44
  114. data/distro/common/html/_sources/knife_edit.txt +0 -26
  115. data/distro/common/html/_sources/knife_environment.txt +0 -158
  116. data/distro/common/html/_sources/knife_exec.txt +0 -47
  117. data/distro/common/html/_sources/knife_index_rebuild.txt +0 -21
  118. data/distro/common/html/_sources/knife_list.txt +0 -33
  119. data/distro/common/html/_sources/knife_node.txt +0 -250
  120. data/distro/common/html/_sources/knife_raw.txt +0 -35
  121. data/distro/common/html/_sources/knife_recipe_list.txt +0 -23
  122. data/distro/common/html/_sources/knife_role.txt +0 -157
  123. data/distro/common/html/_sources/knife_search.txt +0 -53
  124. data/distro/common/html/_sources/knife_serve.txt +0 -19
  125. data/distro/common/html/_sources/knife_show.txt +0 -27
  126. data/distro/common/html/_sources/knife_ssh.txt +0 -43
  127. data/distro/common/html/_sources/knife_ssl_check.txt +0 -41
  128. data/distro/common/html/_sources/knife_ssl_fetch.txt +0 -41
  129. data/distro/common/html/_sources/knife_status.txt +0 -37
  130. data/distro/common/html/_sources/knife_tag.txt +0 -69
  131. data/distro/common/html/_sources/knife_upload.txt +0 -49
  132. data/distro/common/html/_sources/knife_user.txt +0 -127
  133. data/distro/common/html/_sources/knife_using.txt +0 -43
  134. data/distro/common/html/_sources/knife_xargs.txt +0 -30
  135. data/distro/common/html/_static/ajax-loader.gif +0 -0
  136. data/distro/common/html/_static/basic.css +0 -537
  137. data/distro/common/html/_static/chef.ico +0 -0
  138. data/distro/common/html/_static/chef_html_logo.png +0 -0
  139. data/distro/common/html/_static/comment-bright.png +0 -0
  140. data/distro/common/html/_static/comment-close.png +0 -0
  141. data/distro/common/html/_static/comment.png +0 -0
  142. data/distro/common/html/_static/contents.png +0 -0
  143. data/distro/common/html/_static/doctools.js +0 -238
  144. data/distro/common/html/_static/down-pressed.png +0 -0
  145. data/distro/common/html/_static/down.png +0 -0
  146. data/distro/common/html/_static/file.png +0 -0
  147. data/distro/common/html/_static/guide.css +0 -505
  148. data/distro/common/html/_static/jquery.js +0 -2
  149. data/distro/common/html/_static/minus.png +0 -0
  150. data/distro/common/html/_static/navigation.png +0 -0
  151. data/distro/common/html/_static/plus.png +0 -0
  152. data/distro/common/html/_static/pygments.css +0 -62
  153. data/distro/common/html/_static/searchtools.js +0 -622
  154. data/distro/common/html/_static/underscore.js +0 -31
  155. data/distro/common/html/_static/up-pressed.png +0 -0
  156. data/distro/common/html/_static/up.png +0 -0
  157. data/distro/common/html/_static/websupport.js +0 -808
  158. data/distro/common/html/ctl_chef_client.html +0 -270
  159. data/distro/common/html/ctl_chef_server.html +0 -728
  160. data/distro/common/html/ctl_chef_shell.html +0 -163
  161. data/distro/common/html/ctl_chef_solo.html +0 -194
  162. data/distro/common/html/index.html +0 -202
  163. data/distro/common/html/knife.html +0 -170
  164. data/distro/common/html/knife_bootstrap.html +0 -285
  165. data/distro/common/html/knife_client.html +0 -285
  166. data/distro/common/html/knife_common_options.html +0 -96
  167. data/distro/common/html/knife_configure.html +0 -105
  168. data/distro/common/html/knife_cookbook.html +0 -487
  169. data/distro/common/html/knife_cookbook_site.html +0 -375
  170. data/distro/common/html/knife_data_bag.html +0 -374
  171. data/distro/common/html/knife_delete.html +0 -93
  172. data/distro/common/html/knife_deps.html +0 -143
  173. data/distro/common/html/knife_diff.html +0 -123
  174. data/distro/common/html/knife_download.html +0 -145
  175. data/distro/common/html/knife_edit.html +0 -89
  176. data/distro/common/html/knife_environment.html +0 -322
  177. data/distro/common/html/knife_exec.html +0 -220
  178. data/distro/common/html/knife_index_rebuild.html +0 -83
  179. data/distro/common/html/knife_list.html +0 -114
  180. data/distro/common/html/knife_node.html +0 -458
  181. data/distro/common/html/knife_raw.html +0 -110
  182. data/distro/common/html/knife_recipe_list.html +0 -91
  183. data/distro/common/html/knife_role.html +0 -295
  184. data/distro/common/html/knife_search.html +0 -203
  185. data/distro/common/html/knife_serve.html +0 -79
  186. data/distro/common/html/knife_show.html +0 -104
  187. data/distro/common/html/knife_ssh.html +0 -177
  188. data/distro/common/html/knife_ssl_check.html +0 -151
  189. data/distro/common/html/knife_ssl_fetch.html +0 -151
  190. data/distro/common/html/knife_status.html +0 -144
  191. data/distro/common/html/knife_tag.html +0 -138
  192. data/distro/common/html/knife_upload.html +0 -153
  193. data/distro/common/html/knife_user.html +0 -242
  194. data/distro/common/html/knife_using.html +0 -210
  195. data/distro/common/html/knife_xargs.html +0 -122
  196. data/distro/common/html/objects.inv +0 -0
  197. data/distro/common/html/search.html +0 -82
  198. data/distro/common/html/searchindex.js +0 -1
  199. data/distro/common/man/man1/README.md +0 -58
  200. data/distro/common/man/man1/chef-shell.1 +0 -194
  201. data/distro/common/man/man1/knife-bootstrap.1 +0 -215
  202. data/distro/common/man/man1/knife-client.1 +0 -443
  203. data/distro/common/man/man1/knife-configure.1 +0 -161
  204. data/distro/common/man/man1/knife-cookbook-site.1 +0 -552
  205. data/distro/common/man/man1/knife-cookbook.1 +0 -770
  206. data/distro/common/man/man1/knife-data-bag.1 +0 -617
  207. data/distro/common/man/man1/knife-delete.1 +0 -127
  208. data/distro/common/man/man1/knife-deps.1 +0 -246
  209. data/distro/common/man/man1/knife-diff.1 +0 -226
  210. data/distro/common/man/man1/knife-download.1 +0 -258
  211. data/distro/common/man/man1/knife-edit.1 +0 -121
  212. data/distro/common/man/man1/knife-environment.1 +0 -496
  213. data/distro/common/man/man1/knife-exec.1 +0 -362
  214. data/distro/common/man/man1/knife-index-rebuild.1 +0 -63
  215. data/distro/common/man/man1/knife-list.1 +0 -174
  216. data/distro/common/man/man1/knife-node.1 +0 -716
  217. data/distro/common/man/man1/knife-raw.1 +0 -172
  218. data/distro/common/man/man1/knife-recipe-list.1 +0 -85
  219. data/distro/common/man/man1/knife-role.1 +0 -426
  220. data/distro/common/man/man1/knife-search.1 +0 -359
  221. data/distro/common/man/man1/knife-serve.1 +0 -109
  222. data/distro/common/man/man1/knife-show.1 +0 -160
  223. data/distro/common/man/man1/knife-ssh.1 +0 -284
  224. data/distro/common/man/man1/knife-ssl-check.1 +0 -207
  225. data/distro/common/man/man1/knife-ssl-fetch.1 +0 -207
  226. data/distro/common/man/man1/knife-status.1 +0 -234
  227. data/distro/common/man/man1/knife-tag.1 +0 -189
  228. data/distro/common/man/man1/knife-upload.1 +0 -280
  229. data/distro/common/man/man1/knife-user.1 +0 -356
  230. data/distro/common/man/man1/knife-xargs.1 +0 -189
  231. data/distro/common/man/man1/knife.1 +0 -332
  232. data/distro/common/man/man8/chef-apply.8 +0 -86
  233. data/distro/common/man/man8/chef-client.8 +0 -398
  234. data/distro/common/man/man8/chef-solo.8 +0 -260
  235. data/distro/common/markdown/README +0 -3
  236. data/distro/common/markdown/man1/chef-shell.mkd +0 -195
  237. data/distro/common/markdown/man1/knife-bootstrap.mkd +0 -141
  238. data/distro/common/markdown/man1/knife-client.mkd +0 -103
  239. data/distro/common/markdown/man1/knife-configure.mkd +0 -71
  240. data/distro/common/markdown/man1/knife-cookbook-site.mkd +0 -123
  241. data/distro/common/markdown/man1/knife-cookbook.mkd +0 -263
  242. data/distro/common/markdown/man1/knife-data-bag.mkd +0 -121
  243. data/distro/common/markdown/man1/knife-environment.mkd +0 -151
  244. data/distro/common/markdown/man1/knife-exec.mkd +0 -42
  245. data/distro/common/markdown/man1/knife-index.mkd +0 -30
  246. data/distro/common/markdown/man1/knife-node.mkd +0 -130
  247. data/distro/common/markdown/man1/knife-role.mkd +0 -85
  248. data/distro/common/markdown/man1/knife-search.mkd +0 -180
  249. data/distro/common/markdown/man1/knife-ssh.mkd +0 -69
  250. data/distro/common/markdown/man1/knife-status.mkd +0 -36
  251. data/distro/common/markdown/man1/knife-tag.mkd +0 -39
  252. data/distro/common/markdown/man1/knife.mkd +0 -213
  253. data/distro/common/markdown/man8/chef-client.mkd +0 -75
  254. data/distro/common/markdown/man8/chef-expander.mkd +0 -81
  255. data/distro/common/markdown/man8/chef-expanderctl.mkd +0 -57
  256. data/distro/common/markdown/man8/chef-server-webui.mkd +0 -121
  257. data/distro/common/markdown/man8/chef-server.mkd +0 -120
  258. data/distro/common/markdown/man8/chef-solo.mkd +0 -107
  259. data/distro/common/markdown/man8/chef-solr.mkd +0 -89
  260. data/distro/powershell/chef/chef.psm1 +0 -459
  261. data/tasks/cbgb.rb +0 -84
@@ -1,74 +0,0 @@
1
- =====================================================
2
- knife
3
- =====================================================
4
-
5
- .. include:: ../../includes_knife/includes_knife.rst
6
-
7
- The following sections describe functionality common to all |knife| subcommands:
8
-
9
- * :doc:`knife_using`
10
- * :doc:`knife_common_options`
11
-
12
- |knife| includes the following sub-commands:
13
-
14
- .. list-table::
15
- :widths: 150 450
16
- :header-rows: 1
17
-
18
- * - Sub-command
19
- - Description
20
- * - :doc:`knife_bootstrap`
21
- - .. include:: ../../includes_knife/includes_knife_bootstrap.rst
22
- * - :doc:`knife_client`
23
- - .. include:: ../../includes_knife/includes_knife_client.rst
24
- * - :doc:`knife_configure`
25
- - .. include:: ../../includes_knife/includes_knife_configure.rst
26
- * - :doc:`knife_cookbook`
27
- - .. include:: ../../includes_knife/includes_knife_cookbook.rst
28
- * - :doc:`knife_cookbook_site`
29
- - .. include:: ../../includes_knife/includes_knife_site_cookbook.rst
30
- * - :doc:`knife_data_bag`
31
- - .. include:: ../../includes_knife/includes_knife_data_bag.rst
32
- * - :doc:`knife_delete`
33
- - .. include:: ../../includes_knife/includes_knife_delete.rst
34
- * - :doc:`knife_deps`
35
- - .. include:: ../../includes_knife/includes_knife_deps.rst
36
- * - :doc:`knife_diff`
37
- - .. include:: ../../includes_knife/includes_knife_diff.rst
38
- * - :doc:`knife_download`
39
- - .. include:: ../../includes_knife/includes_knife_download.rst
40
- * - :doc:`knife_edit`
41
- - .. include:: ../../includes_knife/includes_knife_edit.rst
42
- * - :doc:`knife_environment`
43
- - .. include:: ../../includes_knife/includes_knife_environment.rst
44
- * - :doc:`knife_exec`
45
- - .. include:: ../../includes_knife/includes_knife_exec.rst
46
- * - :doc:`knife_index_rebuild`
47
- - .. include:: ../../includes_knife/includes_knife_index_rebuild.rst
48
- * - :doc:`knife_list`
49
- - .. include:: ../../includes_knife/includes_knife_list.rst
50
- * - :doc:`knife_node`
51
- - .. include:: ../../includes_knife/includes_knife_node.rst
52
- * - :doc:`knife_raw`
53
- - .. include:: ../../includes_knife/includes_knife_raw.rst
54
- * - :doc:`knife_recipe_list`
55
- - .. include:: ../../includes_knife/includes_knife_recipe_list.rst
56
- * - :doc:`knife_role`
57
- - .. include:: ../../includes_knife/includes_knife_role.rst
58
- * - :doc:`knife_search`
59
- - .. include:: ../../includes_knife/includes_knife_search.rst
60
- * - :doc:`knife_show`
61
- - .. include:: ../../includes_knife/includes_knife_show.rst
62
- * - :doc:`knife_ssh`
63
- - .. include:: ../../includes_knife/includes_knife_ssh.rst
64
- * - :doc:`knife_status`
65
- - .. include:: ../../includes_knife/includes_knife_status.rst
66
- * - :doc:`knife_tag`
67
- - .. include:: ../../includes_knife/includes_knife_tag.rst
68
- * - :doc:`knife_upload`
69
- - .. include:: ../../includes_knife/includes_knife_upload.rst
70
- * - :doc:`knife_user`
71
- - .. include:: ../../includes_knife/includes_knife_user.rst
72
- * - :doc:`knife_xargs`
73
- - .. include:: ../../includes_knife/includes_knife_xargs.rst
74
-
@@ -1,56 +0,0 @@
1
- =====================================================
2
- knife bootstrap
3
- =====================================================
4
-
5
- .. include:: ../../includes_chef/includes_chef_bootstrap.rst
6
-
7
- .. include:: ../../includes_knife/includes_knife_bootstrap.rst
8
-
9
- .. note:: To bootstrap the |chef client| on |windows| machines, the `knife-windows <http://docs.opscode.com/plugin_knife_windows.html>`_ plugins is required, which includes the necessary bootstrap scripts that are used to do the actual installation.
10
-
11
- Syntax
12
- =====================================================
13
- .. include:: ../../includes_knife/includes_knife_bootstrap_syntax.rst
14
-
15
- Options
16
- =====================================================
17
- .. note:: Review the list of :doc:`common options </knife_common_options>` available to this (and all) |knife| subcommands and plugins.
18
-
19
- .. include:: ../../release_chef_12-0/includes_knife_bootstrap_options.rst
20
-
21
- Custom Templates
22
- =====================================================
23
- The ``chef-full`` distribution uses the |omnibus installer|. For most bootstrap operations, regardless of the platform on which the target node is running, using the ``chef-full`` distribution is the best approach for installing the |chef client| on a target node. In some situations, using another supported distribution is necessary. And in some situations, a custom template may be required. For example, the default bootstrap operation relies on an Internet connection to get the distribution to the target node. If a target node cannot access the Internet, then a custom template can be used to define a specific location for the distribution so that the target node may access it during the bootstrap operation.
24
-
25
- A custom bootstrap template file (``template_filename.erb``) must be located in a ``bootstrap/`` directory. Use the ``--distro`` option with the ``knife bootstrap`` subcommand to specify the bootstrap template file. For example, a bootstrap template file named "british_sea_power.erb":
26
-
27
- .. code-block:: bash
28
-
29
- $ knife bootstrap 123.456.7.8 -x username -P password --sudo --distro "british_sea_power.erb"
30
-
31
- The following examples show how a bootstrap template file can be customized for various platforms.
32
-
33
- Ubuntu 12.04
34
- -----------------------------------------------------
35
- .. include:: ../../includes_knife/includes_knife_bootstrap_example_ubuntu.rst
36
-
37
- Debian and Apt
38
- -----------------------------------------------------
39
- .. include:: ../../includes_knife/includes_knife_bootstrap_example_debian.rst
40
-
41
- Microsoft Windows
42
- -----------------------------------------------------
43
- .. include:: ../../includes_knife/includes_knife_bootstrap_example_windows.rst
44
-
45
- Examples
46
- =====================================================
47
- The following examples show how to use this |knife| subcommand:
48
-
49
- **Use an SSH password**
50
-
51
- .. include:: ../../step_knife/step_knife_bootstrap_use_ssh_password.rst
52
-
53
- **Use a file that contains a private key**
54
-
55
- .. include:: ../../step_knife/step_knife_bootstrap_use_file_with_private_key.rst
56
-
@@ -1,151 +0,0 @@
1
- =====================================================
2
- knife client
3
- =====================================================
4
-
5
- .. include:: ../../includes_knife/includes_knife_client.rst
6
-
7
- .. note:: Review the list of :doc:`common options </knife_common_options>` available to this (and all) |knife| subcommands and plugins.
8
-
9
- bulk delete
10
- =====================================================
11
- .. include:: ../../includes_knife/includes_knife_client_bulk_delete.rst
12
-
13
- Syntax
14
- -----------------------------------------------------
15
- .. include:: ../../includes_knife/includes_knife_client_bulk_delete_syntax.rst
16
-
17
- Options
18
- -----------------------------------------------------
19
- |no_options|
20
-
21
- Examples
22
- -----------------------------------------------------
23
- None.
24
-
25
- create
26
- =====================================================
27
- .. include:: ../../includes_knife/includes_knife_client_create.rst
28
-
29
- Syntax
30
- -----------------------------------------------------
31
- .. include:: ../../includes_knife/includes_knife_client_create_syntax.rst
32
-
33
- Options
34
- -----------------------------------------------------
35
- .. include:: ../../includes_knife/includes_knife_client_create_options.rst
36
-
37
- Examples
38
- -----------------------------------------------------
39
- The following examples show how to use this |knife| subcommand:
40
-
41
- **Create an admin client**
42
-
43
- .. include:: ../../step_knife/step_knife_client_create_admin.rst
44
-
45
- **Create an admin client for Enterprise Chef**
46
-
47
- .. include:: ../../step_knife/step_knife_client_create_hosted_and_private.rst
48
-
49
- delete
50
- =====================================================
51
- .. include:: ../../includes_knife/includes_knife_client_delete.rst
52
-
53
- Syntax
54
- -----------------------------------------------------
55
- .. include:: ../../includes_knife/includes_knife_client_delete_syntax.rst
56
-
57
- Options
58
- -----------------------------------------------------
59
- |no_options|
60
-
61
- Examples
62
- -----------------------------------------------------
63
- The following examples show how to use this |knife| subcommand:
64
-
65
- **Delete a client**
66
-
67
- .. include:: ../../step_knife/step_knife_client_delete.rst
68
-
69
- edit
70
- =====================================================
71
- .. include:: ../../includes_knife/includes_knife_client_edit.rst
72
-
73
- Syntax
74
- -----------------------------------------------------
75
- .. include:: ../../includes_knife/includes_knife_client_edit_syntax.rst
76
-
77
- Options
78
- -----------------------------------------------------
79
- |no_options|
80
-
81
- Examples
82
- -----------------------------------------------------
83
- The following examples show how to use this |knife| subcommand:
84
-
85
- **Edit a client**
86
-
87
- .. include:: ../../step_knife/step_knife_client_edit.rst
88
-
89
- list
90
- =====================================================
91
- .. include:: ../../includes_knife/includes_knife_client_list.rst
92
-
93
- Syntax
94
- -----------------------------------------------------
95
- .. include:: ../../includes_knife/includes_knife_client_list_syntax.rst
96
-
97
- Options
98
- -----------------------------------------------------
99
- .. include:: ../../includes_knife/includes_knife_client_list_options.rst
100
-
101
- Examples
102
- -----------------------------------------------------
103
- The following examples show how to use this |knife| subcommand:
104
-
105
- **View a list of clients**
106
-
107
- .. include:: ../../step_knife/step_knife_client_list_all.rst
108
-
109
- .. include:: ../../step_knife/step_knife_client_list_authenticate.rst
110
-
111
- reregister
112
- =====================================================
113
- .. include:: ../../includes_knife/includes_knife_client_reregister.rst
114
-
115
- Syntax
116
- -----------------------------------------------------
117
- .. include:: ../../includes_knife/includes_knife_client_reregister_syntax.rst
118
-
119
- Options
120
- -----------------------------------------------------
121
- .. include:: ../../includes_knife/includes_knife_client_reregister_options.rst
122
-
123
- Examples
124
- -----------------------------------------------------
125
- The following examples show how to use this |knife| subcommand:
126
-
127
- **Reregister clients**
128
-
129
- .. include:: ../../step_knife/step_knife_client_reregister.rst
130
-
131
- show
132
- =====================================================
133
- .. include:: ../../includes_knife/includes_knife_client_show.rst
134
-
135
- Syntax
136
- -----------------------------------------------------
137
- .. include:: ../../includes_knife/includes_knife_client_show_syntax.rst
138
-
139
- Options
140
- -----------------------------------------------------
141
- .. include:: ../../includes_knife/includes_knife_client_show_options.rst
142
-
143
- Examples
144
- -----------------------------------------------------
145
- The following examples show how to use this |knife| subcommand:
146
-
147
- **Show clients**
148
-
149
- .. include:: ../../step_knife/step_knife_client_show.rst
150
-
151
- .. include:: ../../step_knife/step_knife_common_view_json.rst
@@ -1,6 +0,0 @@
1
- =====================================================
2
- Common Options
3
- =====================================================
4
-
5
- .. include:: ../../includes_knife/includes_knife_common_options.rst
6
-
@@ -1,29 +0,0 @@
1
- =====================================================
2
- knife configure
3
- =====================================================
4
-
5
- .. include:: ../../includes_knife/includes_knife_configure.rst
6
-
7
- Syntax
8
- =====================================================
9
- .. include:: ../../includes_knife/includes_knife_configure_syntax.rst
10
-
11
- Options
12
- =====================================================
13
- .. note:: Review the list of :doc:`common options </knife_common_options>` available to this (and all) |knife| subcommands and plugins.
14
-
15
- .. include:: ../../includes_knife/includes_knife_configure_options.rst
16
-
17
- Examples
18
- =====================================================
19
- The following examples show how to use this |knife| subcommand:
20
-
21
- **Configure knife.rb**
22
-
23
- .. include:: ../../step_knife/step_knife_configure_knife_rb.rst
24
-
25
- **Configure client.rb**
26
-
27
- .. include:: ../../step_knife/step_knife_configure_client_rb.rst
28
-
29
-
@@ -1,236 +0,0 @@
1
- =====================================================
2
- knife cookbook
3
- =====================================================
4
-
5
- .. include:: ../../includes_cookbooks/includes_cookbooks.rst
6
-
7
- .. include:: ../../includes_knife/includes_knife_cookbook.rst
8
-
9
- .. note:: Review the list of :doc:`common options </knife_common_options>` available to this (and all) |knife| subcommands and plugins.
10
-
11
- bulk delete
12
- =====================================================
13
- .. include:: ../../includes_knife/includes_knife_cookbook_bulk_delete.rst
14
-
15
- Syntax
16
- -----------------------------------------------------
17
- .. include:: ../../includes_knife/includes_knife_cookbook_bulk_delete_syntax.rst
18
-
19
- Options
20
- -----------------------------------------------------
21
- .. include:: ../../includes_knife/includes_knife_cookbook_bulk_delete_options.rst
22
-
23
- Examples
24
- -----------------------------------------------------
25
- The following examples show how to use this |knife| subcommand:
26
-
27
- **Bulk delete many cookbooks**
28
-
29
- .. include:: ../../step_knife/step_knife_cookbook_bulk_delete.rst
30
-
31
-
32
- create
33
- =====================================================
34
- .. include:: ../../includes_knife/includes_knife_cookbook_create.rst
35
-
36
- Syntax
37
- -----------------------------------------------------
38
- .. include:: ../../includes_knife/includes_knife_cookbook_create_syntax.rst
39
-
40
- Options
41
- -----------------------------------------------------
42
- .. include:: ../../includes_knife/includes_knife_cookbook_create_options.rst
43
-
44
- Examples
45
- -----------------------------------------------------
46
- The following examples show how to use this |knife| subcommand:
47
-
48
- **Create a cookbook**
49
-
50
- .. include:: ../../step_knife/step_knife_cookbook_create_with_options.rst
51
-
52
-
53
- delete
54
- =====================================================
55
- .. include:: ../../includes_knife/includes_knife_cookbook_delete.rst
56
-
57
- Syntax
58
- -----------------------------------------------------
59
- .. include:: ../../includes_knife/includes_knife_cookbook_delete_syntax.rst
60
-
61
- Options
62
- -----------------------------------------------------
63
- .. include:: ../../includes_knife/includes_knife_cookbook_delete_options.rst
64
-
65
- Examples
66
- -----------------------------------------------------
67
- The following examples show how to use this |knife| subcommand:
68
-
69
- **Delete a cookbook**
70
-
71
- .. include:: ../../step_knife/step_knife_cookbook_delete.rst
72
-
73
-
74
- download
75
- =====================================================
76
- .. include:: ../../includes_knife/includes_knife_cookbook_download.rst
77
-
78
- Syntax
79
- -----------------------------------------------------
80
- .. include:: ../../includes_knife/includes_knife_cookbook_download_syntax.rst
81
-
82
- Options
83
- -----------------------------------------------------
84
- .. include:: ../../includes_knife/includes_knife_cookbook_download_options.rst
85
-
86
- Examples
87
- -----------------------------------------------------
88
- The following examples show how to use this |knife| subcommand:
89
-
90
- **Download a cookbook**
91
-
92
- .. include:: ../../step_knife/step_knife_cookbook_download.rst
93
-
94
-
95
- list
96
- =====================================================
97
- .. include:: ../../includes_knife/includes_knife_cookbook_list.rst
98
-
99
- Syntax
100
- -----------------------------------------------------
101
- .. include:: ../../includes_knife/includes_knife_cookbook_list_syntax.rst
102
-
103
- Options
104
- -----------------------------------------------------
105
- .. include:: ../../includes_knife/includes_knife_cookbook_list_options.rst
106
-
107
- Examples
108
- -----------------------------------------------------
109
- The following examples show how to use this |knife| subcommand:
110
-
111
- **View a list of cookbooks**
112
-
113
- .. include:: ../../step_knife/step_knife_cookbook_list.rst
114
-
115
-
116
- metadata
117
- =====================================================
118
- .. include:: ../../includes_knife/includes_knife_cookbook_metadata.rst
119
-
120
- Syntax
121
- -----------------------------------------------------
122
- .. include:: ../../includes_knife/includes_knife_cookbook_metadata_syntax.rst
123
-
124
- Options
125
- -----------------------------------------------------
126
- .. include:: ../../includes_knife/includes_knife_cookbook_metadata_options.rst
127
-
128
- Examples
129
- -----------------------------------------------------
130
- The following examples show how to use this |knife| subcommand:
131
-
132
- **Generate metadata**
133
-
134
- .. include:: ../../step_knife/step_knife_cookbook_metadata.rst
135
-
136
-
137
- metadata from file
138
- =====================================================
139
- .. include:: ../../includes_knife/includes_knife_cookbook_metadata_from_file.rst
140
-
141
- Syntax
142
- -----------------------------------------------------
143
- .. include:: ../../includes_knife/includes_knife_cookbook_metadata_from_file_syntax.rst
144
-
145
- Options
146
- -----------------------------------------------------
147
- |no_options|
148
-
149
- Examples
150
- -----------------------------------------------------
151
- The following examples show how to use this |knife| subcommand:
152
-
153
- **View metadata**
154
-
155
- .. include:: ../../step_knife/step_knife_cookbook_metadata_from_file.rst
156
-
157
-
158
- show
159
- =====================================================
160
- .. include:: ../../includes_knife/includes_knife_cookbook_show.rst
161
-
162
- Syntax
163
- -----------------------------------------------------
164
- .. include:: ../../includes_knife/includes_knife_cookbook_show_syntax.rst
165
-
166
- Options
167
- -----------------------------------------------------
168
- .. include:: ../../includes_knife/includes_knife_cookbook_show_options.rst
169
-
170
- Examples
171
- -----------------------------------------------------
172
- The following examples show how to use this |knife| subcommand:
173
-
174
- **Show cookbook data**
175
-
176
- .. include:: ../../step_knife/step_knife_cookbook_show_cookbook_data.rst
177
-
178
- **Show cookbook versions**
179
-
180
- .. include:: ../../step_knife/step_knife_cookbook_show_cookbook_versions.rst
181
-
182
- **Show a cookbook version**
183
-
184
- .. include:: ../../step_knife/step_knife_cookbook_show_cookbook_version.rst
185
-
186
- **Show cookbook data as JSON**
187
-
188
- .. include:: ../../step_knife/step_knife_common_view_json.rst
189
-
190
-
191
- test
192
- =====================================================
193
- .. include:: ../../includes_knife/includes_knife_cookbook_test.rst
194
-
195
- Syntax
196
- -----------------------------------------------------
197
- .. include:: ../../includes_knife/includes_knife_cookbook_test_syntax.rst
198
-
199
- Options
200
- -----------------------------------------------------
201
- .. include:: ../../includes_knife/includes_knife_cookbook_test_options.rst
202
-
203
- Examples
204
- -----------------------------------------------------
205
- The following examples show how to use this |knife| subcommand:
206
-
207
- **Test a cookbook**
208
-
209
- .. include:: ../../step_knife/step_knife_cookbook_test.rst
210
-
211
-
212
- upload
213
- =====================================================
214
- .. include:: ../../includes_knife/includes_knife_cookbook_upload.rst
215
-
216
- Syntax
217
- -----------------------------------------------------
218
- .. include:: ../../includes_knife/includes_knife_cookbook_upload_syntax.rst
219
-
220
- Options
221
- -----------------------------------------------------
222
- .. include:: ../../includes_knife/includes_knife_cookbook_upload_options.rst
223
-
224
- Examples
225
- -----------------------------------------------------
226
- The following examples show how to use this |knife| subcommand:
227
-
228
- **Upload a cookbook**
229
-
230
- .. include:: ../../step_knife/step_knife_cookbook_upload.rst
231
-
232
- **Freeze a cookbook**
233
-
234
- .. include:: ../../step_knife/step_knife_cookbook_upload_freeze.rst
235
-
236
- .. include:: ../../step_knife/step_knife_cookbook_upload_force.rst