chef 12.12.15 → 12.13.30

Sign up to get free protection for your applications and to get access to all the features.
Files changed (410) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +5 -0
  3. data/LICENSE +201 -201
  4. data/VERSION +1 -1
  5. data/acceptance/.gitignore +2 -0
  6. data/acceptance/.shared/kitchen_acceptance/.kitchen.ec2.yml +1 -12
  7. data/acceptance/.shared/kitchen_acceptance/libraries/kitchen.rb +29 -12
  8. data/acceptance/Gemfile +6 -3
  9. data/acceptance/Gemfile.lock +109 -67
  10. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/top_cookbooks.rb +2 -2
  11. data/acceptance/trivial/.kitchen.yml +1 -1
  12. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/destroy.rb +1 -1
  13. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/provision.rb +1 -1
  14. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/verify.rb +1 -1
  15. data/acceptance/windows-service/test/integration/chef-windows-service/inspec/chef_windows_service_spec.rb +4 -4
  16. data/bin/chef-apply +0 -0
  17. data/bin/chef-client +0 -0
  18. data/bin/chef-shell +0 -0
  19. data/bin/chef-solo +0 -0
  20. data/bin/knife +0 -0
  21. data/chef.gemspec +4 -3
  22. data/distro/common/html/_sources/ctl_chef_client.txt +35 -35
  23. data/distro/common/html/_sources/ctl_chef_server.txt +341 -341
  24. data/distro/common/html/_sources/ctl_chef_shell.txt +15 -15
  25. data/distro/common/html/_sources/ctl_chef_solo.txt +25 -25
  26. data/distro/common/html/_sources/index.txt +135 -135
  27. data/distro/common/html/_sources/knife.txt +74 -74
  28. data/distro/common/html/_sources/knife_bootstrap.txt +56 -56
  29. data/distro/common/html/_sources/knife_client.txt +150 -150
  30. data/distro/common/html/_sources/knife_common_options.txt +6 -6
  31. data/distro/common/html/_sources/knife_configure.txt +29 -29
  32. data/distro/common/html/_sources/knife_cookbook.txt +236 -236
  33. data/distro/common/html/_sources/knife_cookbook_site.txt +157 -157
  34. data/distro/common/html/_sources/knife_data_bag.txt +159 -159
  35. data/distro/common/html/_sources/knife_delete.txt +26 -26
  36. data/distro/common/html/_sources/knife_deps.txt +61 -61
  37. data/distro/common/html/_sources/knife_diff.txt +34 -34
  38. data/distro/common/html/_sources/knife_download.txt +44 -44
  39. data/distro/common/html/_sources/knife_edit.txt +26 -26
  40. data/distro/common/html/_sources/knife_environment.txt +158 -158
  41. data/distro/common/html/_sources/knife_exec.txt +47 -47
  42. data/distro/common/html/_sources/knife_index_rebuild.txt +20 -20
  43. data/distro/common/html/_sources/knife_list.txt +33 -33
  44. data/distro/common/html/_sources/knife_node.txt +250 -250
  45. data/distro/common/html/_sources/knife_raw.txt +35 -35
  46. data/distro/common/html/_sources/knife_recipe_list.txt +23 -23
  47. data/distro/common/html/_sources/knife_role.txt +157 -157
  48. data/distro/common/html/_sources/knife_search.txt +53 -53
  49. data/distro/common/html/_sources/knife_serve.txt +18 -18
  50. data/distro/common/html/_sources/knife_show.txt +26 -26
  51. data/distro/common/html/_sources/knife_ssh.txt +43 -43
  52. data/distro/common/html/_sources/knife_ssl_check.txt +41 -41
  53. data/distro/common/html/_sources/knife_ssl_fetch.txt +41 -41
  54. data/distro/common/html/_sources/knife_status.txt +37 -37
  55. data/distro/common/html/_sources/knife_tag.txt +69 -69
  56. data/distro/common/html/_sources/knife_upload.txt +49 -49
  57. data/distro/common/html/_sources/knife_user.txt +127 -127
  58. data/distro/common/html/_sources/knife_using.txt +43 -43
  59. data/distro/common/html/_sources/knife_xargs.txt +30 -30
  60. data/distro/common/html/_static/guide.css +504 -504
  61. data/distro/common/html/_static/pygments.css +61 -61
  62. data/distro/common/html/_static/underscore.js +31 -31
  63. data/distro/common/html/ctl_chef_client.html +269 -269
  64. data/distro/common/html/ctl_chef_server.html +727 -727
  65. data/distro/common/html/ctl_chef_shell.html +162 -162
  66. data/distro/common/html/ctl_chef_solo.html +193 -193
  67. data/distro/common/html/index.html +201 -201
  68. data/distro/common/html/knife.html +169 -169
  69. data/distro/common/html/knife_bootstrap.html +284 -284
  70. data/distro/common/html/knife_client.html +284 -284
  71. data/distro/common/html/knife_common_options.html +95 -95
  72. data/distro/common/html/knife_configure.html +104 -104
  73. data/distro/common/html/knife_cookbook.html +486 -486
  74. data/distro/common/html/knife_data_bag.html +373 -373
  75. data/distro/common/html/knife_delete.html +92 -92
  76. data/distro/common/html/knife_deps.html +142 -142
  77. data/distro/common/html/knife_diff.html +122 -122
  78. data/distro/common/html/knife_download.html +144 -144
  79. data/distro/common/html/knife_edit.html +88 -88
  80. data/distro/common/html/knife_environment.html +325 -325
  81. data/distro/common/html/knife_exec.html +219 -219
  82. data/distro/common/html/knife_index_rebuild.html +82 -82
  83. data/distro/common/html/knife_list.html +113 -113
  84. data/distro/common/html/knife_node.html +457 -457
  85. data/distro/common/html/knife_raw.html +109 -109
  86. data/distro/common/html/knife_recipe_list.html +90 -90
  87. data/distro/common/html/knife_role.html +294 -294
  88. data/distro/common/html/knife_search.html +202 -202
  89. data/distro/common/html/knife_serve.html +78 -78
  90. data/distro/common/html/knife_show.html +103 -103
  91. data/distro/common/html/knife_ssh.html +176 -176
  92. data/distro/common/html/knife_ssl_check.html +150 -150
  93. data/distro/common/html/knife_ssl_fetch.html +150 -150
  94. data/distro/common/html/knife_status.html +143 -143
  95. data/distro/common/html/knife_tag.html +137 -137
  96. data/distro/common/html/knife_upload.html +152 -152
  97. data/distro/common/html/knife_user.html +241 -241
  98. data/distro/common/html/knife_using.html +209 -209
  99. data/distro/common/html/knife_xargs.html +121 -121
  100. data/distro/common/html/search.html +81 -81
  101. data/distro/common/man/man1/README.md +58 -58
  102. data/distro/common/man/man1/chef-shell.1 +194 -194
  103. data/distro/common/man/man1/knife-bootstrap.1 +215 -215
  104. data/distro/common/man/man1/knife-client.1 +443 -443
  105. data/distro/common/man/man1/knife-configure.1 +161 -161
  106. data/distro/common/man/man1/knife-cookbook.1 +770 -770
  107. data/distro/common/man/man1/knife-data-bag.1 +617 -617
  108. data/distro/common/man/man1/knife-delete.1 +127 -127
  109. data/distro/common/man/man1/knife-deps.1 +246 -246
  110. data/distro/common/man/man1/knife-diff.1 +226 -226
  111. data/distro/common/man/man1/knife-download.1 +258 -258
  112. data/distro/common/man/man1/knife-edit.1 +121 -121
  113. data/distro/common/man/man1/knife-environment.1 +508 -508
  114. data/distro/common/man/man1/knife-exec.1 +362 -362
  115. data/distro/common/man/man1/knife-index-rebuild.1 +63 -63
  116. data/distro/common/man/man1/knife-list.1 +174 -174
  117. data/distro/common/man/man1/knife-node.1 +716 -716
  118. data/distro/common/man/man1/knife-raw.1 +172 -172
  119. data/distro/common/man/man1/knife-recipe-list.1 +85 -85
  120. data/distro/common/man/man1/knife-role.1 +426 -426
  121. data/distro/common/man/man1/knife-search.1 +359 -359
  122. data/distro/common/man/man1/knife-serve.1 +109 -109
  123. data/distro/common/man/man1/knife-show.1 +160 -160
  124. data/distro/common/man/man1/knife-ssh.1 +284 -284
  125. data/distro/common/man/man1/knife-ssl-check.1 +207 -207
  126. data/distro/common/man/man1/knife-ssl-fetch.1 +207 -207
  127. data/distro/common/man/man1/knife-status.1 +234 -234
  128. data/distro/common/man/man1/knife-tag.1 +189 -189
  129. data/distro/common/man/man1/knife-upload.1 +280 -280
  130. data/distro/common/man/man1/knife-user.1 +356 -356
  131. data/distro/common/man/man1/knife-xargs.1 +189 -189
  132. data/distro/common/man/man1/knife.1 +332 -332
  133. data/distro/common/man/man8/chef-apply.8 +86 -86
  134. data/distro/common/man/man8/chef-client.8 +398 -398
  135. data/distro/common/man/man8/chef-solo.8 +260 -260
  136. data/distro/common/markdown/README +3 -3
  137. data/lib/chef/application.rb +23 -0
  138. data/lib/chef/application/client.rb +10 -2
  139. data/lib/chef/application/knife.rb +8 -0
  140. data/lib/chef/application/solo.rb +10 -2
  141. data/lib/chef/audit/audit_reporter.rb +5 -1
  142. data/lib/chef/audit/runner.rb +1 -1
  143. data/lib/chef/chef_fs/chef_fs_data_store.rb +1 -0
  144. data/lib/chef/chef_fs/file_system/repository/acls_dir.rb +4 -2
  145. data/lib/chef/chef_fs/file_system/repository/base_file.rb +3 -0
  146. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_cookbook_entry.rb +1 -0
  147. data/lib/chef/chef_fs/file_system/repository/directory.rb +12 -1
  148. data/lib/chef/chef_fs/file_system_cache.rb +80 -0
  149. data/lib/chef/data_collector.rb +18 -1
  150. data/lib/chef/data_collector/resource_report.rb +1 -0
  151. data/lib/chef/decorator/unchain.rb +16 -0
  152. data/lib/chef/dsl/cheffish.rb +1 -0
  153. data/lib/chef/dsl/declare_resource.rb +9 -1
  154. data/lib/chef/file_access_control/windows.rb +3 -3
  155. data/lib/chef/knife/bootstrap.rb +9 -0
  156. data/lib/chef/knife/cookbook_site_install.rb +2 -11
  157. data/lib/chef/knife/cookbook_site_share.rb +7 -13
  158. data/lib/chef/knife/core/bootstrap_context.rb +10 -0
  159. data/lib/chef/knife/help_topics.rb +4 -4
  160. data/lib/chef/nil_argument.rb +3 -3
  161. data/lib/chef/node/attribute.rb +2 -2
  162. data/lib/chef/provider/apt_repository.rb +1 -1
  163. data/lib/chef/provider/apt_update.rb +12 -3
  164. data/lib/chef/provider/cron.rb +1 -1
  165. data/lib/chef/provider/package/aix.rb +5 -1
  166. data/lib/chef/provider/package/zypper.rb +7 -7
  167. data/lib/chef/provider/resource_update.rb +52 -52
  168. data/lib/chef/reserved_names.rb +9 -9
  169. data/lib/chef/resource.rb +13 -1
  170. data/lib/chef/resource/freebsd_package.rb +1 -1
  171. data/lib/chef/run_context.rb +15 -42
  172. data/lib/chef/sandbox.rb +20 -20
  173. data/lib/chef/version.rb +1 -1
  174. data/lib/chef/version_class.rb +7 -2
  175. data/lib/chef/win32/file.rb +4 -4
  176. data/lib/chef/win32/system.rb +0 -0
  177. data/spec/data/apt/chef-integration-test-1.0/debian/changelog +5 -5
  178. data/spec/data/apt/chef-integration-test-1.0/debian/compat +1 -1
  179. data/spec/data/apt/chef-integration-test-1.0/debian/control +13 -13
  180. data/spec/data/apt/chef-integration-test-1.0/debian/files +1 -1
  181. data/spec/data/apt/chef-integration-test-1.0/debian/rules +13 -13
  182. data/spec/data/apt/chef-integration-test-1.0/debian/source/format +1 -1
  183. data/spec/data/apt/chef-integration-test-1.1/debian/changelog +11 -11
  184. data/spec/data/apt/chef-integration-test-1.1/debian/compat +1 -1
  185. data/spec/data/apt/chef-integration-test-1.1/debian/control +13 -13
  186. data/spec/data/apt/chef-integration-test-1.1/debian/files +1 -1
  187. data/spec/data/apt/chef-integration-test-1.1/debian/rules +13 -13
  188. data/spec/data/apt/chef-integration-test-1.1/debian/source/format +1 -1
  189. data/spec/data/apt/chef-integration-test2-1.0/debian/rules +0 -0
  190. data/spec/data/apt/chef-integration-test_1.0-1_amd64.changes +22 -22
  191. data/spec/data/apt/chef-integration-test_1.1-1_amd64.changes +22 -22
  192. data/spec/data/apt/var/www/apt/conf/distributions +7 -7
  193. data/spec/data/apt/var/www/apt/conf/incoming +4 -4
  194. data/spec/data/apt/var/www/apt/conf/pulls +3 -3
  195. data/spec/data/apt/var/www/apt/db/version +4 -4
  196. data/spec/data/apt/var/www/apt/dists/sid/Release +19 -19
  197. data/spec/data/apt/var/www/apt/dists/sid/main/binary-amd64/Packages +16 -16
  198. data/spec/data/apt/var/www/apt/dists/sid/main/binary-amd64/Release +5 -5
  199. data/spec/data/bootstrap/encrypted_data_bag_secret +1 -1
  200. data/spec/data/bootstrap/no_proxy.erb +2 -2
  201. data/spec/data/bootstrap/secret.erb +9 -9
  202. data/spec/data/bootstrap/test-hints.erb +12 -12
  203. data/spec/data/bootstrap/test.erb +1 -1
  204. data/spec/data/cb_version_cookbooks/tatft/README.rdoc +2 -2
  205. data/spec/data/cb_version_cookbooks/tatft/attributes/default.rb +1 -1
  206. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-600hhz-0 +1 -1
  207. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ahd2gq-0 +1 -1
  208. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-api8ux-0 +1 -1
  209. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-b0r1m1-0 +1 -1
  210. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-bfygsi-0 +1 -1
  211. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-el14l6-0 +1 -1
  212. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ivrl3y-0 +1 -1
  213. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-kkbs85-0 +1 -1
  214. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ory1ux-0 +1 -1
  215. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-pgsq76-0 +1 -1
  216. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ra8uim-0 +1 -1
  217. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-t7k1g-0 +1 -1
  218. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-t8g0sv-0 +1 -1
  219. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ufy6g3-0 +1 -1
  220. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-x2d6j9-0 +1 -1
  221. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-xi0l6h-0 +1 -1
  222. data/spec/data/config.rb +6 -6
  223. data/spec/data/cookbooks/angrybash/metadata.rb +2 -2
  224. data/spec/data/cookbooks/angrybash/recipes/default.rb +8 -8
  225. data/spec/data/cookbooks/apache2/files/default/apache2_module_conf_generate.pl +2 -2
  226. data/spec/data/cookbooks/apache2/metadata.rb +2 -2
  227. data/spec/data/cookbooks/apache2/recipes/default.rb +2 -2
  228. data/spec/data/cookbooks/borken/metadata.rb +2 -2
  229. data/spec/data/cookbooks/borken/recipes/default.rb +1 -1
  230. data/spec/data/cookbooks/borken/templates/default/borken.erb +1 -1
  231. data/spec/data/cookbooks/chefignore +8 -8
  232. data/spec/data/cookbooks/ignorken/files/default/not_me.rb +2 -2
  233. data/spec/data/cookbooks/ignorken/metadata.rb +2 -2
  234. data/spec/data/cookbooks/ignorken/recipes/ignoreme.rb +1 -1
  235. data/spec/data/cookbooks/ignorken/templates/ubuntu-12.10/not_me.rb +2 -2
  236. data/spec/data/cookbooks/java/files/default/java.response +1 -1
  237. data/spec/data/cookbooks/java/metadata.rb +2 -2
  238. data/spec/data/cookbooks/name-mismatch-versionnumber/README.md +4 -4
  239. data/spec/data/cookbooks/name-mismatch-versionnumber/metadata.rb +8 -8
  240. data/spec/data/cookbooks/openldap/attributes/default.rb +16 -16
  241. data/spec/data/cookbooks/openldap/attributes/smokey.rb +1 -1
  242. data/spec/data/cookbooks/openldap/definitions/client.rb +5 -5
  243. data/spec/data/cookbooks/openldap/definitions/server.rb +5 -5
  244. data/spec/data/cookbooks/openldap/files/default/.dotfile +1 -1
  245. data/spec/data/cookbooks/openldap/files/default/remotedir/.a_dotdir/.a_dotfile_in_a_dotdir +1 -1
  246. data/spec/data/cookbooks/openldap/files/default/remotedir/not_a_template.erb +2 -2
  247. data/spec/data/cookbooks/openldap/files/default/remotedir/remote_dir_file1.txt +2 -2
  248. data/spec/data/cookbooks/openldap/files/default/remotedir/remote_dir_file2.txt +2 -2
  249. data/spec/data/cookbooks/openldap/files/default/remotedir/remotesubdir/.a_dotfile +1 -1
  250. data/spec/data/cookbooks/openldap/files/default/remotedir/remotesubdir/remote_subdir_file1.txt +2 -2
  251. data/spec/data/cookbooks/openldap/files/default/remotedir/remotesubdir/remote_subdir_file2.txt +2 -2
  252. data/spec/data/cookbooks/openldap/files/default/remotedir/subdir_with_no_file_just_a_subsubdir/the_subsubdir/some_file.txt +3 -3
  253. data/spec/data/cookbooks/openldap/libraries/openldap.rb +4 -4
  254. data/spec/data/cookbooks/openldap/libraries/openldap/version.rb +3 -3
  255. data/spec/data/cookbooks/openldap/metadata.rb +8 -8
  256. data/spec/data/cookbooks/openldap/recipes/default.rb +4 -4
  257. data/spec/data/cookbooks/openldap/recipes/gigantor.rb +3 -3
  258. data/spec/data/cookbooks/openldap/recipes/one.rb +15 -15
  259. data/spec/data/cookbooks/openldap/recipes/return.rb +2 -2
  260. data/spec/data/cookbooks/openldap/templates/default/helper_test.erb +1 -1
  261. data/spec/data/cookbooks/openldap/templates/default/helpers_via_partial_test.erb +1 -1
  262. data/spec/data/cookbooks/openldap/templates/default/no_windows_line_endings.erb +4 -4
  263. data/spec/data/cookbooks/openldap/templates/default/openldap_variable_stuff.conf.erb +1 -1
  264. data/spec/data/cookbooks/openldap/templates/default/test.erb +1 -1
  265. data/spec/data/cookbooks/preseed/files/default/preseed-file.seed +1 -1
  266. data/spec/data/cookbooks/preseed/files/default/preseed-template.seed +4 -4
  267. data/spec/data/cookbooks/preseed/metadata.rb +2 -2
  268. data/spec/data/cookbooks/preseed/templates/default/preseed-template-variables.seed +1 -1
  269. data/spec/data/cookbooks/preseed/templates/default/preseed-template.seed +1 -1
  270. data/spec/data/definitions/test.rb +4 -4
  271. data/spec/data/environment-config.rb +4 -4
  272. data/spec/data/file-providers-method-snapshot-chef-11-4.json +127 -127
  273. data/spec/data/fileedit/hosts +4 -4
  274. data/spec/data/incomplete-metadata-chef-repo/incomplete-metadata/README.md +4 -4
  275. data/spec/data/incomplete-metadata-chef-repo/incomplete-metadata/metadata.rb +13 -13
  276. data/spec/data/invalid-metadata-chef-repo/invalid-metadata/README.md +4 -4
  277. data/spec/data/kitchen/chefignore +6 -6
  278. data/spec/data/kitchen/openldap/attributes/default.rb +3 -3
  279. data/spec/data/kitchen/openldap/attributes/robinson.rb +2 -2
  280. data/spec/data/kitchen/openldap/definitions/client.rb +3 -3
  281. data/spec/data/kitchen/openldap/definitions/drewbarrymore.rb +2 -2
  282. data/spec/data/kitchen/openldap/recipes/gigantor.rb +2 -2
  283. data/spec/data/kitchen/openldap/recipes/ignoreme.rb +2 -2
  284. data/spec/data/kitchen/openldap/recipes/woot.rb +3 -3
  285. data/spec/data/knife_subcommand/test_explicit_category.rb +6 -6
  286. data/spec/data/knife_subcommand/test_name_mapping.rb +4 -4
  287. data/spec/data/knife_subcommand/test_yourself.rb +21 -21
  288. data/spec/data/lwrp/providers/inline_compiler.rb +26 -26
  289. data/spec/data/lwrp/providers/monkey_name_printer.rb +5 -5
  290. data/spec/data/lwrp/providers/paint_drying_watcher.rb +7 -7
  291. data/spec/data/lwrp/providers/thumb_twiddler.rb +7 -7
  292. data/spec/data/lwrp/resources/foo.rb +4 -4
  293. data/spec/data/lwrp/resources_with_default_attributes/nodeattr.rb +1 -1
  294. data/spec/data/lwrp_override/providers/buck_passer.rb +5 -5
  295. data/spec/data/mac_users/10.7-8.plist.xml +559 -559
  296. data/spec/data/mac_users/10.7-8.shadow.xml +11 -11
  297. data/spec/data/mac_users/10.7.plist.xml +559 -559
  298. data/spec/data/mac_users/10.7.shadow.xml +11 -11
  299. data/spec/data/mac_users/10.8.plist.xml +559 -559
  300. data/spec/data/mac_users/10.8.shadow.xml +21 -21
  301. data/spec/data/mac_users/10.9.plist.xml +560 -560
  302. data/spec/data/mac_users/10.9.shadow.xml +21 -21
  303. data/spec/data/metadata/quick_start/metadata.rb +19 -19
  304. data/spec/data/nodes/default.rb +15 -15
  305. data/spec/data/nodes/test.example.com.rb +17 -17
  306. data/spec/data/nodes/test.rb +15 -15
  307. data/spec/data/null_config.rb +1 -1
  308. data/spec/data/object_loader/environments/test.json +7 -7
  309. data/spec/data/object_loader/environments/test.rb +2 -2
  310. data/spec/data/object_loader/environments/test_json_class.json +8 -8
  311. data/spec/data/object_loader/nodes/test.json +7 -7
  312. data/spec/data/object_loader/nodes/test.rb +2 -2
  313. data/spec/data/object_loader/nodes/test_json_class.json +8 -8
  314. data/spec/data/object_loader/roles/test.json +7 -7
  315. data/spec/data/object_loader/roles/test.rb +2 -2
  316. data/spec/data/object_loader/roles/test_json_class.json +8 -8
  317. data/spec/data/partial_one.erb +1 -1
  318. data/spec/data/recipes/test.rb +7 -7
  319. data/spec/data/run_context/cookbooks/circular-dep1/definitions/circular_dep1_res.rb +1 -1
  320. data/spec/data/run_context/cookbooks/circular-dep1/libraries/lib.rb +2 -2
  321. data/spec/data/run_context/cookbooks/circular-dep1/metadata.rb +2 -2
  322. data/spec/data/run_context/cookbooks/circular-dep1/providers/provider.rb +1 -1
  323. data/spec/data/run_context/cookbooks/circular-dep1/resources/resource.rb +1 -1
  324. data/spec/data/run_context/cookbooks/circular-dep2/definitions/circular_dep2_res.rb +1 -1
  325. data/spec/data/run_context/cookbooks/circular-dep2/libraries/lib.rb +2 -2
  326. data/spec/data/run_context/cookbooks/circular-dep2/metadata.rb +2 -2
  327. data/spec/data/run_context/cookbooks/circular-dep2/providers/provider.rb +1 -1
  328. data/spec/data/run_context/cookbooks/circular-dep2/resources/resource.rb +1 -1
  329. data/spec/data/run_context/cookbooks/dependency1/definitions/dependency1_res.rb +1 -1
  330. data/spec/data/run_context/cookbooks/dependency1/libraries/lib.rb +2 -2
  331. data/spec/data/run_context/cookbooks/dependency1/providers/provider.rb +1 -1
  332. data/spec/data/run_context/cookbooks/dependency1/resources/resource.rb +1 -1
  333. data/spec/data/run_context/cookbooks/dependency2/definitions/dependency2_res.rb +1 -1
  334. data/spec/data/run_context/cookbooks/dependency2/libraries/lib.rb +2 -2
  335. data/spec/data/run_context/cookbooks/dependency2/providers/provider.rb +1 -1
  336. data/spec/data/run_context/cookbooks/dependency2/resources/resource.rb +1 -1
  337. data/spec/data/run_context/cookbooks/no-default-attr/definitions/no_default-attr_res.rb +1 -1
  338. data/spec/data/run_context/cookbooks/no-default-attr/providers/provider.rb +1 -1
  339. data/spec/data/run_context/cookbooks/no-default-attr/resources/resource.rb +1 -1
  340. data/spec/data/run_context/cookbooks/test-with-circular-deps/definitions/test_with-circular-deps_res.rb +1 -1
  341. data/spec/data/run_context/cookbooks/test-with-circular-deps/libraries/lib.rb +2 -2
  342. data/spec/data/run_context/cookbooks/test-with-circular-deps/metadata.rb +2 -2
  343. data/spec/data/run_context/cookbooks/test-with-circular-deps/providers/provider.rb +1 -1
  344. data/spec/data/run_context/cookbooks/test-with-circular-deps/resources/resource.rb +1 -1
  345. data/spec/data/run_context/cookbooks/test-with-deps/definitions/test_with-deps_res.rb +1 -1
  346. data/spec/data/run_context/cookbooks/test-with-deps/libraries/lib.rb +1 -1
  347. data/spec/data/run_context/cookbooks/test-with-deps/metadata.rb +3 -3
  348. data/spec/data/run_context/cookbooks/test-with-deps/providers/provider.rb +1 -1
  349. data/spec/data/run_context/cookbooks/test-with-deps/resources/resource.rb +1 -1
  350. data/spec/data/run_context/cookbooks/test/attributes/george.rb +1 -1
  351. data/spec/data/run_context/cookbooks/test/definitions/new_animals.rb +9 -9
  352. data/spec/data/run_context/cookbooks/test/definitions/new_cat.rb +5 -5
  353. data/spec/data/run_context/cookbooks/test/definitions/test_res.rb +1 -1
  354. data/spec/data/run_context/cookbooks/test/providers/provider.rb +1 -1
  355. data/spec/data/run_context/cookbooks/test/recipes/default.rb +5 -5
  356. data/spec/data/run_context/cookbooks/test/recipes/one.rb +7 -7
  357. data/spec/data/run_context/cookbooks/test/recipes/two.rb +7 -7
  358. data/spec/data/run_context/cookbooks/test/resources/resource.rb +1 -1
  359. data/spec/data/run_context/nodes/run_context.rb +5 -5
  360. data/spec/data/search_queries_to_transform.txt +98 -98
  361. data/spec/data/shef-config.rb +10 -10
  362. data/spec/data/ssl/5e707473.0 +18 -18
  363. data/spec/data/ssl/chef-rspec.cert +27 -27
  364. data/spec/data/ssl/chef-rspec.key +27 -27
  365. data/spec/data/ssl/key.pem +15 -15
  366. data/spec/data/ssl/private_key.pem +27 -27
  367. data/spec/data/ssl/private_key_with_whitespace.pem +32 -32
  368. data/spec/data/standalone_cookbook/chefignore +9 -9
  369. data/spec/data/standalone_cookbook/recipes/default.rb +2 -2
  370. data/spec/data/trusted_certs/example.crt +22 -22
  371. data/spec/data/trusted_certs/intermediate.pem +27 -27
  372. data/spec/data/trusted_certs/root.pem +22 -22
  373. data/spec/functional/assets/chefinittest +34 -34
  374. data/spec/functional/assets/testchefsubsys +10 -10
  375. data/spec/functional/mixin/powershell_out_spec.rb +2 -2
  376. data/spec/functional/provider/remote_file/cache_control_data_spec.rb +0 -0
  377. data/spec/functional/resource/aix_service_spec.rb +0 -0
  378. data/spec/functional/resource/aixinit_service_spec.rb +0 -0
  379. data/spec/functional/resource/cron_spec.rb +8 -1
  380. data/spec/functional/resource/env_spec.rb +0 -0
  381. data/spec/functional/resource/link_spec.rb +1 -6
  382. data/spec/functional/run_lock_spec.rb +17 -10
  383. data/spec/integration/knife/diff_spec.rb +2 -2
  384. data/spec/integration/knife/download_spec.rb +4 -4
  385. data/spec/integration/knife/raw_spec.rb +2 -0
  386. data/spec/integration/knife/upload_spec.rb +3 -3
  387. data/spec/rcov.opts +2 -2
  388. data/spec/spec_helper.rb +11 -1
  389. data/spec/support/shared/integration/knife_support.rb +4 -0
  390. data/spec/unit/application/client_spec.rb +35 -0
  391. data/spec/unit/application/solo_spec.rb +6 -6
  392. data/spec/unit/chef_fs/file_system/repository/directory_spec.rb +1 -0
  393. data/spec/unit/data_collector_spec.rb +41 -1
  394. data/spec/unit/dsl/declare_resource_spec.rb +30 -0
  395. data/spec/unit/knife/cookbook_site_install_spec.rb +2 -0
  396. data/spec/unit/knife/cookbook_site_share_spec.rb +4 -4
  397. data/spec/unit/node_spec.rb +6 -0
  398. data/spec/unit/provider/cron_spec.rb +16 -16
  399. data/spec/unit/provider/package/aix_spec.rb +13 -0
  400. data/spec/unit/provider/package/zypper_spec.rb +18 -2
  401. data/spec/unit/resource/apt_repository_spec.rb +14 -2
  402. data/spec/unit/resource/apt_update_spec.rb +14 -2
  403. data/spec/unit/resource_builder_spec.rb +1 -1
  404. data/tasks/bin/bundle-platform +0 -0
  405. data/tasks/bin/bundle-platform.bat +0 -0
  406. data/tasks/bin/create-override-gemfile +0 -0
  407. data/tasks/bin/run_external_test +0 -0
  408. data/tasks/bundle.rb +2 -2
  409. metadata +29 -15
  410. data/acceptance/data-collector/Berksfile.lock +0 -6
