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
@@ -1,153 +1,153 @@
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 upload &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-upload">
43
- <h1>knife upload<a class="headerlink" href="#knife-upload" title="Permalink to this headline">¶</a></h1>
44
- <p>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>.</p>
45
- <div class="section" id="syntax">
46
- <h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
47
- <p>This subcommand has the following syntax:</p>
48
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload <span class="o">[</span>PATTERN...<span class="o">]</span> <span class="o">(</span>options<span class="o">)</span>
49
- </pre></div>
50
- </div>
51
- </div>
52
- <div class="section" id="options">
53
- <h2>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
54
- <div class="admonition note">
55
- <p class="first admonition-title">Note</p>
56
- <p class="last">Review the list of <a class="reference internal" href="knife_common_options.html"><em>common options</em></a> available to this (and all) knife subcommands and plugins.</p>
57
- </div>
58
- <p>This subcommand has the following options:</p>
59
- <dl class="docutils">
60
- <dt><tt class="docutils literal"><span class="pre">--chef-repo-path</span> <span class="pre">PATH</span></tt></dt>
61
- <dd>The path to the chef-repo. This setting will override the default path to the chef-repo. Default: same value as specified by <tt class="docutils literal"><span class="pre">chef_repo_path</span></tt> in client.rb.</dd>
62
- <dt><tt class="docutils literal"><span class="pre">--concurrency</span></tt></dt>
63
- <dd>The number of allowed concurrent connections. Default: <tt class="docutils literal"><span class="pre">10</span></tt>.</dd>
64
- <dt><tt class="docutils literal"><span class="pre">--[no-]diff</span></tt></dt>
65
- <dd>Use to upload only new and modified files. Set to <tt class="docutils literal"><span class="pre">false</span></tt> to upload all files. Default: <tt class="docutils literal"><span class="pre">true</span></tt>.</dd>
66
- <dt><tt class="docutils literal"><span class="pre">--[no-]force</span></tt></dt>
67
- <dd>Use <tt class="docutils literal"><span class="pre">--force</span></tt> to upload roles, cookbooks, etc. even if the file in the directory is identical (by default, no <tt class="docutils literal"><span class="pre">POST</span></tt> or <tt class="docutils literal"><span class="pre">PUT</span></tt> is performed unless an actual change would be made). Default: <tt class="docutils literal"><span class="pre">--no-force</span></tt>.</dd>
68
- <dt><tt class="docutils literal"><span class="pre">--[no-]freeze</span></tt></dt>
69
- <dd>Use to require changes to a cookbook be included as a new version. Only the <tt class="docutils literal"><span class="pre">--force</span></tt> option can override this setting. Default: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
70
- <dt><tt class="docutils literal"><span class="pre">-n</span></tt>, <tt class="docutils literal"><span class="pre">--dry-run</span></tt></dt>
71
- <dd>Use to take no action and only print out results. Default: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
72
- <dt><tt class="docutils literal"><span class="pre">--[no-]purge</span></tt></dt>
73
- <dd>Use <tt class="docutils literal"><span class="pre">--purge</span></tt> to delete roles, cookbooks, etc. from the Chef server if their corresponding files do not exist in the chef-repo. By default, such objects are left alone and NOT purged. Default: <tt class="docutils literal"><span class="pre">--no-purge</span></tt>.</dd>
74
- <dt><tt class="docutils literal"><span class="pre">--[no-]recurse</span></tt></dt>
75
- <dd>Use <tt class="docutils literal"><span class="pre">--no-recurse</span></tt> to disable uploading a directory recursively. Default: <tt class="docutils literal"><span class="pre">--recurse</span></tt>.</dd>
76
- <dt><tt class="docutils literal"><span class="pre">--repo-mode</span> <span class="pre">MODE</span></tt></dt>
77
- <dd>The layout of the local chef-repo. Possible values: <tt class="docutils literal"><span class="pre">static</span></tt>, <tt class="docutils literal"><span class="pre">everything</span></tt>, or <tt class="docutils literal"><span class="pre">hosted_everything</span></tt>. Use <tt class="docutils literal"><span class="pre">static</span></tt> for just roles, environments, cookbooks, and data bags. By default, <tt class="docutils literal"><span class="pre">everything</span></tt> and <tt class="docutils literal"><span class="pre">hosted_everything</span></tt> are dynamically selected depending on the server type. Default: <tt class="docutils literal"><span class="pre">everything</span></tt> / <tt class="docutils literal"><span class="pre">hosted_everything</span></tt>.</dd>
78
- </dl>
79
- </div>
80
- <div class="section" id="examples">
81
- <h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
82
- <p>The following examples show how to use this knife subcommand:</p>
83
- <p><strong>Upload the entire chef-repo</strong></p>
84
- <p>Browse to the top level of the chef-repo and enter:</p>
85
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload
86
- </pre></div>
87
- </div>
88
- <p>or from anywhere in the chef-repo, enter:</p>
89
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /
90
- </pre></div>
91
- </div>
92
- <p><strong>Upload the /cookbooks directory</strong></p>
93
- <p>Browse to the top level of the chef-repo and enter:</p>
94
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload cookbooks
95
- </pre></div>
96
- </div>
97
- <p>or from anywhere in the chef-repo, enter:</p>
98
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /cookbooks
99
- </pre></div>
100
- </div>
101
- <p><strong>Upload the /environments directory</strong></p>
102
- <p>Browse to the top level of the chef-repo and enter:</p>
103
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload environments
104
- </pre></div>
105
- </div>
106
- <p>or from anywhere in the chef-repo, enter:</p>
107
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /environments
108
- </pre></div>
109
- </div>
110
- <p><strong>Upload a single environment</strong></p>
111
- <p>Browse to the top level of the chef-repo and enter:</p>
112
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload environments/production.json
113
- </pre></div>
114
- </div>
115
- <p>or from the <tt class="docutils literal"><span class="pre">environments/</span></tt> directory, enter:</p>
116
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload production.json
117
- </pre></div>
118
- </div>
119
- <p><strong>Upload the /roles directory</strong></p>
120
- <p>Browse to the top level of the chef-repo and enter:</p>
121
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload roles
122
- </pre></div>
123
- </div>
124
- <p>or from anywhere in the chef-repo, enter:</p>
125
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /roles
126
- </pre></div>
127
- </div>
128
- <p><strong>Upload cookbooks and roles</strong></p>
129
- <p>Browse to the top level of the chef-repo and enter:</p>
130
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload cookbooks/apache<span class="se">\*</span> roles/webserver.json
131
- </pre></div>
132
- </div>
133
- <p><strong>Use output of knife deps to pass command to knife upload</strong></p>
134
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload <span class="sb">`</span>knife deps nodes/*.json<span class="sb">`</span>
135
- </pre></div>
136
- </div>
137
- </div>
138
- </div>
139
-
140
-
141
- </div>
142
-
143
- </div>
144
-
145
-
146
- <div class="clearer"></div>
147
- </div>
148
-
149
-
150
-
151
-
152
- </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 upload &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-upload">
43
+ <h1>knife upload<a class="headerlink" href="#knife-upload" title="Permalink to this headline">¶</a></h1>
44
+ <p>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>.</p>
45
+ <div class="section" id="syntax">
46
+ <h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
47
+ <p>This subcommand has the following syntax:</p>
48
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload <span class="o">[</span>PATTERN...<span class="o">]</span> <span class="o">(</span>options<span class="o">)</span>
49
+ </pre></div>
50
+ </div>
51
+ </div>
52
+ <div class="section" id="options">
53
+ <h2>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
54
+ <div class="admonition note">
55
+ <p class="first admonition-title">Note</p>
56
+ <p class="last">Review the list of <a class="reference internal" href="knife_common_options.html"><em>common options</em></a> available to this (and all) knife subcommands and plugins.</p>
57
+ </div>
58
+ <p>This subcommand has the following options:</p>
59
+ <dl class="docutils">
60
+ <dt><tt class="docutils literal"><span class="pre">--chef-repo-path</span> <span class="pre">PATH</span></tt></dt>
61
+ <dd>The path to the chef-repo. This setting will override the default path to the chef-repo. Default: same value as specified by <tt class="docutils literal"><span class="pre">chef_repo_path</span></tt> in client.rb.</dd>
62
+ <dt><tt class="docutils literal"><span class="pre">--concurrency</span></tt></dt>
63
+ <dd>The number of allowed concurrent connections. Default: <tt class="docutils literal"><span class="pre">10</span></tt>.</dd>
64
+ <dt><tt class="docutils literal"><span class="pre">--[no-]diff</span></tt></dt>
65
+ <dd>Use to upload only new and modified files. Set to <tt class="docutils literal"><span class="pre">false</span></tt> to upload all files. Default: <tt class="docutils literal"><span class="pre">true</span></tt>.</dd>
66
+ <dt><tt class="docutils literal"><span class="pre">--[no-]force</span></tt></dt>
67
+ <dd>Use <tt class="docutils literal"><span class="pre">--force</span></tt> to upload roles, cookbooks, etc. even if the file in the directory is identical (by default, no <tt class="docutils literal"><span class="pre">POST</span></tt> or <tt class="docutils literal"><span class="pre">PUT</span></tt> is performed unless an actual change would be made). Default: <tt class="docutils literal"><span class="pre">--no-force</span></tt>.</dd>
68
+ <dt><tt class="docutils literal"><span class="pre">--[no-]freeze</span></tt></dt>
69
+ <dd>Use to require changes to a cookbook be included as a new version. Only the <tt class="docutils literal"><span class="pre">--force</span></tt> option can override this setting. Default: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
70
+ <dt><tt class="docutils literal"><span class="pre">-n</span></tt>, <tt class="docutils literal"><span class="pre">--dry-run</span></tt></dt>
71
+ <dd>Use to take no action and only print out results. Default: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
72
+ <dt><tt class="docutils literal"><span class="pre">--[no-]purge</span></tt></dt>
73
+ <dd>Use <tt class="docutils literal"><span class="pre">--purge</span></tt> to delete roles, cookbooks, etc. from the Chef server if their corresponding files do not exist in the chef-repo. By default, such objects are left alone and NOT purged. Default: <tt class="docutils literal"><span class="pre">--no-purge</span></tt>.</dd>
74
+ <dt><tt class="docutils literal"><span class="pre">--[no-]recurse</span></tt></dt>
75
+ <dd>Use <tt class="docutils literal"><span class="pre">--no-recurse</span></tt> to disable uploading a directory recursively. Default: <tt class="docutils literal"><span class="pre">--recurse</span></tt>.</dd>
76
+ <dt><tt class="docutils literal"><span class="pre">--repo-mode</span> <span class="pre">MODE</span></tt></dt>
77
+ <dd>The layout of the local chef-repo. Possible values: <tt class="docutils literal"><span class="pre">static</span></tt>, <tt class="docutils literal"><span class="pre">everything</span></tt>, or <tt class="docutils literal"><span class="pre">hosted_everything</span></tt>. Use <tt class="docutils literal"><span class="pre">static</span></tt> for just roles, environments, cookbooks, and data bags. By default, <tt class="docutils literal"><span class="pre">everything</span></tt> and <tt class="docutils literal"><span class="pre">hosted_everything</span></tt> are dynamically selected depending on the server type. Default: <tt class="docutils literal"><span class="pre">everything</span></tt> / <tt class="docutils literal"><span class="pre">hosted_everything</span></tt>.</dd>
78
+ </dl>
79
+ </div>
80
+ <div class="section" id="examples">
81
+ <h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
82
+ <p>The following examples show how to use this knife subcommand:</p>
83
+ <p><strong>Upload the entire chef-repo</strong></p>
84
+ <p>Browse to the top level of the chef-repo and enter:</p>
85
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload
86
+ </pre></div>
87
+ </div>
88
+ <p>or from anywhere in the chef-repo, enter:</p>
89
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /
90
+ </pre></div>
91
+ </div>
92
+ <p><strong>Upload the /cookbooks directory</strong></p>
93
+ <p>Browse to the top level of the chef-repo and enter:</p>
94
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload cookbooks
95
+ </pre></div>
96
+ </div>
97
+ <p>or from anywhere in the chef-repo, enter:</p>
98
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /cookbooks
99
+ </pre></div>
100
+ </div>
101
+ <p><strong>Upload the /environments directory</strong></p>
102
+ <p>Browse to the top level of the chef-repo and enter:</p>
103
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload environments
104
+ </pre></div>
105
+ </div>
106
+ <p>or from anywhere in the chef-repo, enter:</p>
107
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /environments
108
+ </pre></div>
109
+ </div>
110
+ <p><strong>Upload a single environment</strong></p>
111
+ <p>Browse to the top level of the chef-repo and enter:</p>
112
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload environments/production.json
113
+ </pre></div>
114
+ </div>
115
+ <p>or from the <tt class="docutils literal"><span class="pre">environments/</span></tt> directory, enter:</p>
116
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload production.json
117
+ </pre></div>
118
+ </div>
119
+ <p><strong>Upload the /roles directory</strong></p>
120
+ <p>Browse to the top level of the chef-repo and enter:</p>
121
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload roles
122
+ </pre></div>
123
+ </div>
124
+ <p>or from anywhere in the chef-repo, enter:</p>
125
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /roles
126
+ </pre></div>
127
+ </div>
128
+ <p><strong>Upload cookbooks and roles</strong></p>
129
+ <p>Browse to the top level of the chef-repo and enter:</p>
130
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload cookbooks/apache<span class="se">\*</span> roles/webserver.json
131
+ </pre></div>
132
+ </div>
133
+ <p><strong>Use output of knife deps to pass command to knife upload</strong></p>
134
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload <span class="sb">`</span>knife deps nodes/*.json<span class="sb">`</span>
135
+ </pre></div>
136
+ </div>
137
+ </div>
138
+ </div>
139
+
140
+
141
+ </div>
142
+
143
+ </div>
144
+
145
+
146
+ <div class="clearer"></div>
147
+ </div>
148
+
149
+
150
+
151
+
152
+ </body>
153
153
  </html>
