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/ctl_chef_shell.html CHANGED
@@ -1,163 +1,163 @@
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-shell &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-shell">
43
- <h1>chef-shell<a class="headerlink" href="#chef-shell" title="Permalink to this headline">¶</a></h1>
44
- <p>chef-shell is a recipe debugging tool that allows the use of breakpoints within recipes. chef-shell runs as an Interactive Ruby (IRb) session. chef-shell supports both recipe and attribute file syntax, as well as interactive debugging features.</p>
45
- <div class="admonition note">
46
- <p class="first admonition-title">Note</p>
47
- <p class="last">chef-shell is the new name for Shef as of Chef 11.x. chef-shell is backwards compatible and aside from the name change, has the same set of functionality as with previous releases.</p>
48
- </div>
49
- <p>The chef-shell executable is run as a command-line tool.</p>
50
- <div class="section" id="modes">
51
- <h2>Modes<a class="headerlink" href="#modes" title="Permalink to this headline">¶</a></h2>
52
- <p>chef-shell is tool that allows knife to be run using an Interactive Ruby (IRb) session. chef-shell currently supports recipe and attribute file syntax, as well as interactive debugging features. chef-shell has three run modes:</p>
53
- <table border="1" class="docutils">
54
- <colgroup>
55
- <col width="40%" />
56
- <col width="60%" />
57
- </colgroup>
58
- <thead valign="bottom">
59
- <tr class="row-odd"><th class="head">Mode</th>
60
- <th class="head">Description</th>
61
- </tr>
62
- </thead>
63
- <tbody valign="top">
64
- <tr class="row-even"><td>Standalone</td>
65
- <td>No cookbooks are loaded, and the run list is empty. This mode is the default.</td>
66
- </tr>
67
- <tr class="row-odd"><td>Solo</td>
68
- <td>chef-shell acts as a chef-solo client. It attempts to load the chef-solo configuration file and JSON attributes. If the JSON attributes set a run list, it will be honored. Cookbooks will be loaded in the same way that chef-solo loads them. chef-solo mode is activated with the <tt class="docutils literal"><span class="pre">-s</span></tt> or <tt class="docutils literal"><span class="pre">--solo</span></tt> command line option, and JSON attributes are specified in the same way as for chef-solo, with <tt class="docutils literal"><span class="pre">-j</span> <span class="pre">/path/to/chef-solo.json</span></tt>.</td>
69
- </tr>
70
- <tr class="row-even"><td>Client</td>
71
- <td>chef-shell acts as a chef-client. During startup, it reads the chef-client configuration file and contacts the Chef server to get attributes and cookbooks. The run list will be set in the same way as normal chef-client runs. chef-client mode is activated with the <tt class="docutils literal"><span class="pre">-z</span></tt> or <tt class="docutils literal"><span class="pre">--client</span></tt> options. You can also specify the configuration file with <tt class="docutils literal"><span class="pre">-c</span> <span class="pre">CONFIG</span></tt> and the server URL with <tt class="docutils literal"><span class="pre">-S</span> <span class="pre">SERVER_URL</span></tt>.</td>
72
- </tr>
73
- </tbody>
74
- </table>
75
- </div>
76
- <div class="section" id="options">
77
- <h2>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
78
- <p>This command has the following syntax:</p>
79
- <div class="highlight-python"><div class="highlight"><pre>chef-shell OPTION VALUE OPTION VALUE ...
80
- </pre></div>
81
- </div>
82
- <p>This command has the following options:</p>
83
- <dl class="docutils">
84
- <dt><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--standalone</span></tt></dt>
85
- <dd>Use to run chef-shell in standalone mode.</dd>
86
- <dt><tt class="docutils literal"><span class="pre">-c</span> <span class="pre">CONFIG</span></tt>, <tt class="docutils literal"><span class="pre">--config</span> <span class="pre">CONFIG</span></tt></dt>
87
- <dd>The configuration file to use.</dd>
88
- <dt><tt class="docutils literal"><span class="pre">-h</span></tt>, <tt class="docutils literal"><span class="pre">--help</span></tt></dt>
89
- <dd>Shows help for the command.</dd>
90
- <dt><tt class="docutils literal"><span class="pre">-j</span> <span class="pre">PATH</span></tt>, <tt class="docutils literal"><span class="pre">--json-attributes</span> <span class="pre">PATH</span></tt></dt>
91
- <dd><p class="first">The path to a file that contains JSON data.</p>
92
- <p>Use this option to define a <tt class="docutils literal"><span class="pre">run_list</span></tt> object. For example, a JSON file similar to:</p>
93
- <div class="highlight-javascript"><div class="highlight"><pre><span class="s2">&quot;run_list&quot;</span><span class="o">:</span> <span class="p">[</span>
94
- <span class="s2">&quot;recipe[base]&quot;</span><span class="p">,</span>
95
- <span class="s2">&quot;recipe[foo]&quot;</span><span class="p">,</span>
96
- <span class="s2">&quot;recipe[bar]&quot;</span><span class="p">,</span>
97
- <span class="s2">&quot;role[webserver]&quot;</span>
98
- <span class="p">],</span>
99
- </pre></div>
100
- </div>
101
- <p>may be used by running <tt class="docutils literal"><span class="pre">chef-client</span> <span class="pre">-j</span> <span class="pre">path/to/file.json</span></tt>.</p>
102
- <p>In certain situations this option may be used to update <tt class="docutils literal"><span class="pre">normal</span></tt> attributes.</p>
103
- <div class="last admonition warning">
104
- <p class="first admonition-title">Warning</p>
105
- <p>Any other attribute type that is contained in this JSON file will be treated as a <tt class="docutils literal"><span class="pre">normal</span></tt> attribute. For example, attempting to update <tt class="docutils literal"><span class="pre">override</span></tt> attributes using the <tt class="docutils literal"><span class="pre">-j</span></tt> option:</p>
106
- <div class="highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
107
- <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99&quot;</span><span class="p">,</span>
108
- <span class="s2">&quot;description&quot;</span><span class="o">:</span> <span class="s2">&quot;Install some stuff&quot;</span><span class="p">,</span>
109
- <span class="s2">&quot;override_attributes&quot;</span><span class="o">:</span> <span class="p">{</span>
110
- <span class="s2">&quot;apptastic&quot;</span><span class="o">:</span> <span class="p">{</span>
111
- <span class="s2">&quot;enable_apptastic&quot;</span><span class="o">:</span> <span class="s2">&quot;false&quot;</span><span class="p">,</span>
112
- <span class="s2">&quot;apptastic_tier_name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99.bomb.com&quot;</span>
113
- <span class="p">}</span>
114
- <span class="p">}</span>
115
- <span class="p">}</span>
116
- </pre></div>
117
- </div>
118
- <p>will result in a node object similar to:</p>
119
- <div class="last highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
120
- <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;maybe-dev-99&quot;</span><span class="p">,</span>
121
- <span class="s2">&quot;normal&quot;</span><span class="o">:</span> <span class="p">{</span>
122
- <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99&quot;</span><span class="p">,</span>
123
- <span class="s2">&quot;description&quot;</span><span class="o">:</span> <span class="s2">&quot;Install some stuff&quot;</span><span class="p">,</span>
124
- <span class="s2">&quot;override_attributes&quot;</span><span class="o">:</span> <span class="p">{</span>
125
- <span class="s2">&quot;apptastic&quot;</span><span class="o">:</span> <span class="p">{</span>
126
- <span class="s2">&quot;enable_apptastic&quot;</span><span class="o">:</span> <span class="s2">&quot;false&quot;</span><span class="p">,</span>
127
- <span class="s2">&quot;apptastic_tier_name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99.bomb.com&quot;</span>
128
- <span class="p">}</span>
129
- <span class="p">}</span>
130
- <span class="p">}</span>
131
- <span class="p">}</span>
132
- </pre></div>
133
- </div>
134
- </div>
135
- </dd>
136
- <dt><tt class="docutils literal"><span class="pre">-l</span> <span class="pre">LEVEL</span></tt>, <tt class="docutils literal"><span class="pre">--log-level</span> <span class="pre">LEVEL</span></tt></dt>
137
- <dd>The level of logging that will be stored in a log file.</dd>
138
- <dt><tt class="docutils literal"><span class="pre">-s</span></tt>, <tt class="docutils literal"><span class="pre">--solo</span></tt></dt>
139
- <dd>Use to run chef-shell in chef-solo mode.</dd>
140
- <dt><tt class="docutils literal"><span class="pre">-S</span> <span class="pre">CHEF_SERVER_URL</span></tt>, <tt class="docutils literal"><span class="pre">--server</span> <span class="pre">CHEF_SERVER_URL</span></tt></dt>
141
- <dd>The URL for the Chef server.</dd>
142
- <dt><tt class="docutils literal"><span class="pre">-v</span></tt>, <tt class="docutils literal"><span class="pre">--version</span></tt></dt>
143
- <dd>The version of the chef-client.</dd>
144
- <dt><tt class="docutils literal"><span class="pre">-z</span></tt>, <tt class="docutils literal"><span class="pre">--client</span></tt></dt>
145
- <dd>Use to run chef-shell in chef-client mode.</dd>
146
- </dl>
147
- </div>
148
- </div>
149
-
150
-
151
- </div>
152
-
153
- </div>
154
-
155
-
156
- <div class="clearer"></div>
157
- </div>
158
-
159
-
160
-
161
-
162
- </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-shell &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-shell">
43
+ <h1>chef-shell<a class="headerlink" href="#chef-shell" title="Permalink to this headline">¶</a></h1>
44
+ <p>chef-shell is a recipe debugging tool that allows the use of breakpoints within recipes. chef-shell runs as an Interactive Ruby (IRb) session. chef-shell supports both recipe and attribute file syntax, as well as interactive debugging features.</p>
45
+ <div class="admonition note">
46
+ <p class="first admonition-title">Note</p>
47
+ <p class="last">chef-shell is the new name for Shef as of Chef 11.x. chef-shell is backwards compatible and aside from the name change, has the same set of functionality as with previous releases.</p>
48
+ </div>
49
+ <p>The chef-shell executable is run as a command-line tool.</p>
50
+ <div class="section" id="modes">
51
+ <h2>Modes<a class="headerlink" href="#modes" title="Permalink to this headline">¶</a></h2>
52
+ <p>chef-shell is tool that allows knife to be run using an Interactive Ruby (IRb) session. chef-shell currently supports recipe and attribute file syntax, as well as interactive debugging features. chef-shell has three run modes:</p>
53
+ <table border="1" class="docutils">
54
+ <colgroup>
55
+ <col width="40%" />
56
+ <col width="60%" />
57
+ </colgroup>
58
+ <thead valign="bottom">
59
+ <tr class="row-odd"><th class="head">Mode</th>
60
+ <th class="head">Description</th>
61
+ </tr>
62
+ </thead>
63
+ <tbody valign="top">
64
+ <tr class="row-even"><td>Standalone</td>
65
+ <td>No cookbooks are loaded, and the run list is empty. This mode is the default.</td>
66
+ </tr>
67
+ <tr class="row-odd"><td>Solo</td>
68
+ <td>chef-shell acts as a chef-solo client. It attempts to load the chef-solo configuration file and JSON attributes. If the JSON attributes set a run list, it will be honored. Cookbooks will be loaded in the same way that chef-solo loads them. chef-solo mode is activated with the <tt class="docutils literal"><span class="pre">-s</span></tt> or <tt class="docutils literal"><span class="pre">--solo</span></tt> command line option, and JSON attributes are specified in the same way as for chef-solo, with <tt class="docutils literal"><span class="pre">-j</span> <span class="pre">/path/to/chef-solo.json</span></tt>.</td>
69
+ </tr>
70
+ <tr class="row-even"><td>Client</td>
71
+ <td>chef-shell acts as a chef-client. During startup, it reads the chef-client configuration file and contacts the Chef server to get attributes and cookbooks. The run list will be set in the same way as normal chef-client runs. chef-client mode is activated with the <tt class="docutils literal"><span class="pre">-z</span></tt> or <tt class="docutils literal"><span class="pre">--client</span></tt> options. You can also specify the configuration file with <tt class="docutils literal"><span class="pre">-c</span> <span class="pre">CONFIG</span></tt> and the server URL with <tt class="docutils literal"><span class="pre">-S</span> <span class="pre">SERVER_URL</span></tt>.</td>
72
+ </tr>
73
+ </tbody>
74
+ </table>
75
+ </div>
76
+ <div class="section" id="options">
77
+ <h2>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
78
+ <p>This command has the following syntax:</p>
79
+ <div class="highlight-python"><div class="highlight"><pre>chef-shell OPTION VALUE OPTION VALUE ...
80
+ </pre></div>
81
+ </div>
82
+ <p>This command has the following options:</p>
83
+ <dl class="docutils">
84
+ <dt><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--standalone</span></tt></dt>
85
+ <dd>Use to run chef-shell in standalone mode.</dd>
86
+ <dt><tt class="docutils literal"><span class="pre">-c</span> <span class="pre">CONFIG</span></tt>, <tt class="docutils literal"><span class="pre">--config</span> <span class="pre">CONFIG</span></tt></dt>
87
+ <dd>The configuration file to use.</dd>
88
+ <dt><tt class="docutils literal"><span class="pre">-h</span></tt>, <tt class="docutils literal"><span class="pre">--help</span></tt></dt>
89
+ <dd>Shows help for the command.</dd>
90
+ <dt><tt class="docutils literal"><span class="pre">-j</span> <span class="pre">PATH</span></tt>, <tt class="docutils literal"><span class="pre">--json-attributes</span> <span class="pre">PATH</span></tt></dt>
91
+ <dd><p class="first">The path to a file that contains JSON data.</p>
92
+ <p>Use this option to define a <tt class="docutils literal"><span class="pre">run_list</span></tt> object. For example, a JSON file similar to:</p>
93
+ <div class="highlight-javascript"><div class="highlight"><pre><span class="s2">&quot;run_list&quot;</span><span class="o">:</span> <span class="p">[</span>
94
+ <span class="s2">&quot;recipe[base]&quot;</span><span class="p">,</span>
95
+ <span class="s2">&quot;recipe[foo]&quot;</span><span class="p">,</span>
96
+ <span class="s2">&quot;recipe[bar]&quot;</span><span class="p">,</span>
97
+ <span class="s2">&quot;role[webserver]&quot;</span>
98
+ <span class="p">],</span>
99
+ </pre></div>
100
+ </div>
101
+ <p>may be used by running <tt class="docutils literal"><span class="pre">chef-client</span> <span class="pre">-j</span> <span class="pre">path/to/file.json</span></tt>.</p>
102
+ <p>In certain situations this option may be used to update <tt class="docutils literal"><span class="pre">normal</span></tt> attributes.</p>
103
+ <div class="last admonition warning">
104
+ <p class="first admonition-title">Warning</p>
105
+ <p>Any other attribute type that is contained in this JSON file will be treated as a <tt class="docutils literal"><span class="pre">normal</span></tt> attribute. For example, attempting to update <tt class="docutils literal"><span class="pre">override</span></tt> attributes using the <tt class="docutils literal"><span class="pre">-j</span></tt> option:</p>
106
+ <div class="highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
107
+ <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99&quot;</span><span class="p">,</span>
108
+ <span class="s2">&quot;description&quot;</span><span class="o">:</span> <span class="s2">&quot;Install some stuff&quot;</span><span class="p">,</span>
109
+ <span class="s2">&quot;override_attributes&quot;</span><span class="o">:</span> <span class="p">{</span>
110
+ <span class="s2">&quot;apptastic&quot;</span><span class="o">:</span> <span class="p">{</span>
111
+ <span class="s2">&quot;enable_apptastic&quot;</span><span class="o">:</span> <span class="s2">&quot;false&quot;</span><span class="p">,</span>
112
+ <span class="s2">&quot;apptastic_tier_name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99.bomb.com&quot;</span>
113
+ <span class="p">}</span>
114
+ <span class="p">}</span>
115
+ <span class="p">}</span>
116
+ </pre></div>
117
+ </div>
118
+ <p>will result in a node object similar to:</p>
119
+ <div class="last highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
120
+ <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;maybe-dev-99&quot;</span><span class="p">,</span>
121
+ <span class="s2">&quot;normal&quot;</span><span class="o">:</span> <span class="p">{</span>
122
+ <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99&quot;</span><span class="p">,</span>
123
+ <span class="s2">&quot;description&quot;</span><span class="o">:</span> <span class="s2">&quot;Install some stuff&quot;</span><span class="p">,</span>
124
+ <span class="s2">&quot;override_attributes&quot;</span><span class="o">:</span> <span class="p">{</span>
125
+ <span class="s2">&quot;apptastic&quot;</span><span class="o">:</span> <span class="p">{</span>
126
+ <span class="s2">&quot;enable_apptastic&quot;</span><span class="o">:</span> <span class="s2">&quot;false&quot;</span><span class="p">,</span>
127
+ <span class="s2">&quot;apptastic_tier_name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99.bomb.com&quot;</span>
128
+ <span class="p">}</span>
129
+ <span class="p">}</span>
130
+ <span class="p">}</span>
131
+ <span class="p">}</span>
132
+ </pre></div>
133
+ </div>
134
+ </div>
135
+ </dd>
136
+ <dt><tt class="docutils literal"><span class="pre">-l</span> <span class="pre">LEVEL</span></tt>, <tt class="docutils literal"><span class="pre">--log-level</span> <span class="pre">LEVEL</span></tt></dt>
137
+ <dd>The level of logging that will be stored in a log file.</dd>
138
+ <dt><tt class="docutils literal"><span class="pre">-s</span></tt>, <tt class="docutils literal"><span class="pre">--solo</span></tt></dt>
139
+ <dd>Use to run chef-shell in chef-solo mode.</dd>
140
+ <dt><tt class="docutils literal"><span class="pre">-S</span> <span class="pre">CHEF_SERVER_URL</span></tt>, <tt class="docutils literal"><span class="pre">--server</span> <span class="pre">CHEF_SERVER_URL</span></tt></dt>
141
+ <dd>The URL for the Chef server.</dd>
142
+ <dt><tt class="docutils literal"><span class="pre">-v</span></tt>, <tt class="docutils literal"><span class="pre">--version</span></tt></dt>
143
+ <dd>The version of the chef-client.</dd>
144
+ <dt><tt class="docutils literal"><span class="pre">-z</span></tt>, <tt class="docutils literal"><span class="pre">--client</span></tt></dt>
145
+ <dd>Use to run chef-shell in chef-client mode.</dd>
146
+ </dl>
147
+ </div>
148
+ </div>
149
+
150
+
151
+ </div>
152
+
153
+ </div>
154
+
155
+
156
+ <div class="clearer"></div>
157
+ </div>
158
+
159
+
160
+
161
+
162
+ </body>
163
163
  </html>