data/distro/common/html/index.html CHANGED
@@ -1,202 +1,202 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
-
4
-
5
- <html xmlns="http://www.w3.org/1999/xhtml">
6
- <head>
7
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
-
9
- <title>chef-client Man Pages &mdash; chef-client Man Pages</title>
10
-
11
- <link rel="stylesheet" href="_static/guide.css" type="text/css" />
12
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
13
-
14
- <script type="text/javascript">
15
- var DOCUMENTATION_OPTIONS = {
16
- URL_ROOT: './',
17
- VERSION: '',
18
- COLLAPSE_INDEX: false,
19
- FILE_SUFFIX: '.html',
20
- HAS_SOURCE: true
21
- };
22
- </script>
23
- <script type="text/javascript" src="_static/jquery.js"></script>
24
- <script type="text/javascript" src="_static/underscore.js"></script>
25
- <script type="text/javascript" src="_static/doctools.js"></script>
26
-
27
-
28
- </head>
29
- <body>
30
- <div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
31
- <a href="http://docs.getchef.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
32
- </div>
33
-
34
-
35
-
36
-
37
- <div class="document">
38
- <div class="documentwrapper">
39
-
40
- <div class="body">
41
-
42
- <div class="section" id="chef-client-man-pages">
43
- <h1>chef-client Man Pages<a class="headerlink" href="#chef-client-man-pages" title="Permalink to this headline">¶</a></h1>
44
- <p>The following command line interfaces are available in the chef-client:</p>
45
- <ul class="simple">
46
- <li><a class="reference internal" href="ctl_chef_client.html"><em>chef-client</em></a></li>
47
- <li><a class="reference internal" href="ctl_chef_server.html"><em>chef-server-ctl (executable)</em></a></li>
48
- <li><a class="reference internal" href="ctl_chef_shell.html"><em>chef-shell</em></a></li>
49
- <li><a class="reference internal" href="ctl_chef_solo.html"><em>chef-solo</em></a></li>
50
- <li><a class="reference internal" href="knife.html"><em>knife</em></a></li>
51
- </ul>
52
- <div class="section" id="knife">
53
- <h2>knife<a class="headerlink" href="#knife" title="Permalink to this headline">¶</a></h2>
54
- <p>knife is a command-line tool that provides an interface between a local chef-repo and the Chef server. knife helps users to manage:</p>
55
- <ul class="simple">
56
- <li>Nodes</li>
57
- <li>Cookbooks and recipes</li>
58
- <li>Roles</li>
59
- <li>Stores of JSON data (data bags), including encrypted data</li>
60
- <li>Environments</li>
61
- <li>Cloud resources, including provisioning</li>
62
- <li>The installation of the chef-client on management workstations</li>
63
- <li>Searching of indexed data on the Chef server</li>
64
- </ul>
65
- <p>The following sections describe functionality common to all knife subcommands:</p>
66
- <ul class="simple">
67
- <li><a class="reference internal" href="knife_using.html"><em>Working with Knife</em></a></li>
68
- <li><a class="reference internal" href="knife_common_options.html"><em>Common Options</em></a></li>
69
- </ul>
70
- <p>knife includes the following sub-commands:</p>
71
- <table border="1" class="docutils">
72
- <colgroup>
73
- <col width="25%" />
74
- <col width="75%" />
75
- </colgroup>
76
- <thead valign="bottom">
77
- <tr class="row-odd"><th class="head">Sub-command</th>
78
- <th class="head">Description</th>
79
- </tr>
80
- </thead>
81
- <tbody valign="top">
82
- <tr class="row-even"><td><a class="reference internal" href="knife_bootstrap.html"><em>knife bootstrap</em></a></td>
83
- <td>The <strong>knife bootstrap</strong> subcommand is used to run a bootstrap operation that installs the chef-client on the target system. The bootstrap operation must specify the IP address or FQDN of the target system.</td>
84
- </tr>
85
- <tr class="row-odd"><td><a class="reference internal" href="knife_client.html"><em>knife client</em></a></td>
86
- <td>The <strong>knife client</strong> subcommand is used to manage an API client list and their associated RSA public key-pairs. This allows authentication requests to be made to the Chef server by any entity that uses the Chef server API, such as the chef-client and knife.</td>
87
- </tr>
88
- <tr class="row-even"><td><a class="reference internal" href="knife_configure.html"><em>knife configure</em></a></td>
89
- <td>The <strong>knife configure</strong> subcommand is used to create the knife.rb and client.rb files so that they can be distributed to workstations and nodes.</td>
90
- </tr>
91
- <tr class="row-odd"><td><a class="reference internal" href="knife_cookbook.html"><em>knife cookbook</em></a></td>
92
- <td>The <strong>knife cookbook</strong> subcommand is used to interact with cookbooks that are located on the Chef server or the local chef-repo.</td>
93
- </tr>
94
- <tr class="row-even"><td><a class="reference internal" href="knife_cookbook_site.html"><em>knife cookbook site</em></a></td>
95
- <td>The <strong>knife cookbook site</strong> subcommand is used to interact with cookbooks that are located at <a class="reference external" href="https://supermarket.getchef.com/cookbooks">https://supermarket.getchef.com/cookbooks</a>. A user account is required for any community actions that write data to this site. The following arguments do not require a user account: <tt class="docutils literal"><span class="pre">download</span></tt>, <tt class="docutils literal"><span class="pre">search</span></tt>, <tt class="docutils literal"><span class="pre">install</span></tt>, and <tt class="docutils literal"><span class="pre">list</span></tt>.</td>
96
- </tr>
97
- <tr class="row-odd"><td><a class="reference internal" href="knife_data_bag.html"><em>knife data bag</em></a></td>
98
- <td>The <strong>knife data bag</strong> subcommand is used to manage arbitrary stores of globally available JSON data.</td>
99
- </tr>
100
- <tr class="row-even"><td><a class="reference internal" href="knife_delete.html"><em>knife delete</em></a></td>
101
- <td>The <strong>knife delete</strong> subcommand is used to delete an object from a Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">delete</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">delete</span></tt>, but with a single verb (and a single action).</td>
102
- </tr>
103
- <tr class="row-odd"><td><a class="reference internal" href="knife_deps.html"><em>knife deps</em></a></td>
104
- <td>The <strong>knife deps</strong> subcommand is used to identify dependencies for a node, role, or cookbook.</td>
105
- </tr>
106
- <tr class="row-even"><td><a class="reference internal" href="knife_diff.html"><em>knife diff</em></a></td>
107
- <td>The <strong>knife diff</strong> subcommand is used to compare the differences between files and directories on the Chef server and in the chef-repo. For example, to compare files on the Chef server prior to an uploading or downloading files using the <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt> and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt> subcommands, or to ensure that certain files in multiple production environments are the same. This subcommand is similar to the <tt class="docutils literal"><span class="pre">git</span> <span class="pre">diff</span></tt> command that can be used to diff what is in the chef-repo with what is synced to a git repository.</td>
108
- </tr>
109
- <tr class="row-odd"><td><a class="reference internal" href="knife_download.html"><em>knife download</em></a></td>
110
- <td>The <strong>knife download</strong> subcommand is used to download roles, cookbooks, environments, nodes, and data bags from the Chef server to the current working directory. It can be used to back up data on the Chef server, inspect the state of one or more files, or to extract out-of-process changes users may have made to files on the Chef server, such as if a user made a change that bypassed version source control. This subcommand is often used in conjunction with <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">diff</span></tt>, which can be used to see exactly what changes will be downloaded, and then <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt>, which does the opposite of <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt>.</td>
111
- </tr>
112
- <tr class="row-even"><td><a class="reference internal" href="knife_edit.html"><em>knife edit</em></a></td>
113
- <td>The <strong>knife edit</strong> subcommand is used to edit objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">edit</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">edit</span></tt>, but with a single verb (and a single action).</td>
114
- </tr>
115
- <tr class="row-odd"><td><a class="reference internal" href="knife_environment.html"><em>knife environment</em></a></td>
116
- <td>The <strong>knife environment</strong> subcommand is used to manage environments within a single organization on the Chef server.</td>
117
- </tr>
118
- <tr class="row-even"><td><a class="reference internal" href="knife_exec.html"><em>knife exec</em></a></td>
119
- <td>The <strong>knife exec</strong> subcommand uses the knife configuration file to execute Ruby scripts in the context of a fully configured chef-client. This subcommand is most often used to run scripts that will only access Chef server one time (or otherwise very infrequently). Use this subcommand any time that an operation does not warrant full usage of the knife subcommand library.</td>
120
- </tr>
121
- <tr class="row-odd"><td><a class="reference internal" href="knife_index_rebuild.html"><em>knife index rebuild</em></a></td>
122
- <td>The <strong>knife index rebuild</strong> subcommand is used to rebuild the search indexes for the open source Chef server. This operation is destructive and may take some time.</td>
123
- </tr>
124
- <tr class="row-even"><td><a class="reference internal" href="knife_list.html"><em>knife list</em></a></td>
125
- <td>The <strong>knife list</strong> subcommand is used to view a list of objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">list</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">list</span></tt>, but with a single verb (and a single action).</td>
126
- </tr>
127
- <tr class="row-odd"><td><a class="reference internal" href="knife_node.html"><em>knife node</em></a></td>
128
- <td>The <strong>knife node</strong> subcommand is used to manage the nodes that exist on a Chef server.</td>
129
- </tr>
130
- <tr class="row-even"><td><a class="reference internal" href="knife_raw.html"><em>knife raw</em></a></td>
131
- <td>The <strong>knife raw</strong> subcommand is used to send a REST request to an endpoint in the Chef server API.</td>
132
- </tr>
133
- <tr class="row-odd"><td><a class="reference internal" href="knife_recipe_list.html"><em>knife recipe list</em></a></td>
134
- <td>The <strong>knife recipe list</strong> subcommand is used to view all of the recipes that are on a Chef server. A regular expression can be used to limit the results to recipes that match a specific pattern. The regular expression must be within quotes and not be surrounded by forward slashes (/).</td>
135
- </tr>
136
- <tr class="row-even"><td><a class="reference internal" href="knife_role.html"><em>knife role</em></a></td>
137
- <td>The <strong>knife role</strong> subcommand is used to manage the roles that are associated with one or more nodes on a Chef server.</td>
138
- </tr>
139
- <tr class="row-odd"><td><a class="reference internal" href="knife_search.html"><em>knife search</em></a></td>
140
- <td>The <strong>knife search</strong> subcommand is used run a search query for information that is indexed on a Chef server.</td>
141
- </tr>
142
- <tr class="row-even"><td><a class="reference internal" href="knife_serve.html"><em>knife serve</em></a></td>
143
- <td>The <strong>knife serve</strong> subcommand is used to run a persistent chef-zero against the local chef-repo. (chef-zero is a lightweight Chef server that runs in-memory on the local machine.) This is the same as running the chef-client executable with the <tt class="docutils literal"><span class="pre">--local-mode</span></tt> option. The <tt class="docutils literal"><span class="pre">chef_repo_path</span></tt> is located automatically and the Chef server will bind to the first available port between <tt class="docutils literal"><span class="pre">8889</span></tt> and <tt class="docutils literal"><span class="pre">9999</span></tt>. <strong>knife serve</strong> will print the URL for the local Chef server, so that it may be added to the knife.rb file.</td>
144
- </tr>
145
- <tr class="row-odd"><td><a class="reference internal" href="knife_show.html"><em>knife show</em></a></td>
146
- <td>The <strong>knife show</strong> subcommand is used to view the details of one (or more) objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">show</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">show</span></tt>, but with a single verb (and a single action).</td>
147
- </tr>
148
- <tr class="row-even"><td><a class="reference internal" href="knife_ssh.html"><em>knife ssh</em></a></td>
149
- <td>The <strong>knife ssh</strong> subcommand is used to invoke SSH commands (in parallel) on a subset of nodes within an organization, based on the results of a <a class="reference external" href="http://docs.opscode.com/essentials_search.html">search query</a> made to the Chef server.</td>
150
- </tr>
151
- <tr class="row-odd"><td><a class="reference internal" href="knife_ssl_check.html"><em>knife ssl check</em></a></td>
152
- <td><p class="first">The <strong>knife ssl check</strong> subcommand is used to verify the SSL configuration for the Enterprise Chef and/or Open Source Chef servers, or at another location specified by a URL or URI.</p>
153
- <div class="last admonition warning">
154
- <p class="first admonition-title">Warning</p>
155
- <p class="last">When verification of a remote server&#8217;s SSL certificate is disabled, the chef-client will issue a warning similar to &#8220;SSL validation of HTTPS requests is disabled. HTTPS connections are still encrypted, but the chef-client is not able to detect forged replies or man-in-the-middle attacks.&#8221; To configure SSL for the chef-client, set <tt class="docutils literal"><span class="pre">ssl_verify_mode</span></tt> to <tt class="docutils literal"><span class="pre">:verify_peer</span></tt> (recommended) <strong>or</strong> <tt class="docutils literal"><span class="pre">verify_api_cert</span></tt> to <tt class="docutils literal"><span class="pre">true</span></tt> in the client.rb file.</p>
156
- </div>
157
- </td>
158
- </tr>
159
- <tr class="row-even"><td><a class="reference internal" href="knife_ssl_fetch.html"><em>knife ssl fetch</em></a></td>
160
- <td><p class="first">The <strong>knife ssl fetch</strong> subcommand is used to copy SSL certificates from an HTTPS server to the <tt class="docutils literal"><span class="pre">trusted_certs_dir</span></tt> directory that is used by knife and the chef-client to store trusted SSL certificates. When these certificates match the hostname of the remote server, running <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">ssl</span> <span class="pre">fetch</span></tt> is the only step required to verify a remote server that is accessed by either knife or the chef-client.</p>
161
- <div class="last admonition warning">
162
- <p class="first admonition-title">Warning</p>
163
- <p class="last">It is the user&#8217;s responsibility to verify the authenticity of every SSL certificate before downloading it to the <tt class="docutils literal"><span class="pre">trusted_certs_dir</span></tt> directory. knife will use any certificate in that directory as if it is a 100% trusted and authentic SSL certificate. knife will not be able to determine if any certificate in this directory has been tampered with, is forged, malicious, or otherwise harmful. Therefore it is essential that users take the proper steps before downloading certificates into this directory.</p>
164
- </div>
165
- </td>
166
- </tr>
167
- <tr class="row-odd"><td><a class="reference internal" href="knife_status.html"><em>knife status</em></a></td>
168
- <td>The <strong>knife status</strong> subcommand is used to display a brief summary of the nodes on a Chef server, including the time of the most recent successful chef-client run.</td>
169
- </tr>
170
- <tr class="row-even"><td><a class="reference internal" href="knife_tag.html"><em>knife tag</em></a></td>
171
- <td>The <strong>knife tag</strong> subcommand is used to apply tags to nodes on a Chef server.</td>
172
- </tr>
173
- <tr class="row-odd"><td><a class="reference internal" href="knife_upload.html"><em>knife upload</em></a></td>
174
- <td>The <strong>knife upload</strong> subcommand is used to upload roles, cookbooks, environments, and data bags to the Chef server from the current working directory in the chef-repo. This subcommand is often used in conjunction with <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">diff</span></tt>, which can be used to see exactly what changes will be uploaded, and then <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt>, which does the opposite of <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt>.</td>
175
- </tr>
176
- <tr class="row-even"><td><a class="reference internal" href="knife_user.html"><em>knife user</em></a></td>
177
- <td>The <strong>knife user</strong> subcommand is used to manage the list of users and their associated RSA public key-pairs.</td>
178
- </tr>
179
- <tr class="row-odd"><td><a class="reference internal" href="knife_xargs.html"><em>knife xargs</em></a></td>
180
- <td>The <strong>knife xargs</strong> subcommand is used to take patterns from standard input, download as JSON, run a command against the downloaded JSON, and then upload any changes.</td>
181
- </tr>
182
- </tbody>
183
- </table>
184
- <div class="toctree-wrapper compound">
185
- </div>
186
- </div>
187
- </div>
188
-
189
-
190
- </div>
191
-
192
- </div>
193
-
194
-
195
- <div class="clearer"></div>
196
- </div>
197
-
198
-
199
-
200
-
201
- </body>
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
+
4
+
5
+ <html xmlns="http://www.w3.org/1999/xhtml">
6
+ <head>
7
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
+
9
+ <title>chef-client Man Pages &mdash; chef-client Man Pages</title>
10
+
11
+ <link rel="stylesheet" href="_static/guide.css" type="text/css" />
12
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
13
+
14
+ <script type="text/javascript">
15
+ var DOCUMENTATION_OPTIONS = {
16
+ URL_ROOT: './',
17
+ VERSION: '',
18
+ COLLAPSE_INDEX: false,
19
+ FILE_SUFFIX: '.html',
20
+ HAS_SOURCE: true
21
+ };
22
+ </script>
23
+ <script type="text/javascript" src="_static/jquery.js"></script>
24
+ <script type="text/javascript" src="_static/underscore.js"></script>
25
+ <script type="text/javascript" src="_static/doctools.js"></script>
26
+
27
+
28
+ </head>
29
+ <body>
30
+ <div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
31
+ <a href="http://docs.getchef.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
32
+ </div>
33
+
34
+
35
+
36
+
37
+ <div class="document">
38
+ <div class="documentwrapper">
39
+
40
+ <div class="body">
41
+
42
+ <div class="section" id="chef-client-man-pages">
43
+ <h1>chef-client Man Pages<a class="headerlink" href="#chef-client-man-pages" title="Permalink to this headline">¶</a></h1>
44
+ <p>The following command line interfaces are available in the chef-client:</p>
45
+ <ul class="simple">
46
+ <li><a class="reference internal" href="ctl_chef_client.html"><em>chef-client</em></a></li>
47
+ <li><a class="reference internal" href="ctl_chef_server.html"><em>chef-server-ctl (executable)</em></a></li>
48
+ <li><a class="reference internal" href="ctl_chef_shell.html"><em>chef-shell</em></a></li>
49
+ <li><a class="reference internal" href="ctl_chef_solo.html"><em>chef-solo</em></a></li>
50
+ <li><a class="reference internal" href="knife.html"><em>knife</em></a></li>
51
+ </ul>
52
+ <div class="section" id="knife">
53
+ <h2>knife<a class="headerlink" href="#knife" title="Permalink to this headline">¶</a></h2>
54
+ <p>knife is a command-line tool that provides an interface between a local chef-repo and the Chef server. knife helps users to manage:</p>
55
+ <ul class="simple">
56
+ <li>Nodes</li>
57
+ <li>Cookbooks and recipes</li>
58
+ <li>Roles</li>
59
+ <li>Stores of JSON data (data bags), including encrypted data</li>
60
+ <li>Environments</li>
61
+ <li>Cloud resources, including provisioning</li>
62
+ <li>The installation of the chef-client on management workstations</li>
63
+ <li>Searching of indexed data on the Chef server</li>
64
+ </ul>
65
+ <p>The following sections describe functionality common to all knife subcommands:</p>
66
+ <ul class="simple">
67
+ <li><a class="reference internal" href="knife_using.html"><em>Working with Knife</em></a></li>
68
+ <li><a class="reference internal" href="knife_common_options.html"><em>Common Options</em></a></li>
69
+ </ul>
70
+ <p>knife includes the following sub-commands:</p>
71
+ <table border="1" class="docutils">
72
+ <colgroup>
73
+ <col width="25%" />
74
+ <col width="75%" />
75
+ </colgroup>
76
+ <thead valign="bottom">
77
+ <tr class="row-odd"><th class="head">Sub-command</th>
78
+ <th class="head">Description</th>
79
+ </tr>
80
+ </thead>
81
+ <tbody valign="top">
82
+ <tr class="row-even"><td><a class="reference internal" href="knife_bootstrap.html"><em>knife bootstrap</em></a></td>
83
+ <td>The <strong>knife bootstrap</strong> subcommand is used to run a bootstrap operation that installs the chef-client on the target system. The bootstrap operation must specify the IP address or FQDN of the target system.</td>
84
+ </tr>
85
+ <tr class="row-odd"><td><a class="reference internal" href="knife_client.html"><em>knife client</em></a></td>
86
+ <td>The <strong>knife client</strong> subcommand is used to manage an API client list and their associated RSA public key-pairs. This allows authentication requests to be made to the Chef server by any entity that uses the Chef server API, such as the chef-client and knife.</td>
87
+ </tr>
88
+ <tr class="row-even"><td><a class="reference internal" href="knife_configure.html"><em>knife configure</em></a></td>
89
+ <td>The <strong>knife configure</strong> subcommand is used to create the knife.rb and client.rb files so that they can be distributed to workstations and nodes.</td>
90
+ </tr>
91
+ <tr class="row-odd"><td><a class="reference internal" href="knife_cookbook.html"><em>knife cookbook</em></a></td>
92
+ <td>The <strong>knife cookbook</strong> subcommand is used to interact with cookbooks that are located on the Chef server or the local chef-repo.</td>
93
+ </tr>
94
+ <tr class="row-even"><td><a class="reference internal" href="knife_cookbook_site.html"><em>knife cookbook site</em></a></td>
95
+ <td>The <strong>knife cookbook site</strong> subcommand is used to interact with cookbooks that are located at <a class="reference external" href="https://supermarket.getchef.com/cookbooks">https://supermarket.getchef.com/cookbooks</a>. A user account is required for any community actions that write data to this site. The following arguments do not require a user account: <tt class="docutils literal"><span class="pre">download</span></tt>, <tt class="docutils literal"><span class="pre">search</span></tt>, <tt class="docutils literal"><span class="pre">install</span></tt>, and <tt class="docutils literal"><span class="pre">list</span></tt>.</td>
96
+ </tr>
97
+ <tr class="row-odd"><td><a class="reference internal" href="knife_data_bag.html"><em>knife data bag</em></a></td>
98
+ <td>The <strong>knife data bag</strong> subcommand is used to manage arbitrary stores of globally available JSON data.</td>
99
+ </tr>
100
+ <tr class="row-even"><td><a class="reference internal" href="knife_delete.html"><em>knife delete</em></a></td>
101
+ <td>The <strong>knife delete</strong> subcommand is used to delete an object from a Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">delete</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">delete</span></tt>, but with a single verb (and a single action).</td>
102
+ </tr>
103
+ <tr class="row-odd"><td><a class="reference internal" href="knife_deps.html"><em>knife deps</em></a></td>
104
+ <td>The <strong>knife deps</strong> subcommand is used to identify dependencies for a node, role, or cookbook.</td>
105
+ </tr>
106
+ <tr class="row-even"><td><a class="reference internal" href="knife_diff.html"><em>knife diff</em></a></td>
107
+ <td>The <strong>knife diff</strong> subcommand is used to compare the differences between files and directories on the Chef server and in the chef-repo. For example, to compare files on the Chef server prior to an uploading or downloading files using the <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt> and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt> subcommands, or to ensure that certain files in multiple production environments are the same. This subcommand is similar to the <tt class="docutils literal"><span class="pre">git</span> <span class="pre">diff</span></tt> command that can be used to diff what is in the chef-repo with what is synced to a git repository.</td>
108
+ </tr>
109
+ <tr class="row-odd"><td><a class="reference internal" href="knife_download.html"><em>knife download</em></a></td>
110
+ <td>The <strong>knife download</strong> subcommand is used to download roles, cookbooks, environments, nodes, and data bags from the Chef server to the current working directory. It can be used to back up data on the Chef server, inspect the state of one or more files, or to extract out-of-process changes users may have made to files on the Chef server, such as if a user made a change that bypassed version source control. This subcommand is often used in conjunction with <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">diff</span></tt>, which can be used to see exactly what changes will be downloaded, and then <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt>, which does the opposite of <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt>.</td>
111
+ </tr>
112
+ <tr class="row-even"><td><a class="reference internal" href="knife_edit.html"><em>knife edit</em></a></td>
113
+ <td>The <strong>knife edit</strong> subcommand is used to edit objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">edit</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">edit</span></tt>, but with a single verb (and a single action).</td>
114
+ </tr>
115
+ <tr class="row-odd"><td><a class="reference internal" href="knife_environment.html"><em>knife environment</em></a></td>
116
+ <td>The <strong>knife environment</strong> subcommand is used to manage environments within a single organization on the Chef server.</td>
117
+ </tr>
118
+ <tr class="row-even"><td><a class="reference internal" href="knife_exec.html"><em>knife exec</em></a></td>
119
+ <td>The <strong>knife exec</strong> subcommand uses the knife configuration file to execute Ruby scripts in the context of a fully configured chef-client. This subcommand is most often used to run scripts that will only access Chef server one time (or otherwise very infrequently). Use this subcommand any time that an operation does not warrant full usage of the knife subcommand library.</td>
120
+ </tr>
121
+ <tr class="row-odd"><td><a class="reference internal" href="knife_index_rebuild.html"><em>knife index rebuild</em></a></td>
122
+ <td>The <strong>knife index rebuild</strong> subcommand is used to rebuild the search indexes for the open source Chef server. This operation is destructive and may take some time.</td>
123
+ </tr>
124
+ <tr class="row-even"><td><a class="reference internal" href="knife_list.html"><em>knife list</em></a></td>
125
+ <td>The <strong>knife list</strong> subcommand is used to view a list of objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">list</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">list</span></tt>, but with a single verb (and a single action).</td>
126
+ </tr>
127
+ <tr class="row-odd"><td><a class="reference internal" href="knife_node.html"><em>knife node</em></a></td>
128
+ <td>The <strong>knife node</strong> subcommand is used to manage the nodes that exist on a Chef server.</td>
129
+ </tr>
130
+ <tr class="row-even"><td><a class="reference internal" href="knife_raw.html"><em>knife raw</em></a></td>
131
+ <td>The <strong>knife raw</strong> subcommand is used to send a REST request to an endpoint in the Chef server API.</td>
132
+ </tr>
133
+ <tr class="row-odd"><td><a class="reference internal" href="knife_recipe_list.html"><em>knife recipe list</em></a></td>
134
+ <td>The <strong>knife recipe list</strong> subcommand is used to view all of the recipes that are on a Chef server. A regular expression can be used to limit the results to recipes that match a specific pattern. The regular expression must be within quotes and not be surrounded by forward slashes (/).</td>
135
+ </tr>
136
+ <tr class="row-even"><td><a class="reference internal" href="knife_role.html"><em>knife role</em></a></td>
137
+ <td>The <strong>knife role</strong> subcommand is used to manage the roles that are associated with one or more nodes on a Chef server.</td>
138
+ </tr>
139
+ <tr class="row-odd"><td><a class="reference internal" href="knife_search.html"><em>knife search</em></a></td>
140
+ <td>The <strong>knife search</strong> subcommand is used run a search query for information that is indexed on a Chef server.</td>
141
+ </tr>
142
+ <tr class="row-even"><td><a class="reference internal" href="knife_serve.html"><em>knife serve</em></a></td>
143
+ <td>The <strong>knife serve</strong> subcommand is used to run a persistent chef-zero against the local chef-repo. (chef-zero is a lightweight Chef server that runs in-memory on the local machine.) This is the same as running the chef-client executable with the <tt class="docutils literal"><span class="pre">--local-mode</span></tt> option. The <tt class="docutils literal"><span class="pre">chef_repo_path</span></tt> is located automatically and the Chef server will bind to the first available port between <tt class="docutils literal"><span class="pre">8889</span></tt> and <tt class="docutils literal"><span class="pre">9999</span></tt>. <strong>knife serve</strong> will print the URL for the local Chef server, so that it may be added to the knife.rb file.</td>
144
+ </tr>
145
+ <tr class="row-odd"><td><a class="reference internal" href="knife_show.html"><em>knife show</em></a></td>
146
+ <td>The <strong>knife show</strong> subcommand is used to view the details of one (or more) objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">show</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">show</span></tt>, but with a single verb (and a single action).</td>
147
+ </tr>
148
+ <tr class="row-even"><td><a class="reference internal" href="knife_ssh.html"><em>knife ssh</em></a></td>
149
+ <td>The <strong>knife ssh</strong> subcommand is used to invoke SSH commands (in parallel) on a subset of nodes within an organization, based on the results of a <a class="reference external" href="http://docs.opscode.com/essentials_search.html">search query</a> made to the Chef server.</td>
150
+ </tr>
151
+ <tr class="row-odd"><td><a class="reference internal" href="knife_ssl_check.html"><em>knife ssl check</em></a></td>
152
+ <td><p class="first">The <strong>knife ssl check</strong> subcommand is used to verify the SSL configuration for the Enterprise Chef and/or Open Source Chef servers, or at another location specified by a URL or URI.</p>
153
+ <div class="last admonition warning">
154
+ <p class="first admonition-title">Warning</p>
155
+ <p class="last">When verification of a remote server&#8217;s SSL certificate is disabled, the chef-client will issue a warning similar to &#8220;SSL validation of HTTPS requests is disabled. HTTPS connections are still encrypted, but the chef-client is not able to detect forged replies or man-in-the-middle attacks.&#8221; To configure SSL for the chef-client, set <tt class="docutils literal"><span class="pre">ssl_verify_mode</span></tt> to <tt class="docutils literal"><span class="pre">:verify_peer</span></tt> (recommended) <strong>or</strong> <tt class="docutils literal"><span class="pre">verify_api_cert</span></tt> to <tt class="docutils literal"><span class="pre">true</span></tt> in the client.rb file.</p>
156
+ </div>
157
+ </td>
158
+ </tr>
159
+ <tr class="row-even"><td><a class="reference internal" href="knife_ssl_fetch.html"><em>knife ssl fetch</em></a></td>
160
+ <td><p class="first">The <strong>knife ssl fetch</strong> subcommand is used to copy SSL certificates from an HTTPS server to the <tt class="docutils literal"><span class="pre">trusted_certs_dir</span></tt> directory that is used by knife and the chef-client to store trusted SSL certificates. When these certificates match the hostname of the remote server, running <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">ssl</span> <span class="pre">fetch</span></tt> is the only step required to verify a remote server that is accessed by either knife or the chef-client.</p>
161
+ <div class="last admonition warning">
162
+ <p class="first admonition-title">Warning</p>
163
+ <p class="last">It is the user&#8217;s responsibility to verify the authenticity of every SSL certificate before downloading it to the <tt class="docutils literal"><span class="pre">trusted_certs_dir</span></tt> directory. knife will use any certificate in that directory as if it is a 100% trusted and authentic SSL certificate. knife will not be able to determine if any certificate in this directory has been tampered with, is forged, malicious, or otherwise harmful. Therefore it is essential that users take the proper steps before downloading certificates into this directory.</p>
164
+ </div>
165
+ </td>
166
+ </tr>
167
+ <tr class="row-odd"><td><a class="reference internal" href="knife_status.html"><em>knife status</em></a></td>
168
+ <td>The <strong>knife status</strong> subcommand is used to display a brief summary of the nodes on a Chef server, including the time of the most recent successful chef-client run.</td>
169
+ </tr>
170
+ <tr class="row-even"><td><a class="reference internal" href="knife_tag.html"><em>knife tag</em></a></td>
171
+ <td>The <strong>knife tag</strong> subcommand is used to apply tags to nodes on a Chef server.</td>
172
+ </tr>
173
+ <tr class="row-odd"><td><a class="reference internal" href="knife_upload.html"><em>knife upload</em></a></td>
174
+ <td>The <strong>knife upload</strong> subcommand is used to upload roles, cookbooks, environments, and data bags to the Chef server from the current working directory in the chef-repo. This subcommand is often used in conjunction with <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">diff</span></tt>, which can be used to see exactly what changes will be uploaded, and then <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt>, which does the opposite of <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt>.</td>
175
+ </tr>
176
+ <tr class="row-even"><td><a class="reference internal" href="knife_user.html"><em>knife user</em></a></td>
177
+ <td>The <strong>knife user</strong> subcommand is used to manage the list of users and their associated RSA public key-pairs.</td>
178
+ </tr>
179
+ <tr class="row-odd"><td><a class="reference internal" href="knife_xargs.html"><em>knife xargs</em></a></td>
180
+ <td>The <strong>knife xargs</strong> subcommand is used to take patterns from standard input, download as JSON, run a command against the downloaded JSON, and then upload any changes.</td>
181
+ </tr>
182
+ </tbody>
183
+ </table>
184
+ <div class="toctree-wrapper compound">
185
+ </div>
186
+ </div>
187
+ </div>
188
+
189
+
190
+ </div>
191
+
192
+ </div>
193
+
194
+
195
+ <div class="clearer"></div>
196
+ </div>
197
+
198
+
199
+
200
+
201
+ </body>
202
202
  </html>