@@ -1,242 +1,242 @@
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 user &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-user">
43
- <h1>knife user<a class="headerlink" href="#knife-user" title="Permalink to this headline">¶</a></h1>
44
- <p>The <strong>knife user</strong> subcommand is used to manage the list of users and their associated RSA public key-pairs.</p>
45
- <div class="admonition note">
46
- <p class="first admonition-title">Note</p>
47
- <p class="last">This subcommand ONLY works when run against the open source Chef server and will not run against Enterprise Chef (including hosted Enterprise Chef), or Private Chef.</p>
48
- </div>
49
- <div class="admonition note">
50
- <p class="first admonition-title">Note</p>
51
- <p class="last">Review the list of <a class="reference internal" href="knife_common_options.html"><em>common options</em></a> available to this (and all) knife subcommands and plugins.</p>
52
- </div>
53
- <div class="section" id="create">
54
- <h2>create<a class="headerlink" href="#create" title="Permalink to this headline">¶</a></h2>
55
- <p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to create a user. This process will generate an RSA key pair for the named user. The public key will be stored on the Chef server and the private key will be displayed on <tt class="docutils literal"><span class="pre">STDOUT</span></tt> or written to a named file.</p>
56
- <ul class="simple">
57
- <li>For the user, the private key should be copied to the system as <tt class="docutils literal"><span class="pre">/etc/chef/client.pem</span></tt>.</li>
58
- <li>For knife, the private key is typically copied to <tt class="docutils literal"><span class="pre">~/.chef/client_name.pem</span></tt> and referenced in the knife.rb configuration file.</li>
59
- </ul>
60
- <div class="section" id="syntax">
61
- <h3>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h3>
62
- <p>This argument has the following syntax:</p>
63
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user create USER_NAME <span class="o">(</span>options<span class="o">)</span>
64
- </pre></div>
65
- </div>
66
- </div>
67
- <div class="section" id="options">
68
- <h3>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h3>
69
- <p>This argument has the following options:</p>
70
- <dl class="docutils">
71
- <dt><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--admin</span></tt></dt>
72
- <dd>Use to create a client as an admin client. This is required for any user to access Open Source Chef as an administrator. This option only works when used with the open source Chef server and will have no effect when used with Enterprise Chef.</dd>
73
- <dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--file</span> <span class="pre">FILE_NAME</span></tt></dt>
74
- <dd>Use to save a private key to the specified file name.</dd>
75
- <dt><tt class="docutils literal"><span class="pre">-p</span> <span class="pre">PASSWORD</span></tt>, <tt class="docutils literal"><span class="pre">--password</span> <span class="pre">PASSWORD</span></tt></dt>
76
- <dd>The user password.</dd>
77
- <dt><tt class="docutils literal"><span class="pre">--user-key</span> <span class="pre">FILE_NAME</span></tt></dt>
78
- <dd>All users are assigned a public key. Use to write the public key to a file.</dd>
79
- </dl>
80
- </div>
81
- <div class="section" id="examples">
82
- <h3>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h3>
83
- <p>The following examples show how to use this knife subcommand:</p>
84
- <p><strong>Create a user</strong></p>
85
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user create <span class="s2">&quot;Radio Birdman&quot;</span> -f /keys/user_name
86
- </pre></div>
87
- </div>
88
- </div>
89
- </div>
90
- <div class="section" id="delete">
91
- <h2>delete<a class="headerlink" href="#delete" title="Permalink to this headline">¶</a></h2>
92
- <p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete a registered user.</p>
93
- <div class="section" id="id1">
94
- <h3>Syntax<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
95
- <p>This argument has the following syntax:</p>
96
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user delete USER_NAME
97
- </pre></div>
98
- </div>
99
- </div>
100
- <div class="section" id="id2">
101
- <h3>Options<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
102
- <p>This command does not have any specific options.</p>
103
- </div>
104
- <div class="section" id="id3">
105
- <h3>Examples<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
106
- <p>The following examples show how to use this knife subcommand:</p>
107
- <p><strong>Delete a user</strong></p>
108
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user delete <span class="s2">&quot;Steve Danno&quot;</span>
109
- </pre></div>
110
- </div>
111
- </div>
112
- </div>
113
- <div class="section" id="edit">
114
- <h2>edit<a class="headerlink" href="#edit" title="Permalink to this headline">¶</a></h2>
115
- <p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit the details of a user. When this argument is run, knife will open $EDITOR. When finished, knife will update the Chef server with those changes.</p>
116
- <div class="section" id="id4">
117
- <h3>Syntax<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
118
- <p>This argument has the following syntax:</p>
119
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user edit USER_NAME
120
- </pre></div>
121
- </div>
122
- </div>
123
- <div class="section" id="id5">
124
- <h3>Options<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h3>
125
- <p>This command does not have any specific options.</p>
126
- </div>
127
- <div class="section" id="id6">
128
- <h3>Examples<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h3>
129
- <p>None.</p>
130
- </div>
131
- </div>
132
- <div class="section" id="list">
133
- <h2>list<a class="headerlink" href="#list" title="Permalink to this headline">¶</a></h2>
134
- <p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to view a list of registered users.</p>
135
- <div class="section" id="id7">
136
- <h3>Syntax<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h3>
137
- <p>This argument has the following syntax:</p>
138
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user list <span class="o">(</span>options<span class="o">)</span>
139
- </pre></div>
140
- </div>
141
- </div>
142
- <div class="section" id="id8">
143
- <h3>Options<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h3>
144
- <p>This argument has the following options:</p>
145
- <dl class="docutils">
146
- <dt><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--with-uri</span></tt></dt>
147
- <dd>Use to show the corresponding URIs.</dd>
148
- </dl>
149
- </div>
150
- <div class="section" id="id9">
151
- <h3>Examples<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h3>
152
- <p>None.</p>
153
- </div>
154
- </div>
155
- <div class="section" id="reregister">
156
- <h2>reregister<a class="headerlink" href="#reregister" title="Permalink to this headline">¶</a></h2>
157
- <p>The <tt class="docutils literal"><span class="pre">reregister</span></tt> argument is used to regenerate an RSA key pair for a user. The public key will be stored on the Chef server and the private key will be displayed on <tt class="docutils literal"><span class="pre">STDOUT</span></tt> or written to a named file.</p>
158
- <div class="admonition note">
159
- <p class="first admonition-title">Note</p>
160
- <p class="last">Running this argument will invalidate the previous RSA key pair, making it unusable during authentication to the Chef server.</p>
161
- </div>
162
- <div class="section" id="id10">
163
- <h3>Syntax<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h3>
164
- <p>This argument has the following syntax:</p>
165
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user reregister USER_NAME <span class="o">(</span>options<span class="o">)</span>
166
- </pre></div>
167
- </div>
168
- </div>
169
- <div class="section" id="id11">
170
- <h3>Options<a class="headerlink" href="#id11" title="Permalink to this headline">¶</a></h3>
171
- <p>This argument has the following options:</p>
172
- <dl class="docutils">
173
- <dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--file</span> <span class="pre">FILE_NAME</span></tt></dt>
174
- <dd>Use to save a private key to the specified file name.</dd>
175
- </dl>
176
- </div>
177
- <div class="section" id="id12">
178
- <h3>Examples<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h3>
179
- <p>The following examples show how to use this knife subcommand:</p>
180
- <p><strong>Regenerate the RSA key-pair</strong></p>
181
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user reregister <span class="s2">&quot;Robert Younger&quot;</span>
182
- </pre></div>
183
- </div>
184
- </div>
185
- </div>
186
- <div class="section" id="show">
187
- <h2>show<a class="headerlink" href="#show" title="Permalink to this headline">¶</a></h2>
188
- <p>The <tt class="docutils literal"><span class="pre">show</span></tt> argument is used to show the details of a user.</p>
189
- <div class="section" id="id13">
190
- <h3>Syntax<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h3>
191
- <p>This argument has the following syntax:</p>
192
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user show USER_NAME <span class="o">(</span>options<span class="o">)</span>
193
- </pre></div>
194
- </div>
195
- </div>
196
- <div class="section" id="id14">
197
- <h3>Options<a class="headerlink" href="#id14" title="Permalink to this headline">¶</a></h3>
198
- <p>This argument has the following options:</p>
199
- <dl class="docutils">
200
- <dt><tt class="docutils literal"><span class="pre">-a</span> <span class="pre">ATTR</span></tt>, <tt class="docutils literal"><span class="pre">--attribute</span> <span class="pre">ATTR</span></tt></dt>
201
- <dd>The attribute (or attributes) to show.</dd>
202
- </dl>
203
- </div>
204
- <div class="section" id="id15">
205
- <h3>Examples<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h3>
206
- <p>The following examples show how to use this knife subcommand:</p>
207
- <p><strong>Show user data</strong></p>
208
- <p>To view a user named <tt class="docutils literal"><span class="pre">Dennis</span> <span class="pre">Teck</span></tt>, enter:</p>
209
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user show <span class="s2">&quot;Dennis Teck&quot;</span>
210
- </pre></div>
211
- </div>
212
- <p>to return something like:</p>
213
- <div class="highlight-bash"><div class="highlight"><pre>chef_type: user
214
- json_class: Chef::User
215
- name: Dennis Teck
216
- public_key:
217
- </pre></div>
218
- </div>
219
- <p><strong>Show user data as JSON</strong></p>
220
- <p>To view information in JSON format, use the <tt class="docutils literal"><span class="pre">-F</span></tt> common option as part of the command like this:</p>
221
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user show <span class="s2">&quot;Dennis Teck&quot;</span> -F json
222
- </pre></div>
223
- </div>
224
- <p>(Other formats available include <tt class="docutils literal"><span class="pre">text</span></tt>, <tt class="docutils literal"><span class="pre">yaml</span></tt>, and <tt class="docutils literal"><span class="pre">pp</span></tt>, e.g. <tt class="docutils literal"><span class="pre">-F</span> <span class="pre">yaml</span></tt> for YAML.)</p>
225
- </div>
226
- </div>
227
- </div>
228
-
229
-
230
- </div>
231
-
232
- </div>
233
-
234
-
235
- <div class="clearer"></div>
236
- </div>
237
-
238
-
239
-
240
-
241
- </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 user &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-user">
43
+ <h1>knife user<a class="headerlink" href="#knife-user" title="Permalink to this headline">¶</a></h1>
44
+ <p>The <strong>knife user</strong> subcommand is used to manage the list of users and their associated RSA public key-pairs.</p>
45
+ <div class="admonition note">
46
+ <p class="first admonition-title">Note</p>
47
+ <p class="last">This subcommand ONLY works when run against the open source Chef server and will not run against Enterprise Chef (including hosted Enterprise Chef), or Private Chef.</p>
48
+ </div>
49
+ <div class="admonition note">
50
+ <p class="first admonition-title">Note</p>
51
+ <p class="last">Review the list of <a class="reference internal" href="knife_common_options.html"><em>common options</em></a> available to this (and all) knife subcommands and plugins.</p>
52
+ </div>
53
+ <div class="section" id="create">
54
+ <h2>create<a class="headerlink" href="#create" title="Permalink to this headline">¶</a></h2>
55
+ <p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to create a user. This process will generate an RSA key pair for the named user. The public key will be stored on the Chef server and the private key will be displayed on <tt class="docutils literal"><span class="pre">STDOUT</span></tt> or written to a named file.</p>
56
+ <ul class="simple">
57
+ <li>For the user, the private key should be copied to the system as <tt class="docutils literal"><span class="pre">/etc/chef/client.pem</span></tt>.</li>
58
+ <li>For knife, the private key is typically copied to <tt class="docutils literal"><span class="pre">~/.chef/client_name.pem</span></tt> and referenced in the knife.rb configuration file.</li>
59
+ </ul>
60
+ <div class="section" id="syntax">
61
+ <h3>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h3>
62
+ <p>This argument has the following syntax:</p>
63
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user create USER_NAME <span class="o">(</span>options<span class="o">)</span>
64
+ </pre></div>
65
+ </div>
66
+ </div>
67
+ <div class="section" id="options">
68
+ <h3>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h3>
69
+ <p>This argument has the following options:</p>
70
+ <dl class="docutils">
71
+ <dt><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--admin</span></tt></dt>
72
+ <dd>Use to create a client as an admin client. This is required for any user to access Open Source Chef as an administrator. This option only works when used with the open source Chef server and will have no effect when used with Enterprise Chef.</dd>
73
+ <dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--file</span> <span class="pre">FILE_NAME</span></tt></dt>
74
+ <dd>Use to save a private key to the specified file name.</dd>
75
+ <dt><tt class="docutils literal"><span class="pre">-p</span> <span class="pre">PASSWORD</span></tt>, <tt class="docutils literal"><span class="pre">--password</span> <span class="pre">PASSWORD</span></tt></dt>
76
+ <dd>The user password.</dd>
77
+ <dt><tt class="docutils literal"><span class="pre">--user-key</span> <span class="pre">FILE_NAME</span></tt></dt>
78
+ <dd>All users are assigned a public key. Use to write the public key to a file.</dd>
79
+ </dl>
80
+ </div>
81
+ <div class="section" id="examples">
82
+ <h3>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h3>
83
+ <p>The following examples show how to use this knife subcommand:</p>
84
+ <p><strong>Create a user</strong></p>
85
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user create <span class="s2">&quot;Radio Birdman&quot;</span> -f /keys/user_name
86
+ </pre></div>
87
+ </div>
88
+ </div>
89
+ </div>
90
+ <div class="section" id="delete">
91
+ <h2>delete<a class="headerlink" href="#delete" title="Permalink to this headline">¶</a></h2>
92
+ <p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete a registered user.</p>
93
+ <div class="section" id="id1">
94
+ <h3>Syntax<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
95
+ <p>This argument has the following syntax:</p>
96
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user delete USER_NAME
97
+ </pre></div>
98
+ </div>
99
+ </div>
100
+ <div class="section" id="id2">
101
+ <h3>Options<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
102
+ <p>This command does not have any specific options.</p>
103
+ </div>
104
+ <div class="section" id="id3">
105
+ <h3>Examples<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
106
+ <p>The following examples show how to use this knife subcommand:</p>
107
+ <p><strong>Delete a user</strong></p>
108
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user delete <span class="s2">&quot;Steve Danno&quot;</span>
109
+ </pre></div>
110
+ </div>
111
+ </div>
112
+ </div>
113
+ <div class="section" id="edit">
114
+ <h2>edit<a class="headerlink" href="#edit" title="Permalink to this headline">¶</a></h2>
115
+ <p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit the details of a user. When this argument is run, knife will open $EDITOR. When finished, knife will update the Chef server with those changes.</p>
116
+ <div class="section" id="id4">
117
+ <h3>Syntax<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
118
+ <p>This argument has the following syntax:</p>
119
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user edit USER_NAME
120
+ </pre></div>
121
+ </div>
122
+ </div>
123
+ <div class="section" id="id5">
124
+ <h3>Options<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h3>
125
+ <p>This command does not have any specific options.</p>
126
+ </div>
127
+ <div class="section" id="id6">
128
+ <h3>Examples<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h3>
129
+ <p>None.</p>
130
+ </div>
131
+ </div>
132
+ <div class="section" id="list">
133
+ <h2>list<a class="headerlink" href="#list" title="Permalink to this headline">¶</a></h2>
134
+ <p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to view a list of registered users.</p>
135
+ <div class="section" id="id7">
136
+ <h3>Syntax<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h3>
137
+ <p>This argument has the following syntax:</p>
138
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user list <span class="o">(</span>options<span class="o">)</span>
139
+ </pre></div>
140
+ </div>
141
+ </div>
142
+ <div class="section" id="id8">
143
+ <h3>Options<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h3>
144
+ <p>This argument has the following options:</p>
145
+ <dl class="docutils">
146
+ <dt><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--with-uri</span></tt></dt>
147
+ <dd>Use to show the corresponding URIs.</dd>
148
+ </dl>
149
+ </div>
150
+ <div class="section" id="id9">
151
+ <h3>Examples<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h3>
152
+ <p>None.</p>
153
+ </div>
154
+ </div>
155
+ <div class="section" id="reregister">
156
+ <h2>reregister<a class="headerlink" href="#reregister" title="Permalink to this headline">¶</a></h2>
157
+ <p>The <tt class="docutils literal"><span class="pre">reregister</span></tt> argument is used to regenerate an RSA key pair for a user. The public key will be stored on the Chef server and the private key will be displayed on <tt class="docutils literal"><span class="pre">STDOUT</span></tt> or written to a named file.</p>
158
+ <div class="admonition note">
159
+ <p class="first admonition-title">Note</p>
160
+ <p class="last">Running this argument will invalidate the previous RSA key pair, making it unusable during authentication to the Chef server.</p>
161
+ </div>
162
+ <div class="section" id="id10">
163
+ <h3>Syntax<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h3>
164
+ <p>This argument has the following syntax:</p>
165
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user reregister USER_NAME <span class="o">(</span>options<span class="o">)</span>
166
+ </pre></div>
167
+ </div>
168
+ </div>
169
+ <div class="section" id="id11">
170
+ <h3>Options<a class="headerlink" href="#id11" title="Permalink to this headline">¶</a></h3>
171
+ <p>This argument has the following options:</p>
172
+ <dl class="docutils">
173
+ <dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--file</span> <span class="pre">FILE_NAME</span></tt></dt>
174
+ <dd>Use to save a private key to the specified file name.</dd>
175
+ </dl>
176
+ </div>
177
+ <div class="section" id="id12">
178
+ <h3>Examples<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h3>
179
+ <p>The following examples show how to use this knife subcommand:</p>
180
+ <p><strong>Regenerate the RSA key-pair</strong></p>
181
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user reregister <span class="s2">&quot;Robert Younger&quot;</span>
182
+ </pre></div>
183
+ </div>
184
+ </div>
185
+ </div>
186
+ <div class="section" id="show">
187
+ <h2>show<a class="headerlink" href="#show" title="Permalink to this headline">¶</a></h2>
188
+ <p>The <tt class="docutils literal"><span class="pre">show</span></tt> argument is used to show the details of a user.</p>
189
+ <div class="section" id="id13">
190
+ <h3>Syntax<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h3>
191
+ <p>This argument has the following syntax:</p>
192
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user show USER_NAME <span class="o">(</span>options<span class="o">)</span>
193
+ </pre></div>
194
+ </div>
195
+ </div>
196
+ <div class="section" id="id14">
197
+ <h3>Options<a class="headerlink" href="#id14" title="Permalink to this headline">¶</a></h3>
198
+ <p>This argument has the following options:</p>
199
+ <dl class="docutils">
200
+ <dt><tt class="docutils literal"><span class="pre">-a</span> <span class="pre">ATTR</span></tt>, <tt class="docutils literal"><span class="pre">--attribute</span> <span class="pre">ATTR</span></tt></dt>
201
+ <dd>The attribute (or attributes) to show.</dd>
202
+ </dl>
203
+ </div>
204
+ <div class="section" id="id15">
205
+ <h3>Examples<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h3>
206
+ <p>The following examples show how to use this knife subcommand:</p>
207
+ <p><strong>Show user data</strong></p>
208
+ <p>To view a user named <tt class="docutils literal"><span class="pre">Dennis</span> <span class="pre">Teck</span></tt>, enter:</p>
209
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user show <span class="s2">&quot;Dennis Teck&quot;</span>
210
+ </pre></div>
211
+ </div>
212
+ <p>to return something like:</p>
213
+ <div class="highlight-bash"><div class="highlight"><pre>chef_type: user
214
+ json_class: Chef::User
215
+ name: Dennis Teck
216
+ public_key:
217
+ </pre></div>
218
+ </div>
219
+ <p><strong>Show user data as JSON</strong></p>
220
+ <p>To view information in JSON format, use the <tt class="docutils literal"><span class="pre">-F</span></tt> common option as part of the command like this:</p>
221
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user show <span class="s2">&quot;Dennis Teck&quot;</span> -F json
222
+ </pre></div>
223
+ </div>
224
+ <p>(Other formats available include <tt class="docutils literal"><span class="pre">text</span></tt>, <tt class="docutils literal"><span class="pre">yaml</span></tt>, and <tt class="docutils literal"><span class="pre">pp</span></tt>, e.g. <tt class="docutils literal"><span class="pre">-F</span> <span class="pre">yaml</span></tt> for YAML.)</p>
225
+ </div>
226
+ </div>
227
+ </div>
228
+
229
+
230
+ </div>
231
+
232
+ </div>
233
+
234
+
235
+ <div class="clearer"></div>
236
+ </div>
237
+
238
+
239
+
240
+
241
+ </body>
242
242
  </html>