data/distro/common/html/ctl_chef_solo.html CHANGED
@@ -1,194 +1,194 @@
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-solo &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-solo">
43
- <h1>chef-solo<a class="headerlink" href="#chef-solo" title="Permalink to this headline">¶</a></h1>
44
- <p>chef-solo is an open source version of the chef-client that allows using cookbooks with nodes without requiring access to a Chef server. chef-solo runs locally and requires that a cookbook (and any of its dependencies) be on the same physical disk as the node. chef-solo is a limited-functionality version of the chef-client and <strong>does not support</strong> the following:</p>
45
- <ul class="simple">
46
- <li>Node data storage</li>
47
- <li>Search indexes</li>
48
- <li>Centralized distribution of cookbooks</li>
49
- <li>A centralized API that interacts with and integrates infrastructure components</li>
50
- <li>Authentication or authorization</li>
51
- <li>Persistent attributes</li>
52
- </ul>
53
- <div class="admonition note">
54
- <p class="first admonition-title">Note</p>
55
- <p class="last">chef-solo can be run as a daemon.</p>
56
- </div>
57
- <p>The chef-solo executable is run as a command-line tool.</p>
58
- <div class="section" id="options">
59
- <h2>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
60
- <p>This command has the following syntax:</p>
61
- <div class="highlight-python"><div class="highlight"><pre>chef-solo OPTION VALUE OPTION VALUE ...
62
- </pre></div>
63
- </div>
64
- <p>This command has the following options:</p>
65
- <dl class="docutils">
66
- <dt><tt class="docutils literal"><span class="pre">-c</span> <span class="pre">CONFIG</span></tt>, <tt class="docutils literal"><span class="pre">--config</span> <span class="pre">CONFIG</span></tt></dt>
67
- <dd>The configuration file to use.</dd>
68
- <dt><tt class="docutils literal"><span class="pre">-d</span></tt>, <tt class="docutils literal"><span class="pre">--daemonize</span></tt></dt>
69
- <dd><p class="first">Use to run the executable as a daemon. This option may not be used in the same command with the <tt class="docutils literal"><span class="pre">--[no-]fork</span></tt> option.</p>
70
- <p class="last">This option is only available on machines that run in UNIX or Linux environments. For machines that are running Microsoft Windows that require similar functionality, use the <tt class="docutils literal"><span class="pre">chef-client::service</span></tt> recipe in the <tt class="docutils literal"><span class="pre">chef-client</span></tt> cookbook: <a class="reference external" href="http://community.opscode.com/cookbooks/chef-client">http://community.opscode.com/cookbooks/chef-client</a>. This will install a chef-client service under Microsoft Windows using the Windows Service Wrapper.</p>
71
- </dd>
72
- <dt><tt class="docutils literal"><span class="pre">-E</span> <span class="pre">ENVIRONMENT_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--environment</span> <span class="pre">ENVIRONMENT_NAME</span></tt></dt>
73
- <dd>The name of the environment.</dd>
74
- <dt><tt class="docutils literal"><span class="pre">-f</span></tt>, <tt class="docutils literal"><span class="pre">--[no-]fork</span></tt></dt>
75
- <dd>Use to contain the chef-client run in a secondary process with dedicated RAM. When the chef-client run is complete the RAM will be returned to the master process. This option helps ensure that a chef-client will use a steady amount of RAM over time because the master process will not run recipes. This option will also help prevent memory leaks (such as those that can be introduced by the code contained within a poorly designed cookbook). Use <tt class="docutils literal"><span class="pre">--no-fork</span></tt> to disable running the chef-client in fork node. Default value: <tt class="docutils literal"><span class="pre">--fork</span></tt>. This option may not be used in the same command with the <tt class="docutils literal"><span class="pre">--daemonize</span></tt> and <tt class="docutils literal"><span class="pre">--interval</span></tt> options.</dd>
76
- <dt><tt class="docutils literal"><span class="pre">-F</span> <span class="pre">FORMAT</span></tt>, <tt class="docutils literal"><span class="pre">--format</span> <span class="pre">FORMAT</span></tt></dt>
77
- <dd><p class="first">The output format: <tt class="docutils literal"><span class="pre">doc</span></tt> (default) or <tt class="docutils literal"><span class="pre">min</span></tt>.</p>
78
- <p>Use <tt class="docutils literal"><span class="pre">doc</span></tt> to print the progress of the chef-client run using full strings that display a summary of updates as they occur.</p>
79
- <p>Use <tt class="docutils literal"><span class="pre">min</span></tt> to print the progress of the chef-client run using single characters. A summary of updates is printed at the end of the chef-client run. A dot (<tt class="docutils literal"><span class="pre">.</span></tt>) is printed for events that do not have meaningful status information, such as loading a file or synchronizing a cookbook. For resources, a dot (<tt class="docutils literal"><span class="pre">.</span></tt>) is printed when the resource is up to date, an <tt class="docutils literal"><span class="pre">S</span></tt> is printed when the resource is skipped by <tt class="docutils literal"><span class="pre">not_if</span></tt> or <tt class="docutils literal"><span class="pre">only_if</span></tt>, and a <tt class="docutils literal"><span class="pre">U</span></tt> is printed when the resource is updated.</p>
80
- <p class="last">Other formatting options are available when those formatters are configured in the client.rb file using the <tt class="docutils literal"><span class="pre">add_formatter</span></tt> option.</p>
81
- </dd>
82
- <dt><tt class="docutils literal"><span class="pre">--force-formatter</span></tt></dt>
83
- <dd>Use to show formatter output instead of logger output.</dd>
84
- <dt><tt class="docutils literal"><span class="pre">--force-logger</span></tt></dt>
85
- <dd>Use to show logger output instead of formatter output.</dd>
86
- <dt><tt class="docutils literal"><span class="pre">-g</span> <span class="pre">GROUP</span></tt>, <tt class="docutils literal"><span class="pre">--group</span> <span class="pre">GROUP</span></tt></dt>
87
- <dd>The name of the group that owns a process. This is required when starting any executable as a daemon.</dd>
88
- <dt><tt class="docutils literal"><span class="pre">-h</span></tt>, <tt class="docutils literal"><span class="pre">--help</span></tt></dt>
89
- <dd>Shows help for the command.</dd>
90
- <dt><tt class="docutils literal"><span class="pre">-i</span> <span class="pre">SECONDS</span></tt>, <tt class="docutils literal"><span class="pre">--interval</span> <span class="pre">SECONDS</span></tt></dt>
91
- <dd>The frequency (in seconds) at which the chef-client runs. When the chef-client is run at intervals, <tt class="docutils literal"><span class="pre">--splay</span></tt> and <tt class="docutils literal"><span class="pre">--interval</span></tt> values are applied before the chef-client run. This option may not be used in the same command with the <tt class="docutils literal"><span class="pre">--[no-]fork</span></tt> option.</dd>
92
- <dt><tt class="docutils literal"><span class="pre">-j</span> <span class="pre">PATH</span></tt>, <tt class="docutils literal"><span class="pre">--json-attributes</span> <span class="pre">PATH</span></tt></dt>
93
- <dd><p class="first">The path to a file that contains JSON data.</p>
94
- <p>Use this option to define a <tt class="docutils literal"><span class="pre">run_list</span></tt> object. For example, a JSON file similar to:</p>
95
- <div class="highlight-javascript"><div class="highlight"><pre><span class="s2">&quot;run_list&quot;</span><span class="o">:</span> <span class="p">[</span>
96
- <span class="s2">&quot;recipe[base]&quot;</span><span class="p">,</span>
97
- <span class="s2">&quot;recipe[foo]&quot;</span><span class="p">,</span>
98
- <span class="s2">&quot;recipe[bar]&quot;</span><span class="p">,</span>
99
- <span class="s2">&quot;role[webserver]&quot;</span>
100
- <span class="p">],</span>
101
- </pre></div>
102
- </div>
103
- <p>may be used by running <tt class="docutils literal"><span class="pre">chef-client</span> <span class="pre">-j</span> <span class="pre">path/to/file.json</span></tt>.</p>
104
- <p>In certain situations this option may be used to update <tt class="docutils literal"><span class="pre">normal</span></tt> attributes.</p>
105
- <div class="last admonition warning">
106
- <p class="first admonition-title">Warning</p>
107
- <p>Any other attribute type that is contained in this JSON file will be treated as a <tt class="docutils literal"><span class="pre">normal</span></tt> attribute. For example, attempting to update <tt class="docutils literal"><span class="pre">override</span></tt> attributes using the <tt class="docutils literal"><span class="pre">-j</span></tt> option:</p>
108
- <div class="highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
109
- <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99&quot;</span><span class="p">,</span>
110
- <span class="s2">&quot;description&quot;</span><span class="o">:</span> <span class="s2">&quot;Install some stuff&quot;</span><span class="p">,</span>
111
- <span class="s2">&quot;override_attributes&quot;</span><span class="o">:</span> <span class="p">{</span>
112
- <span class="s2">&quot;apptastic&quot;</span><span class="o">:</span> <span class="p">{</span>
113
- <span class="s2">&quot;enable_apptastic&quot;</span><span class="o">:</span> <span class="s2">&quot;false&quot;</span><span class="p">,</span>
114
- <span class="s2">&quot;apptastic_tier_name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99.bomb.com&quot;</span>
115
- <span class="p">}</span>
116
- <span class="p">}</span>
117
- <span class="p">}</span>
118
- </pre></div>
119
- </div>
120
- <p>will result in a node object similar to:</p>
121
- <div class="last highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
122
- <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;maybe-dev-99&quot;</span><span class="p">,</span>
123
- <span class="s2">&quot;normal&quot;</span><span class="o">:</span> <span class="p">{</span>
124
- <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99&quot;</span><span class="p">,</span>
125
- <span class="s2">&quot;description&quot;</span><span class="o">:</span> <span class="s2">&quot;Install some stuff&quot;</span><span class="p">,</span>
126
- <span class="s2">&quot;override_attributes&quot;</span><span class="o">:</span> <span class="p">{</span>
127
- <span class="s2">&quot;apptastic&quot;</span><span class="o">:</span> <span class="p">{</span>
128
- <span class="s2">&quot;enable_apptastic&quot;</span><span class="o">:</span> <span class="s2">&quot;false&quot;</span><span class="p">,</span>
129
- <span class="s2">&quot;apptastic_tier_name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99.bomb.com&quot;</span>
130
- <span class="p">}</span>
131
- <span class="p">}</span>
132
- <span class="p">}</span>
133
- <span class="p">}</span>
134
- </pre></div>
135
- </div>
136
- </div>
137
- </dd>
138
- <dt><tt class="docutils literal"><span class="pre">-l</span> <span class="pre">LEVEL</span></tt>, <tt class="docutils literal"><span class="pre">--log_level</span> <span class="pre">LEVEL</span></tt></dt>
139
- <dd>The level of logging that will be stored in a log file.</dd>
140
- <dt><tt class="docutils literal"><span class="pre">-L</span> <span class="pre">LOGLOCATION</span></tt>, <tt class="docutils literal"><span class="pre">--logfile</span> <span class="pre">c</span></tt></dt>
141
- <dd>The location in which log file output files will be saved. If this location is set to something other than <tt class="docutils literal"><span class="pre">STDOUT</span></tt>, standard output logging will still be performed (otherwise there would be no output other than to a file). This is recommended when starting any executable as a daemon.</dd>
142
- <dt><tt class="docutils literal"><span class="pre">--[no-]color</span></tt></dt>
143
- <dd>Use to view colored output. Default setting: <tt class="docutils literal"><span class="pre">--color</span></tt>.</dd>
144
- <dt><tt class="docutils literal"><span class="pre">-N</span> <span class="pre">NODE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--node-name</span> <span class="pre">NODE_NAME</span></tt></dt>
145
- <dd>The name of the node.</dd>
146
- <dt><tt class="docutils literal"><span class="pre">-o</span> <span class="pre">RUN_LIST_ITEM</span></tt>, <tt class="docutils literal"><span class="pre">--override-runlist</span> <span class="pre">RUN_LIST_ITEM</span></tt></dt>
147
- <dd>Replace the current run list with the specified items.</dd>
148
- <dt><tt class="docutils literal"><span class="pre">-r</span> <span class="pre">RECIPE_URL</span></tt>, <tt class="docutils literal"><span class="pre">--recipe-url</span> <span class="pre">RECIPE_URL</span></tt></dt>
149
- <dd>The URL location from which a remote cookbook tar.gz will be downloaded.</dd>
150
- <dt><tt class="docutils literal"><span class="pre">--run-lock-timeout</span> <span class="pre">SECONDS</span></tt></dt>
151
- <dd>The amount of time (in seconds) to wait for a chef-client run to finish. Default value: not set (indefinite). Set to <tt class="docutils literal"><span class="pre">0</span></tt> to cause a second chef-client to exit immediately.</dd>
152
- <dt><tt class="docutils literal"><span class="pre">-s</span> <span class="pre">SECONDS</span></tt>, <tt class="docutils literal"><span class="pre">--splay</span> <span class="pre">SECONDS</span></tt></dt>
153
- <dd>A number (in seconds) to add to the <tt class="docutils literal"><span class="pre">interval</span></tt> that is used to determine the frequency of chef-client runs. This number can help prevent server load when there are many clients running at the same time. When the chef-client is run at intervals, <tt class="docutils literal"><span class="pre">--splay</span></tt> and <tt class="docutils literal"><span class="pre">--interval</span></tt> values are applied before the chef-client run.</dd>
154
- <dt><tt class="docutils literal"><span class="pre">-u</span> <span class="pre">USER</span></tt>, <tt class="docutils literal"><span class="pre">--user</span> <span class="pre">USER</span></tt></dt>
155
- <dd>The user that owns a process. This is required when starting any executable as a daemon.</dd>
156
- <dt><tt class="docutils literal"><span class="pre">-v</span></tt>, <tt class="docutils literal"><span class="pre">--version</span></tt></dt>
157
- <dd>The version of the chef-client.</dd>
158
- <dt><tt class="docutils literal"><span class="pre">-W</span></tt>, <tt class="docutils literal"><span class="pre">--why-run</span></tt></dt>
159
- <dd>Use to run the executable in why-run mode, which is a type of chef-client run that does everything except modify the system. Use why-run mode to understand why the chef-client makes the decisions that it makes and to learn more about the current and proposed state of the system.</dd>
160
- </dl>
161
- </div>
162
- <div class="section" id="examples">
163
- <h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
164
- <p><strong>Use a URL</strong></p>
165
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-solo -c ~/solo.rb -j ~/node.json -r http://www.example.com/chef-solo.tar.gz
166
- </pre></div>
167
- </div>
168
- <p>The tar.gz archived into the <tt class="docutils literal"><span class="pre">file_cache_path</span></tt>, and then extracted to <tt class="docutils literal"><span class="pre">cookbooks_path</span></tt>.</p>
169
- <p><strong>Use a directory</strong></p>
170
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-solo -c ~/solo.rb -j ~/node.json
171
- </pre></div>
172
- </div>
173
- <p>chef-solo will look in the solo.rb file to determine the directory in which cookbooks are located.</p>
174
- <p><strong>Use a URL for cookbook and JSON data</strong></p>
175
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-solo -c ~/solo.rb -j http://www.example.com/node.json -r http://www.example.com/chef-solo.tar.gz
176
- </pre></div>
177
- </div>
178
- </div>
179
- </div>
180
-
181
-
182
- </div>
183
-
184
- </div>
185
-
186
-
187
- <div class="clearer"></div>
188
- </div>
189
-
190
-
191
-
192
-
193
- </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-solo &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-solo">
43
+ <h1>chef-solo<a class="headerlink" href="#chef-solo" title="Permalink to this headline">¶</a></h1>
44
+ <p>chef-solo is an open source version of the chef-client that allows using cookbooks with nodes without requiring access to a Chef server. chef-solo runs locally and requires that a cookbook (and any of its dependencies) be on the same physical disk as the node. chef-solo is a limited-functionality version of the chef-client and <strong>does not support</strong> the following:</p>
45
+ <ul class="simple">
46
+ <li>Node data storage</li>
47
+ <li>Search indexes</li>
48
+ <li>Centralized distribution of cookbooks</li>
49
+ <li>A centralized API that interacts with and integrates infrastructure components</li>
50
+ <li>Authentication or authorization</li>
51
+ <li>Persistent attributes</li>
52
+ </ul>
53
+ <div class="admonition note">
54
+ <p class="first admonition-title">Note</p>
55
+ <p class="last">chef-solo can be run as a daemon.</p>
56
+ </div>
57
+ <p>The chef-solo executable is run as a command-line tool.</p>
58
+ <div class="section" id="options">
59
+ <h2>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
60
+ <p>This command has the following syntax:</p>
61
+ <div class="highlight-python"><div class="highlight"><pre>chef-solo OPTION VALUE OPTION VALUE ...
62
+ </pre></div>
63
+ </div>
64
+ <p>This command has the following options:</p>
65
+ <dl class="docutils">
66
+ <dt><tt class="docutils literal"><span class="pre">-c</span> <span class="pre">CONFIG</span></tt>, <tt class="docutils literal"><span class="pre">--config</span> <span class="pre">CONFIG</span></tt></dt>
67
+ <dd>The configuration file to use.</dd>
68
+ <dt><tt class="docutils literal"><span class="pre">-d</span></tt>, <tt class="docutils literal"><span class="pre">--daemonize</span></tt></dt>
69
+ <dd><p class="first">Use to run the executable as a daemon. This option may not be used in the same command with the <tt class="docutils literal"><span class="pre">--[no-]fork</span></tt> option.</p>
70
+ <p class="last">This option is only available on machines that run in UNIX or Linux environments. For machines that are running Microsoft Windows that require similar functionality, use the <tt class="docutils literal"><span class="pre">chef-client::service</span></tt> recipe in the <tt class="docutils literal"><span class="pre">chef-client</span></tt> cookbook: <a class="reference external" href="http://community.opscode.com/cookbooks/chef-client">http://community.opscode.com/cookbooks/chef-client</a>. This will install a chef-client service under Microsoft Windows using the Windows Service Wrapper.</p>
71
+ </dd>
72
+ <dt><tt class="docutils literal"><span class="pre">-E</span> <span class="pre">ENVIRONMENT_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--environment</span> <span class="pre">ENVIRONMENT_NAME</span></tt></dt>
73
+ <dd>The name of the environment.</dd>
74
+ <dt><tt class="docutils literal"><span class="pre">-f</span></tt>, <tt class="docutils literal"><span class="pre">--[no-]fork</span></tt></dt>
75
+ <dd>Use to contain the chef-client run in a secondary process with dedicated RAM. When the chef-client run is complete the RAM will be returned to the master process. This option helps ensure that a chef-client will use a steady amount of RAM over time because the master process will not run recipes. This option will also help prevent memory leaks (such as those that can be introduced by the code contained within a poorly designed cookbook). Use <tt class="docutils literal"><span class="pre">--no-fork</span></tt> to disable running the chef-client in fork node. Default value: <tt class="docutils literal"><span class="pre">--fork</span></tt>. This option may not be used in the same command with the <tt class="docutils literal"><span class="pre">--daemonize</span></tt> and <tt class="docutils literal"><span class="pre">--interval</span></tt> options.</dd>
76
+ <dt><tt class="docutils literal"><span class="pre">-F</span> <span class="pre">FORMAT</span></tt>, <tt class="docutils literal"><span class="pre">--format</span> <span class="pre">FORMAT</span></tt></dt>
77
+ <dd><p class="first">The output format: <tt class="docutils literal"><span class="pre">doc</span></tt> (default) or <tt class="docutils literal"><span class="pre">min</span></tt>.</p>
78
+ <p>Use <tt class="docutils literal"><span class="pre">doc</span></tt> to print the progress of the chef-client run using full strings that display a summary of updates as they occur.</p>
79
+ <p>Use <tt class="docutils literal"><span class="pre">min</span></tt> to print the progress of the chef-client run using single characters. A summary of updates is printed at the end of the chef-client run. A dot (<tt class="docutils literal"><span class="pre">.</span></tt>) is printed for events that do not have meaningful status information, such as loading a file or synchronizing a cookbook. For resources, a dot (<tt class="docutils literal"><span class="pre">.</span></tt>) is printed when the resource is up to date, an <tt class="docutils literal"><span class="pre">S</span></tt> is printed when the resource is skipped by <tt class="docutils literal"><span class="pre">not_if</span></tt> or <tt class="docutils literal"><span class="pre">only_if</span></tt>, and a <tt class="docutils literal"><span class="pre">U</span></tt> is printed when the resource is updated.</p>
80
+ <p class="last">Other formatting options are available when those formatters are configured in the client.rb file using the <tt class="docutils literal"><span class="pre">add_formatter</span></tt> option.</p>
81
+ </dd>
82
+ <dt><tt class="docutils literal"><span class="pre">--force-formatter</span></tt></dt>
83
+ <dd>Use to show formatter output instead of logger output.</dd>
84
+ <dt><tt class="docutils literal"><span class="pre">--force-logger</span></tt></dt>
85
+ <dd>Use to show logger output instead of formatter output.</dd>
86
+ <dt><tt class="docutils literal"><span class="pre">-g</span> <span class="pre">GROUP</span></tt>, <tt class="docutils literal"><span class="pre">--group</span> <span class="pre">GROUP</span></tt></dt>
87
+ <dd>The name of the group that owns a process. This is required when starting any executable as a daemon.</dd>
88
+ <dt><tt class="docutils literal"><span class="pre">-h</span></tt>, <tt class="docutils literal"><span class="pre">--help</span></tt></dt>
89
+ <dd>Shows help for the command.</dd>
90
+ <dt><tt class="docutils literal"><span class="pre">-i</span> <span class="pre">SECONDS</span></tt>, <tt class="docutils literal"><span class="pre">--interval</span> <span class="pre">SECONDS</span></tt></dt>
91
+ <dd>The frequency (in seconds) at which the chef-client runs. When the chef-client is run at intervals, <tt class="docutils literal"><span class="pre">--splay</span></tt> and <tt class="docutils literal"><span class="pre">--interval</span></tt> values are applied before the chef-client run. This option may not be used in the same command with the <tt class="docutils literal"><span class="pre">--[no-]fork</span></tt> option.</dd>
92
+ <dt><tt class="docutils literal"><span class="pre">-j</span> <span class="pre">PATH</span></tt>, <tt class="docutils literal"><span class="pre">--json-attributes</span> <span class="pre">PATH</span></tt></dt>
93
+ <dd><p class="first">The path to a file that contains JSON data.</p>
94
+ <p>Use this option to define a <tt class="docutils literal"><span class="pre">run_list</span></tt> object. For example, a JSON file similar to:</p>
95
+ <div class="highlight-javascript"><div class="highlight"><pre><span class="s2">&quot;run_list&quot;</span><span class="o">:</span> <span class="p">[</span>
96
+ <span class="s2">&quot;recipe[base]&quot;</span><span class="p">,</span>
97
+ <span class="s2">&quot;recipe[foo]&quot;</span><span class="p">,</span>
98
+ <span class="s2">&quot;recipe[bar]&quot;</span><span class="p">,</span>
99
+ <span class="s2">&quot;role[webserver]&quot;</span>
100
+ <span class="p">],</span>
101
+ </pre></div>
102
+ </div>
103
+ <p>may be used by running <tt class="docutils literal"><span class="pre">chef-client</span> <span class="pre">-j</span> <span class="pre">path/to/file.json</span></tt>.</p>
104
+ <p>In certain situations this option may be used to update <tt class="docutils literal"><span class="pre">normal</span></tt> attributes.</p>
105
+ <div class="last admonition warning">
106
+ <p class="first admonition-title">Warning</p>
107
+ <p>Any other attribute type that is contained in this JSON file will be treated as a <tt class="docutils literal"><span class="pre">normal</span></tt> attribute. For example, attempting to update <tt class="docutils literal"><span class="pre">override</span></tt> attributes using the <tt class="docutils literal"><span class="pre">-j</span></tt> option:</p>
108
+ <div class="highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
109
+ <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99&quot;</span><span class="p">,</span>
110
+ <span class="s2">&quot;description&quot;</span><span class="o">:</span> <span class="s2">&quot;Install some stuff&quot;</span><span class="p">,</span>
111
+ <span class="s2">&quot;override_attributes&quot;</span><span class="o">:</span> <span class="p">{</span>
112
+ <span class="s2">&quot;apptastic&quot;</span><span class="o">:</span> <span class="p">{</span>
113
+ <span class="s2">&quot;enable_apptastic&quot;</span><span class="o">:</span> <span class="s2">&quot;false&quot;</span><span class="p">,</span>
114
+ <span class="s2">&quot;apptastic_tier_name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99.bomb.com&quot;</span>
115
+ <span class="p">}</span>
116
+ <span class="p">}</span>
117
+ <span class="p">}</span>
118
+ </pre></div>
119
+ </div>
120
+ <p>will result in a node object similar to:</p>
121
+ <div class="last highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
122
+ <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;maybe-dev-99&quot;</span><span class="p">,</span>
123
+ <span class="s2">&quot;normal&quot;</span><span class="o">:</span> <span class="p">{</span>
124
+ <span class="s2">&quot;name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99&quot;</span><span class="p">,</span>
125
+ <span class="s2">&quot;description&quot;</span><span class="o">:</span> <span class="s2">&quot;Install some stuff&quot;</span><span class="p">,</span>
126
+ <span class="s2">&quot;override_attributes&quot;</span><span class="o">:</span> <span class="p">{</span>
127
+ <span class="s2">&quot;apptastic&quot;</span><span class="o">:</span> <span class="p">{</span>
128
+ <span class="s2">&quot;enable_apptastic&quot;</span><span class="o">:</span> <span class="s2">&quot;false&quot;</span><span class="p">,</span>
129
+ <span class="s2">&quot;apptastic_tier_name&quot;</span><span class="o">:</span> <span class="s2">&quot;dev-99.bomb.com&quot;</span>
130
+ <span class="p">}</span>
131
+ <span class="p">}</span>
132
+ <span class="p">}</span>
133
+ <span class="p">}</span>
134
+ </pre></div>
135
+ </div>
136
+ </div>
137
+ </dd>
138
+ <dt><tt class="docutils literal"><span class="pre">-l</span> <span class="pre">LEVEL</span></tt>, <tt class="docutils literal"><span class="pre">--log_level</span> <span class="pre">LEVEL</span></tt></dt>
139
+ <dd>The level of logging that will be stored in a log file.</dd>
140
+ <dt><tt class="docutils literal"><span class="pre">-L</span> <span class="pre">LOGLOCATION</span></tt>, <tt class="docutils literal"><span class="pre">--logfile</span> <span class="pre">c</span></tt></dt>
141
+ <dd>The location in which log file output files will be saved. If this location is set to something other than <tt class="docutils literal"><span class="pre">STDOUT</span></tt>, standard output logging will still be performed (otherwise there would be no output other than to a file). This is recommended when starting any executable as a daemon.</dd>
142
+ <dt><tt class="docutils literal"><span class="pre">--[no-]color</span></tt></dt>
143
+ <dd>Use to view colored output. Default setting: <tt class="docutils literal"><span class="pre">--color</span></tt>.</dd>
144
+ <dt><tt class="docutils literal"><span class="pre">-N</span> <span class="pre">NODE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--node-name</span> <span class="pre">NODE_NAME</span></tt></dt>
145
+ <dd>The name of the node.</dd>
146
+ <dt><tt class="docutils literal"><span class="pre">-o</span> <span class="pre">RUN_LIST_ITEM</span></tt>, <tt class="docutils literal"><span class="pre">--override-runlist</span> <span class="pre">RUN_LIST_ITEM</span></tt></dt>
147
+ <dd>Replace the current run list with the specified items.</dd>
148
+ <dt><tt class="docutils literal"><span class="pre">-r</span> <span class="pre">RECIPE_URL</span></tt>, <tt class="docutils literal"><span class="pre">--recipe-url</span> <span class="pre">RECIPE_URL</span></tt></dt>
149
+ <dd>The URL location from which a remote cookbook tar.gz will be downloaded.</dd>
150
+ <dt><tt class="docutils literal"><span class="pre">--run-lock-timeout</span> <span class="pre">SECONDS</span></tt></dt>
151
+ <dd>The amount of time (in seconds) to wait for a chef-client run to finish. Default value: not set (indefinite). Set to <tt class="docutils literal"><span class="pre">0</span></tt> to cause a second chef-client to exit immediately.</dd>
152
+ <dt><tt class="docutils literal"><span class="pre">-s</span> <span class="pre">SECONDS</span></tt>, <tt class="docutils literal"><span class="pre">--splay</span> <span class="pre">SECONDS</span></tt></dt>
153
+ <dd>A number (in seconds) to add to the <tt class="docutils literal"><span class="pre">interval</span></tt> that is used to determine the frequency of chef-client runs. This number can help prevent server load when there are many clients running at the same time. When the chef-client is run at intervals, <tt class="docutils literal"><span class="pre">--splay</span></tt> and <tt class="docutils literal"><span class="pre">--interval</span></tt> values are applied before the chef-client run.</dd>
154
+ <dt><tt class="docutils literal"><span class="pre">-u</span> <span class="pre">USER</span></tt>, <tt class="docutils literal"><span class="pre">--user</span> <span class="pre">USER</span></tt></dt>
155
+ <dd>The user that owns a process. This is required when starting any executable as a daemon.</dd>
156
+ <dt><tt class="docutils literal"><span class="pre">-v</span></tt>, <tt class="docutils literal"><span class="pre">--version</span></tt></dt>
157
+ <dd>The version of the chef-client.</dd>
158
+ <dt><tt class="docutils literal"><span class="pre">-W</span></tt>, <tt class="docutils literal"><span class="pre">--why-run</span></tt></dt>
159
+ <dd>Use to run the executable in why-run mode, which is a type of chef-client run that does everything except modify the system. Use why-run mode to understand why the chef-client makes the decisions that it makes and to learn more about the current and proposed state of the system.</dd>
160
+ </dl>
161
+ </div>
162
+ <div class="section" id="examples">
163
+ <h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
164
+ <p><strong>Use a URL</strong></p>
165
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-solo -c ~/solo.rb -j ~/node.json -r http://www.example.com/chef-solo.tar.gz
166
+ </pre></div>
167
+ </div>
168
+ <p>The tar.gz archived into the <tt class="docutils literal"><span class="pre">file_cache_path</span></tt>, and then extracted to <tt class="docutils literal"><span class="pre">cookbooks_path</span></tt>.</p>
169
+ <p><strong>Use a directory</strong></p>
170
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-solo -c ~/solo.rb -j ~/node.json
171
+ </pre></div>
172
+ </div>
173
+ <p>chef-solo will look in the solo.rb file to determine the directory in which cookbooks are located.</p>
174
+ <p><strong>Use a URL for cookbook and JSON data</strong></p>
175
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-solo -c ~/solo.rb -j http://www.example.com/node.json -r http://www.example.com/chef-solo.tar.gz
176
+ </pre></div>
177
+ </div>
178
+ </div>
179
+ </div>
180
+
181
+
182
+ </div>
183
+
184
+ </div>
185
+
186
+
187
+ <div class="clearer"></div>
188
+ </div>
189
+
190
+
191
+
192
+
193
+ </body>
194
194
  </html>