data/distro/common/html/knife.html CHANGED
@@ -1,170 +1,170 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
-
4
-
5
- <html xmlns="http://www.w3.org/1999/xhtml">
6
- <head>
7
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
-
9
- <title>knife &mdash; chef-client Man Pages</title>
10
-
11
- <link rel="stylesheet" href="_static/guide.css" type="text/css" />
12
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
13
-
14
- <script type="text/javascript">
15
- var DOCUMENTATION_OPTIONS = {
16
- URL_ROOT: './',
17
- VERSION: '',
18
- COLLAPSE_INDEX: false,
19
- FILE_SUFFIX: '.html',
20
- HAS_SOURCE: true
21
- };
22
- </script>
23
- <script type="text/javascript" src="_static/jquery.js"></script>
24
- <script type="text/javascript" src="_static/underscore.js"></script>
25
- <script type="text/javascript" src="_static/doctools.js"></script>
26
-
27
-
28
- </head>
29
- <body>
30
- <div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
31
- <a href="http://docs.getchef.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
32
- </div>
33
-
34
-
35
-
36
-
37
- <div class="document">
38
- <div class="documentwrapper">
39
-
40
- <div class="body">
41
-
42
- <div class="section" id="knife">
43
- <h1>knife<a class="headerlink" href="#knife" title="Permalink to this headline">¶</a></h1>
44
- <p>knife is a command-line tool that provides an interface between a local chef-repo and the Chef server. knife helps users to manage:</p>
45
- <ul class="simple">
46
- <li>Nodes</li>
47
- <li>Cookbooks and recipes</li>
48
- <li>Roles</li>
49
- <li>Stores of JSON data (data bags), including encrypted data</li>
50
- <li>Environments</li>
51
- <li>Cloud resources, including provisioning</li>
52
- <li>The installation of the chef-client on management workstations</li>
53
- <li>Searching of indexed data on the Chef server</li>
54
- </ul>
55
- <p>The following sections describe functionality common to all knife subcommands:</p>
56
- <ul class="simple">
57
- <li><a class="reference internal" href="knife_using.html"><em>Working with Knife</em></a></li>
58
- <li><a class="reference internal" href="knife_common_options.html"><em>Common Options</em></a></li>
59
- </ul>
60
- <p>knife includes the following sub-commands:</p>
61
- <table border="1" class="docutils">
62
- <colgroup>
63
- <col width="25%" />
64
- <col width="75%" />
65
- </colgroup>
66
- <thead valign="bottom">
67
- <tr class="row-odd"><th class="head">Sub-command</th>
68
- <th class="head">Description</th>
69
- </tr>
70
- </thead>
71
- <tbody valign="top">
72
- <tr class="row-even"><td><a class="reference internal" href="knife_bootstrap.html"><em>knife bootstrap</em></a></td>
73
- <td>The <strong>knife bootstrap</strong> subcommand is used to run a bootstrap operation that installs the chef-client on the target system. The bootstrap operation must specify the IP address or FQDN of the target system.</td>
74
- </tr>
75
- <tr class="row-odd"><td><a class="reference internal" href="knife_client.html"><em>knife client</em></a></td>
76
- <td>The <strong>knife client</strong> subcommand is used to manage an API client list and their associated RSA public key-pairs. This allows authentication requests to be made to the Chef server by any entity that uses the Chef server API, such as the chef-client and knife.</td>
77
- </tr>
78
- <tr class="row-even"><td><a class="reference internal" href="knife_configure.html"><em>knife configure</em></a></td>
79
- <td>The <strong>knife configure</strong> subcommand is used to create the knife.rb and client.rb files so that they can be distributed to workstations and nodes.</td>
80
- </tr>
81
- <tr class="row-odd"><td><a class="reference internal" href="knife_cookbook.html"><em>knife cookbook</em></a></td>
82
- <td>The <strong>knife cookbook</strong> subcommand is used to interact with cookbooks that are located on the Chef server or the local chef-repo.</td>
83
- </tr>
84
- <tr class="row-even"><td><a class="reference internal" href="knife_cookbook_site.html"><em>knife cookbook site</em></a></td>
85
- <td>The <strong>knife cookbook site</strong> subcommand is used to interact with cookbooks that are located at <a class="reference external" href="https://supermarket.getchef.com/cookbooks">https://supermarket.getchef.com/cookbooks</a>. A user account is required for any community actions that write data to this site. The following arguments do not require a user account: <tt class="docutils literal"><span class="pre">download</span></tt>, <tt class="docutils literal"><span class="pre">search</span></tt>, <tt class="docutils literal"><span class="pre">install</span></tt>, and <tt class="docutils literal"><span class="pre">list</span></tt>.</td>
86
- </tr>
87
- <tr class="row-odd"><td><a class="reference internal" href="knife_data_bag.html"><em>knife data bag</em></a></td>
88
- <td>The <strong>knife data bag</strong> subcommand is used to manage arbitrary stores of globally available JSON data.</td>
89
- </tr>
90
- <tr class="row-even"><td><a class="reference internal" href="knife_delete.html"><em>knife delete</em></a></td>
91
- <td>The <strong>knife delete</strong> subcommand is used to delete an object from a Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">delete</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">delete</span></tt>, but with a single verb (and a single action).</td>
92
- </tr>
93
- <tr class="row-odd"><td><a class="reference internal" href="knife_deps.html"><em>knife deps</em></a></td>
94
- <td>The <strong>knife deps</strong> subcommand is used to identify dependencies for a node, role, or cookbook.</td>
95
- </tr>
96
- <tr class="row-even"><td><a class="reference internal" href="knife_diff.html"><em>knife diff</em></a></td>
97
- <td>The <strong>knife diff</strong> subcommand is used to compare the differences between files and directories on the Chef server and in the chef-repo. For example, to compare files on the Chef server prior to an uploading or downloading files using the <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt> and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt> subcommands, or to ensure that certain files in multiple production environments are the same. This subcommand is similar to the <tt class="docutils literal"><span class="pre">git</span> <span class="pre">diff</span></tt> command that can be used to diff what is in the chef-repo with what is synced to a git repository.</td>
98
- </tr>
99
- <tr class="row-odd"><td><a class="reference internal" href="knife_download.html"><em>knife download</em></a></td>
100
- <td>The <strong>knife download</strong> subcommand is used to download roles, cookbooks, environments, nodes, and data bags from the Chef server to the current working directory. It can be used to back up data on the Chef server, inspect the state of one or more files, or to extract out-of-process changes users may have made to files on the Chef server, such as if a user made a change that bypassed version source control. This subcommand is often used in conjunction with <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">diff</span></tt>, which can be used to see exactly what changes will be downloaded, and then <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt>, which does the opposite of <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt>.</td>
101
- </tr>
102
- <tr class="row-even"><td><a class="reference internal" href="knife_edit.html"><em>knife edit</em></a></td>
103
- <td>The <strong>knife edit</strong> subcommand is used to edit objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">edit</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">edit</span></tt>, but with a single verb (and a single action).</td>
104
- </tr>
105
- <tr class="row-odd"><td><a class="reference internal" href="knife_environment.html"><em>knife environment</em></a></td>
106
- <td>The <strong>knife environment</strong> subcommand is used to manage environments within a single organization on the Chef server.</td>
107
- </tr>
108
- <tr class="row-even"><td><a class="reference internal" href="knife_exec.html"><em>knife exec</em></a></td>
109
- <td>The <strong>knife exec</strong> subcommand uses the knife configuration file to execute Ruby scripts in the context of a fully configured chef-client. This subcommand is most often used to run scripts that will only access Chef server one time (or otherwise very infrequently). Use this subcommand any time that an operation does not warrant full usage of the knife subcommand library.</td>
110
- </tr>
111
- <tr class="row-odd"><td><a class="reference internal" href="knife_index_rebuild.html"><em>knife index rebuild</em></a></td>
112
- <td>The <strong>knife index rebuild</strong> subcommand is used to rebuild the search indexes for the open source Chef server. This operation is destructive and may take some time.</td>
113
- </tr>
114
- <tr class="row-even"><td><a class="reference internal" href="knife_list.html"><em>knife list</em></a></td>
115
- <td>The <strong>knife list</strong> subcommand is used to view a list of objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">list</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">list</span></tt>, but with a single verb (and a single action).</td>
116
- </tr>
117
- <tr class="row-odd"><td><a class="reference internal" href="knife_node.html"><em>knife node</em></a></td>
118
- <td>The <strong>knife node</strong> subcommand is used to manage the nodes that exist on a Chef server.</td>
119
- </tr>
120
- <tr class="row-even"><td><a class="reference internal" href="knife_raw.html"><em>knife raw</em></a></td>
121
- <td>The <strong>knife raw</strong> subcommand is used to send a REST request to an endpoint in the Chef server API.</td>
122
- </tr>
123
- <tr class="row-odd"><td><a class="reference internal" href="knife_recipe_list.html"><em>knife recipe list</em></a></td>
124
- <td>The <strong>knife recipe list</strong> subcommand is used to view all of the recipes that are on a Chef server. A regular expression can be used to limit the results to recipes that match a specific pattern. The regular expression must be within quotes and not be surrounded by forward slashes (/).</td>
125
- </tr>
126
- <tr class="row-even"><td><a class="reference internal" href="knife_role.html"><em>knife role</em></a></td>
127
- <td>The <strong>knife role</strong> subcommand is used to manage the roles that are associated with one or more nodes on a Chef server.</td>
128
- </tr>
129
- <tr class="row-odd"><td><a class="reference internal" href="knife_search.html"><em>knife search</em></a></td>
130
- <td>The <strong>knife search</strong> subcommand is used run a search query for information that is indexed on a Chef server.</td>
131
- </tr>
132
- <tr class="row-even"><td><a class="reference internal" href="knife_show.html"><em>knife show</em></a></td>
133
- <td>The <strong>knife show</strong> subcommand is used to view the details of one (or more) objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">show</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">show</span></tt>, but with a single verb (and a single action).</td>
134
- </tr>
135
- <tr class="row-odd"><td><a class="reference internal" href="knife_ssh.html"><em>knife ssh</em></a></td>
136
- <td>The <strong>knife ssh</strong> subcommand is used to invoke SSH commands (in parallel) on a subset of nodes within an organization, based on the results of a <a class="reference external" href="http://docs.opscode.com/essentials_search.html">search query</a> made to the Chef server.</td>
137
- </tr>
138
- <tr class="row-even"><td><a class="reference internal" href="knife_status.html"><em>knife status</em></a></td>
139
- <td>The <strong>knife status</strong> subcommand is used to display a brief summary of the nodes on a Chef server, including the time of the most recent successful chef-client run.</td>
140
- </tr>
141
- <tr class="row-odd"><td><a class="reference internal" href="knife_tag.html"><em>knife tag</em></a></td>
142
- <td>The <strong>knife tag</strong> subcommand is used to apply tags to nodes on a Chef server.</td>
143
- </tr>
144
- <tr class="row-even"><td><a class="reference internal" href="knife_upload.html"><em>knife upload</em></a></td>
145
- <td>The <strong>knife upload</strong> subcommand is used to upload roles, cookbooks, environments, and data bags to the Chef server from the current working directory in the chef-repo. This subcommand is often used in conjunction with <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">diff</span></tt>, which can be used to see exactly what changes will be uploaded, and then <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt>, which does the opposite of <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt>.</td>
146
- </tr>
147
- <tr class="row-odd"><td><a class="reference internal" href="knife_user.html"><em>knife user</em></a></td>
148
- <td>The <strong>knife user</strong> subcommand is used to manage the list of users and their associated RSA public key-pairs.</td>
149
- </tr>
150
- <tr class="row-even"><td><a class="reference internal" href="knife_xargs.html"><em>knife xargs</em></a></td>
151
- <td>The <strong>knife xargs</strong> subcommand is used to take patterns from standard input, download as JSON, run a command against the downloaded JSON, and then upload any changes.</td>
152
- </tr>
153
- </tbody>
154
- </table>
155
- </div>
156
-
157
-
158
- </div>
159
-
160
- </div>
161
-
162
-
163
- <div class="clearer"></div>
164
- </div>
165
-
166
-
167
-
168
-
169
- </body>
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
+
4
+
5
+ <html xmlns="http://www.w3.org/1999/xhtml">
6
+ <head>
7
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
+
9
+ <title>knife &mdash; chef-client Man Pages</title>
10
+
11
+ <link rel="stylesheet" href="_static/guide.css" type="text/css" />
12
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
13
+
14
+ <script type="text/javascript">
15
+ var DOCUMENTATION_OPTIONS = {
16
+ URL_ROOT: './',
17
+ VERSION: '',
18
+ COLLAPSE_INDEX: false,
19
+ FILE_SUFFIX: '.html',
20
+ HAS_SOURCE: true
21
+ };
22
+ </script>
23
+ <script type="text/javascript" src="_static/jquery.js"></script>
24
+ <script type="text/javascript" src="_static/underscore.js"></script>
25
+ <script type="text/javascript" src="_static/doctools.js"></script>
26
+
27
+
28
+ </head>
29
+ <body>
30
+ <div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
31
+ <a href="http://docs.getchef.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
32
+ </div>
33
+
34
+
35
+
36
+
37
+ <div class="document">
38
+ <div class="documentwrapper">
39
+
40
+ <div class="body">
41
+
42
+ <div class="section" id="knife">
43
+ <h1>knife<a class="headerlink" href="#knife" title="Permalink to this headline">¶</a></h1>
44
+ <p>knife is a command-line tool that provides an interface between a local chef-repo and the Chef server. knife helps users to manage:</p>
45
+ <ul class="simple">
46
+ <li>Nodes</li>
47
+ <li>Cookbooks and recipes</li>
48
+ <li>Roles</li>
49
+ <li>Stores of JSON data (data bags), including encrypted data</li>
50
+ <li>Environments</li>
51
+ <li>Cloud resources, including provisioning</li>
52
+ <li>The installation of the chef-client on management workstations</li>
53
+ <li>Searching of indexed data on the Chef server</li>
54
+ </ul>
55
+ <p>The following sections describe functionality common to all knife subcommands:</p>
56
+ <ul class="simple">
57
+ <li><a class="reference internal" href="knife_using.html"><em>Working with Knife</em></a></li>
58
+ <li><a class="reference internal" href="knife_common_options.html"><em>Common Options</em></a></li>
59
+ </ul>
60
+ <p>knife includes the following sub-commands:</p>
61
+ <table border="1" class="docutils">
62
+ <colgroup>
63
+ <col width="25%" />
64
+ <col width="75%" />
65
+ </colgroup>
66
+ <thead valign="bottom">
67
+ <tr class="row-odd"><th class="head">Sub-command</th>
68
+ <th class="head">Description</th>
69
+ </tr>
70
+ </thead>
71
+ <tbody valign="top">
72
+ <tr class="row-even"><td><a class="reference internal" href="knife_bootstrap.html"><em>knife bootstrap</em></a></td>
73
+ <td>The <strong>knife bootstrap</strong> subcommand is used to run a bootstrap operation that installs the chef-client on the target system. The bootstrap operation must specify the IP address or FQDN of the target system.</td>
74
+ </tr>
75
+ <tr class="row-odd"><td><a class="reference internal" href="knife_client.html"><em>knife client</em></a></td>
76
+ <td>The <strong>knife client</strong> subcommand is used to manage an API client list and their associated RSA public key-pairs. This allows authentication requests to be made to the Chef server by any entity that uses the Chef server API, such as the chef-client and knife.</td>
77
+ </tr>
78
+ <tr class="row-even"><td><a class="reference internal" href="knife_configure.html"><em>knife configure</em></a></td>
79
+ <td>The <strong>knife configure</strong> subcommand is used to create the knife.rb and client.rb files so that they can be distributed to workstations and nodes.</td>
80
+ </tr>
81
+ <tr class="row-odd"><td><a class="reference internal" href="knife_cookbook.html"><em>knife cookbook</em></a></td>
82
+ <td>The <strong>knife cookbook</strong> subcommand is used to interact with cookbooks that are located on the Chef server or the local chef-repo.</td>
83
+ </tr>
84
+ <tr class="row-even"><td><a class="reference internal" href="knife_cookbook_site.html"><em>knife cookbook site</em></a></td>
85
+ <td>The <strong>knife cookbook site</strong> subcommand is used to interact with cookbooks that are located at <a class="reference external" href="https://supermarket.getchef.com/cookbooks">https://supermarket.getchef.com/cookbooks</a>. A user account is required for any community actions that write data to this site. The following arguments do not require a user account: <tt class="docutils literal"><span class="pre">download</span></tt>, <tt class="docutils literal"><span class="pre">search</span></tt>, <tt class="docutils literal"><span class="pre">install</span></tt>, and <tt class="docutils literal"><span class="pre">list</span></tt>.</td>
86
+ </tr>
87
+ <tr class="row-odd"><td><a class="reference internal" href="knife_data_bag.html"><em>knife data bag</em></a></td>
88
+ <td>The <strong>knife data bag</strong> subcommand is used to manage arbitrary stores of globally available JSON data.</td>
89
+ </tr>
90
+ <tr class="row-even"><td><a class="reference internal" href="knife_delete.html"><em>knife delete</em></a></td>
91
+ <td>The <strong>knife delete</strong> subcommand is used to delete an object from a Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">delete</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">delete</span></tt>, but with a single verb (and a single action).</td>
92
+ </tr>
93
+ <tr class="row-odd"><td><a class="reference internal" href="knife_deps.html"><em>knife deps</em></a></td>
94
+ <td>The <strong>knife deps</strong> subcommand is used to identify dependencies for a node, role, or cookbook.</td>
95
+ </tr>
96
+ <tr class="row-even"><td><a class="reference internal" href="knife_diff.html"><em>knife diff</em></a></td>
97
+ <td>The <strong>knife diff</strong> subcommand is used to compare the differences between files and directories on the Chef server and in the chef-repo. For example, to compare files on the Chef server prior to an uploading or downloading files using the <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt> and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt> subcommands, or to ensure that certain files in multiple production environments are the same. This subcommand is similar to the <tt class="docutils literal"><span class="pre">git</span> <span class="pre">diff</span></tt> command that can be used to diff what is in the chef-repo with what is synced to a git repository.</td>
98
+ </tr>
99
+ <tr class="row-odd"><td><a class="reference internal" href="knife_download.html"><em>knife download</em></a></td>
100
+ <td>The <strong>knife download</strong> subcommand is used to download roles, cookbooks, environments, nodes, and data bags from the Chef server to the current working directory. It can be used to back up data on the Chef server, inspect the state of one or more files, or to extract out-of-process changes users may have made to files on the Chef server, such as if a user made a change that bypassed version source control. This subcommand is often used in conjunction with <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">diff</span></tt>, which can be used to see exactly what changes will be downloaded, and then <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt>, which does the opposite of <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt>.</td>
101
+ </tr>
102
+ <tr class="row-even"><td><a class="reference internal" href="knife_edit.html"><em>knife edit</em></a></td>
103
+ <td>The <strong>knife edit</strong> subcommand is used to edit objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">edit</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">edit</span></tt>, but with a single verb (and a single action).</td>
104
+ </tr>
105
+ <tr class="row-odd"><td><a class="reference internal" href="knife_environment.html"><em>knife environment</em></a></td>
106
+ <td>The <strong>knife environment</strong> subcommand is used to manage environments within a single organization on the Chef server.</td>
107
+ </tr>
108
+ <tr class="row-even"><td><a class="reference internal" href="knife_exec.html"><em>knife exec</em></a></td>
109
+ <td>The <strong>knife exec</strong> subcommand uses the knife configuration file to execute Ruby scripts in the context of a fully configured chef-client. This subcommand is most often used to run scripts that will only access Chef server one time (or otherwise very infrequently). Use this subcommand any time that an operation does not warrant full usage of the knife subcommand library.</td>
110
+ </tr>
111
+ <tr class="row-odd"><td><a class="reference internal" href="knife_index_rebuild.html"><em>knife index rebuild</em></a></td>
112
+ <td>The <strong>knife index rebuild</strong> subcommand is used to rebuild the search indexes for the open source Chef server. This operation is destructive and may take some time.</td>
113
+ </tr>
114
+ <tr class="row-even"><td><a class="reference internal" href="knife_list.html"><em>knife list</em></a></td>
115
+ <td>The <strong>knife list</strong> subcommand is used to view a list of objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">list</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">list</span></tt>, but with a single verb (and a single action).</td>
116
+ </tr>
117
+ <tr class="row-odd"><td><a class="reference internal" href="knife_node.html"><em>knife node</em></a></td>
118
+ <td>The <strong>knife node</strong> subcommand is used to manage the nodes that exist on a Chef server.</td>
119
+ </tr>
120
+ <tr class="row-even"><td><a class="reference internal" href="knife_raw.html"><em>knife raw</em></a></td>
121
+ <td>The <strong>knife raw</strong> subcommand is used to send a REST request to an endpoint in the Chef server API.</td>
122
+ </tr>
123
+ <tr class="row-odd"><td><a class="reference internal" href="knife_recipe_list.html"><em>knife recipe list</em></a></td>
124
+ <td>The <strong>knife recipe list</strong> subcommand is used to view all of the recipes that are on a Chef server. A regular expression can be used to limit the results to recipes that match a specific pattern. The regular expression must be within quotes and not be surrounded by forward slashes (/).</td>
125
+ </tr>
126
+ <tr class="row-even"><td><a class="reference internal" href="knife_role.html"><em>knife role</em></a></td>
127
+ <td>The <strong>knife role</strong> subcommand is used to manage the roles that are associated with one or more nodes on a Chef server.</td>
128
+ </tr>
129
+ <tr class="row-odd"><td><a class="reference internal" href="knife_search.html"><em>knife search</em></a></td>
130
+ <td>The <strong>knife search</strong> subcommand is used run a search query for information that is indexed on a Chef server.</td>
131
+ </tr>
132
+ <tr class="row-even"><td><a class="reference internal" href="knife_show.html"><em>knife show</em></a></td>
133
+ <td>The <strong>knife show</strong> subcommand is used to view the details of one (or more) objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">show</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">show</span></tt>, but with a single verb (and a single action).</td>
134
+ </tr>
135
+ <tr class="row-odd"><td><a class="reference internal" href="knife_ssh.html"><em>knife ssh</em></a></td>
136
+ <td>The <strong>knife ssh</strong> subcommand is used to invoke SSH commands (in parallel) on a subset of nodes within an organization, based on the results of a <a class="reference external" href="http://docs.opscode.com/essentials_search.html">search query</a> made to the Chef server.</td>
137
+ </tr>
138
+ <tr class="row-even"><td><a class="reference internal" href="knife_status.html"><em>knife status</em></a></td>
139
+ <td>The <strong>knife status</strong> subcommand is used to display a brief summary of the nodes on a Chef server, including the time of the most recent successful chef-client run.</td>
140
+ </tr>
141
+ <tr class="row-odd"><td><a class="reference internal" href="knife_tag.html"><em>knife tag</em></a></td>
142
+ <td>The <strong>knife tag</strong> subcommand is used to apply tags to nodes on a Chef server.</td>
143
+ </tr>
144
+ <tr class="row-even"><td><a class="reference internal" href="knife_upload.html"><em>knife upload</em></a></td>
145
+ <td>The <strong>knife upload</strong> subcommand is used to upload roles, cookbooks, environments, and data bags to the Chef server from the current working directory in the chef-repo. This subcommand is often used in conjunction with <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">diff</span></tt>, which can be used to see exactly what changes will be uploaded, and then <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt>, which does the opposite of <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt>.</td>
146
+ </tr>
147
+ <tr class="row-odd"><td><a class="reference internal" href="knife_user.html"><em>knife user</em></a></td>
148
+ <td>The <strong>knife user</strong> subcommand is used to manage the list of users and their associated RSA public key-pairs.</td>
149
+ </tr>
150
+ <tr class="row-even"><td><a class="reference internal" href="knife_xargs.html"><em>knife xargs</em></a></td>
151
+ <td>The <strong>knife xargs</strong> subcommand is used to take patterns from standard input, download as JSON, run a command against the downloaded JSON, and then upload any changes.</td>
152
+ </tr>
153
+ </tbody>
154
+ </table>
155
+ </div>
156
+
157
+
158
+ </div>
159
+
160
+ </div>
161
+
162
+
163
+ <div class="clearer"></div>
164
+ </div>
165
+
166
+
167
+
168
+
169
+ </body>
170
170
  </html>