tylerrick-chef 0.10.8

Sign up to get free protection for your applications and to get access to all the features.
Files changed (450) hide show
  1. data/LICENSE +201 -0
  2. data/README.rdoc +171 -0
  3. data/bin/chef-client +26 -0
  4. data/bin/chef-solo +25 -0
  5. data/bin/knife +26 -0
  6. data/bin/shef +34 -0
  7. data/distro/README +2 -0
  8. data/distro/arch/etc/conf.d/chef-client.conf +5 -0
  9. data/distro/arch/etc/conf.d/chef-expander.conf +8 -0
  10. data/distro/arch/etc/conf.d/chef-server-webui.conf +10 -0
  11. data/distro/arch/etc/conf.d/chef-server.conf +10 -0
  12. data/distro/arch/etc/conf.d/chef-solr.conf +8 -0
  13. data/distro/arch/etc/rc.d/chef-client +76 -0
  14. data/distro/arch/etc/rc.d/chef-expander +78 -0
  15. data/distro/arch/etc/rc.d/chef-server +78 -0
  16. data/distro/arch/etc/rc.d/chef-server-webui +78 -0
  17. data/distro/arch/etc/rc.d/chef-solr +78 -0
  18. data/distro/common/html/chef-client.8.html +146 -0
  19. data/distro/common/html/chef-expander.8.html +164 -0
  20. data/distro/common/html/chef-expanderctl.8.html +146 -0
  21. data/distro/common/html/chef-server-webui.8.html +185 -0
  22. data/distro/common/html/chef-server.8.html +182 -0
  23. data/distro/common/html/chef-solo.8.html +191 -0
  24. data/distro/common/html/chef-solr.8.html +165 -0
  25. data/distro/common/html/knife-bootstrap.1.html +243 -0
  26. data/distro/common/html/knife-client.1.html +219 -0
  27. data/distro/common/html/knife-configure.1.html +170 -0
  28. data/distro/common/html/knife-cookbook-site.1.html +241 -0
  29. data/distro/common/html/knife-cookbook.1.html +384 -0
  30. data/distro/common/html/knife-data-bag.1.html +234 -0
  31. data/distro/common/html/knife-environment.1.html +267 -0
  32. data/distro/common/html/knife-exec.1.html +134 -0
  33. data/distro/common/html/knife-index.1.html +125 -0
  34. data/distro/common/html/knife-node.1.html +250 -0
  35. data/distro/common/html/knife-recipe.1.html +92 -0
  36. data/distro/common/html/knife-role.1.html +200 -0
  37. data/distro/common/html/knife-search.1.html +288 -0
  38. data/distro/common/html/knife-ssh.1.html +157 -0
  39. data/distro/common/html/knife-status.1.html +128 -0
  40. data/distro/common/html/knife-tag.1.html +137 -0
  41. data/distro/common/html/knife.1.html +321 -0
  42. data/distro/common/html/shef.1.html +283 -0
  43. data/distro/common/man/man1/knife-bootstrap.1 +197 -0
  44. data/distro/common/man/man1/knife-client.1 +99 -0
  45. data/distro/common/man/man1/knife-configure.1 +88 -0
  46. data/distro/common/man/man1/knife-cookbook-site.1 +145 -0
  47. data/distro/common/man/man1/knife-cookbook.1 +345 -0
  48. data/distro/common/man/man1/knife-data-bag.1 +130 -0
  49. data/distro/common/man/man1/knife-environment.1 +178 -0
  50. data/distro/common/man/man1/knife-exec.1 +46 -0
  51. data/distro/common/man/man1/knife-index.1 +29 -0
  52. data/distro/common/man/man1/knife-node.1 +134 -0
  53. data/distro/common/man/man1/knife-role.1 +88 -0
  54. data/distro/common/man/man1/knife-search.1 +280 -0
  55. data/distro/common/man/man1/knife-ssh.1 +83 -0
  56. data/distro/common/man/man1/knife-status.1 +29 -0
  57. data/distro/common/man/man1/knife-tag.1 +43 -0
  58. data/distro/common/man/man1/knife.1 +292 -0
  59. data/distro/common/man/man1/shef.1 +256 -0
  60. data/distro/common/man/man8/chef-client.8 +104 -0
  61. data/distro/common/man/man8/chef-expander.8 +97 -0
  62. data/distro/common/man/man8/chef-expanderctl.8 +62 -0
  63. data/distro/common/man/man8/chef-server-webui.8 +155 -0
  64. data/distro/common/man/man8/chef-server.8 +147 -0
  65. data/distro/common/man/man8/chef-solo.8 +158 -0
  66. data/distro/common/man/man8/chef-solr.8 +122 -0
  67. data/distro/common/markdown/README +3 -0
  68. data/distro/common/markdown/man1/knife-bootstrap.mkd +142 -0
  69. data/distro/common/markdown/man1/knife-client.mkd +103 -0
  70. data/distro/common/markdown/man1/knife-configure.mkd +70 -0
  71. data/distro/common/markdown/man1/knife-cookbook-site.mkd +123 -0
  72. data/distro/common/markdown/man1/knife-cookbook.mkd +263 -0
  73. data/distro/common/markdown/man1/knife-data-bag.mkd +117 -0
  74. data/distro/common/markdown/man1/knife-environment.mkd +151 -0
  75. data/distro/common/markdown/man1/knife-exec.mkd +37 -0
  76. data/distro/common/markdown/man1/knife-index.mkd +30 -0
  77. data/distro/common/markdown/man1/knife-node.mkd +130 -0
  78. data/distro/common/markdown/man1/knife-role.mkd +85 -0
  79. data/distro/common/markdown/man1/knife-search.mkd +180 -0
  80. data/distro/common/markdown/man1/knife-ssh.mkd +72 -0
  81. data/distro/common/markdown/man1/knife-status.mkd +36 -0
  82. data/distro/common/markdown/man1/knife-tag.mkd +39 -0
  83. data/distro/common/markdown/man1/knife.mkd +220 -0
  84. data/distro/common/markdown/man1/shef.mkd +189 -0
  85. data/distro/common/markdown/man8/chef-client.mkd +75 -0
  86. data/distro/common/markdown/man8/chef-expander.mkd +82 -0
  87. data/distro/common/markdown/man8/chef-expanderctl.mkd +58 -0
  88. data/distro/common/markdown/man8/chef-server-webui.mkd +121 -0
  89. data/distro/common/markdown/man8/chef-server.mkd +121 -0
  90. data/distro/common/markdown/man8/chef-solo.mkd +107 -0
  91. data/distro/common/markdown/man8/chef-solr.mkd +89 -0
  92. data/distro/debian/etc/default/chef-client +4 -0
  93. data/distro/debian/etc/default/chef-expander +8 -0
  94. data/distro/debian/etc/default/chef-server +9 -0
  95. data/distro/debian/etc/default/chef-server-webui +9 -0
  96. data/distro/debian/etc/default/chef-solr +8 -0
  97. data/distro/debian/etc/init.d/chef-client +185 -0
  98. data/distro/debian/etc/init.d/chef-expander +176 -0
  99. data/distro/debian/etc/init.d/chef-server +122 -0
  100. data/distro/debian/etc/init.d/chef-server-webui +123 -0
  101. data/distro/debian/etc/init.d/chef-solr +176 -0
  102. data/distro/debian/etc/init/chef-client.conf +17 -0
  103. data/distro/debian/etc/init/chef-expander.conf +17 -0
  104. data/distro/debian/etc/init/chef-server-webui.conf +17 -0
  105. data/distro/debian/etc/init/chef-server.conf +17 -0
  106. data/distro/debian/etc/init/chef-solr.conf +17 -0
  107. data/distro/redhat/etc/init.d/chef-client +110 -0
  108. data/distro/redhat/etc/init.d/chef-expander +104 -0
  109. data/distro/redhat/etc/init.d/chef-server +112 -0
  110. data/distro/redhat/etc/init.d/chef-server-webui +112 -0
  111. data/distro/redhat/etc/init.d/chef-solr +104 -0
  112. data/distro/redhat/etc/logrotate.d/chef-client +8 -0
  113. data/distro/redhat/etc/logrotate.d/chef-expander +8 -0
  114. data/distro/redhat/etc/logrotate.d/chef-server +8 -0
  115. data/distro/redhat/etc/logrotate.d/chef-server-webui +8 -0
  116. data/distro/redhat/etc/logrotate.d/chef-solr +8 -0
  117. data/distro/redhat/etc/sysconfig/chef-client +15 -0
  118. data/distro/redhat/etc/sysconfig/chef-expander +7 -0
  119. data/distro/redhat/etc/sysconfig/chef-server +14 -0
  120. data/distro/redhat/etc/sysconfig/chef-server-webui +14 -0
  121. data/distro/redhat/etc/sysconfig/chef-solr +8 -0
  122. data/lib/chef.rb +41 -0
  123. data/lib/chef/api_client.rb +271 -0
  124. data/lib/chef/application.rb +152 -0
  125. data/lib/chef/application/agent.rb +18 -0
  126. data/lib/chef/application/client.rb +285 -0
  127. data/lib/chef/application/knife.rb +188 -0
  128. data/lib/chef/application/solo.rb +218 -0
  129. data/lib/chef/applications.rb +4 -0
  130. data/lib/chef/certificate.rb +194 -0
  131. data/lib/chef/checksum.rb +167 -0
  132. data/lib/chef/checksum/storage.rb +18 -0
  133. data/lib/chef/checksum/storage/filesystem.rb +56 -0
  134. data/lib/chef/checksum_cache.rb +189 -0
  135. data/lib/chef/client.rb +366 -0
  136. data/lib/chef/config.rb +248 -0
  137. data/lib/chef/cookbook/chefignore.rb +66 -0
  138. data/lib/chef/cookbook/cookbook_collection.rb +45 -0
  139. data/lib/chef/cookbook/cookbook_version_loader.rb +173 -0
  140. data/lib/chef/cookbook/file_system_file_vendor.rb +56 -0
  141. data/lib/chef/cookbook/file_vendor.rb +48 -0
  142. data/lib/chef/cookbook/metadata.rb +629 -0
  143. data/lib/chef/cookbook/remote_file_vendor.rb +88 -0
  144. data/lib/chef/cookbook/syntax_check.rb +136 -0
  145. data/lib/chef/cookbook_loader.rb +121 -0
  146. data/lib/chef/cookbook_site_streaming_uploader.rb +244 -0
  147. data/lib/chef/cookbook_uploader.rb +154 -0
  148. data/lib/chef/cookbook_version.rb +1096 -0
  149. data/lib/chef/cookbook_version_selector.rb +168 -0
  150. data/lib/chef/couchdb.rb +246 -0
  151. data/lib/chef/daemon.rb +172 -0
  152. data/lib/chef/data_bag.rb +235 -0
  153. data/lib/chef/data_bag_item.rb +273 -0
  154. data/lib/chef/encrypted_data_bag_item.rb +139 -0
  155. data/lib/chef/environment.rb +455 -0
  156. data/lib/chef/exceptions.rb +154 -0
  157. data/lib/chef/file_access_control.rb +144 -0
  158. data/lib/chef/file_cache.rb +218 -0
  159. data/lib/chef/handler.rb +227 -0
  160. data/lib/chef/handler/error_report.rb +33 -0
  161. data/lib/chef/handler/json_file.rb +58 -0
  162. data/lib/chef/index_queue.rb +29 -0
  163. data/lib/chef/index_queue/amqp_client.rb +116 -0
  164. data/lib/chef/index_queue/consumer.rb +76 -0
  165. data/lib/chef/index_queue/indexable.rb +109 -0
  166. data/lib/chef/json_compat.rb +52 -0
  167. data/lib/chef/knife.rb +520 -0
  168. data/lib/chef/knife/bootstrap.rb +207 -0
  169. data/lib/chef/knife/bootstrap/archlinux-gems.erb +60 -0
  170. data/lib/chef/knife/bootstrap/centos5-gems.erb +56 -0
  171. data/lib/chef/knife/bootstrap/fedora13-gems.erb +43 -0
  172. data/lib/chef/knife/bootstrap/ubuntu10.04-apt.erb +49 -0
  173. data/lib/chef/knife/bootstrap/ubuntu10.04-gems.erb +50 -0
  174. data/lib/chef/knife/client_bulk_delete.rb +65 -0
  175. data/lib/chef/knife/client_create.rb +79 -0
  176. data/lib/chef/knife/client_delete.rb +46 -0
  177. data/lib/chef/knife/client_edit.rb +45 -0
  178. data/lib/chef/knife/client_list.rb +42 -0
  179. data/lib/chef/knife/client_reregister.rb +58 -0
  180. data/lib/chef/knife/client_show.rb +52 -0
  181. data/lib/chef/knife/configure.rb +149 -0
  182. data/lib/chef/knife/configure_client.rb +50 -0
  183. data/lib/chef/knife/cookbook_bulk_delete.rb +72 -0
  184. data/lib/chef/knife/cookbook_create.rb +274 -0
  185. data/lib/chef/knife/cookbook_delete.rb +151 -0
  186. data/lib/chef/knife/cookbook_download.rb +137 -0
  187. data/lib/chef/knife/cookbook_list.rb +47 -0
  188. data/lib/chef/knife/cookbook_metadata.rb +107 -0
  189. data/lib/chef/knife/cookbook_metadata_from_file.rb +44 -0
  190. data/lib/chef/knife/cookbook_show.rb +102 -0
  191. data/lib/chef/knife/cookbook_site_download.rb +70 -0
  192. data/lib/chef/knife/cookbook_site_install.rb +148 -0
  193. data/lib/chef/knife/cookbook_site_list.rb +62 -0
  194. data/lib/chef/knife/cookbook_site_search.rb +51 -0
  195. data/lib/chef/knife/cookbook_site_share.rb +114 -0
  196. data/lib/chef/knife/cookbook_site_show.rb +57 -0
  197. data/lib/chef/knife/cookbook_site_unshare.rb +56 -0
  198. data/lib/chef/knife/cookbook_site_vendor.rb +46 -0
  199. data/lib/chef/knife/cookbook_test.rb +93 -0
  200. data/lib/chef/knife/cookbook_upload.rb +240 -0
  201. data/lib/chef/knife/core/bootstrap_context.rb +100 -0
  202. data/lib/chef/knife/core/cookbook_scm_repo.rb +148 -0
  203. data/lib/chef/knife/core/generic_presenter.rb +191 -0
  204. data/lib/chef/knife/core/node_editor.rb +127 -0
  205. data/lib/chef/knife/core/node_presenter.rb +136 -0
  206. data/lib/chef/knife/core/object_loader.rb +75 -0
  207. data/lib/chef/knife/core/subcommand_loader.rb +112 -0
  208. data/lib/chef/knife/core/text_formatter.rb +100 -0
  209. data/lib/chef/knife/core/ui.rb +216 -0
  210. data/lib/chef/knife/data_bag_create.rb +93 -0
  211. data/lib/chef/knife/data_bag_delete.rb +51 -0
  212. data/lib/chef/knife/data_bag_edit.rb +94 -0
  213. data/lib/chef/knife/data_bag_from_file.rb +87 -0
  214. data/lib/chef/knife/data_bag_list.rb +46 -0
  215. data/lib/chef/knife/data_bag_show.rb +81 -0
  216. data/lib/chef/knife/environment_create.rb +53 -0
  217. data/lib/chef/knife/environment_delete.rb +45 -0
  218. data/lib/chef/knife/environment_edit.rb +45 -0
  219. data/lib/chef/knife/environment_from_file.rb +50 -0
  220. data/lib/chef/knife/environment_list.rb +42 -0
  221. data/lib/chef/knife/environment_show.rb +46 -0
  222. data/lib/chef/knife/exec.rb +51 -0
  223. data/lib/chef/knife/help.rb +103 -0
  224. data/lib/chef/knife/help_topics.rb +4 -0
  225. data/lib/chef/knife/index_rebuild.rb +50 -0
  226. data/lib/chef/knife/node_bulk_delete.rb +80 -0
  227. data/lib/chef/knife/node_create.rb +50 -0
  228. data/lib/chef/knife/node_delete.rb +47 -0
  229. data/lib/chef/knife/node_edit.rb +72 -0
  230. data/lib/chef/knife/node_from_file.rb +50 -0
  231. data/lib/chef/knife/node_list.rb +46 -0
  232. data/lib/chef/knife/node_run_list_add.rb +67 -0
  233. data/lib/chef/knife/node_run_list_remove.rb +48 -0
  234. data/lib/chef/knife/node_show.rb +73 -0
  235. data/lib/chef/knife/recipe_list.rb +32 -0
  236. data/lib/chef/knife/role_bulk_delete.rb +70 -0
  237. data/lib/chef/knife/role_create.rb +55 -0
  238. data/lib/chef/knife/role_delete.rb +47 -0
  239. data/lib/chef/knife/role_edit.rb +48 -0
  240. data/lib/chef/knife/role_from_file.rb +56 -0
  241. data/lib/chef/knife/role_list.rb +43 -0
  242. data/lib/chef/knife/role_show.rb +54 -0
  243. data/lib/chef/knife/search.rb +141 -0
  244. data/lib/chef/knife/ssh.rb +367 -0
  245. data/lib/chef/knife/status.rb +104 -0
  246. data/lib/chef/knife/tag_create.rb +52 -0
  247. data/lib/chef/knife/tag_delete.rb +60 -0
  248. data/lib/chef/knife/tag_list.rb +47 -0
  249. data/lib/chef/log.rb +39 -0
  250. data/lib/chef/mash.rb +211 -0
  251. data/lib/chef/mixin/check_helper.rb +31 -0
  252. data/lib/chef/mixin/checksum.rb +32 -0
  253. data/lib/chef/mixin/command.rb +163 -0
  254. data/lib/chef/mixin/command/unix.rb +215 -0
  255. data/lib/chef/mixin/command/windows.rb +76 -0
  256. data/lib/chef/mixin/convert_to_class_name.rb +63 -0
  257. data/lib/chef/mixin/create_path.rb +57 -0
  258. data/lib/chef/mixin/deep_merge.rb +225 -0
  259. data/lib/chef/mixin/deprecation.rb +65 -0
  260. data/lib/chef/mixin/from_file.rb +50 -0
  261. data/lib/chef/mixin/get_source_from_package.rb +42 -0
  262. data/lib/chef/mixin/language.rb +163 -0
  263. data/lib/chef/mixin/language_include_attribute.rb +61 -0
  264. data/lib/chef/mixin/language_include_recipe.rb +52 -0
  265. data/lib/chef/mixin/params_validate.rb +225 -0
  266. data/lib/chef/mixin/recipe_definition_dsl_core.rb +78 -0
  267. data/lib/chef/mixin/shell_out.rb +41 -0
  268. data/lib/chef/mixin/template.rb +95 -0
  269. data/lib/chef/mixin/xml_escape.rb +140 -0
  270. data/lib/chef/mixins.rb +15 -0
  271. data/lib/chef/monkey_patches/dir.rb +36 -0
  272. data/lib/chef/monkey_patches/numeric.rb +15 -0
  273. data/lib/chef/monkey_patches/object.rb +9 -0
  274. data/lib/chef/monkey_patches/regexp.rb +34 -0
  275. data/lib/chef/monkey_patches/string.rb +49 -0
  276. data/lib/chef/monkey_patches/tempfile.rb +64 -0
  277. data/lib/chef/nil_argument.rb +3 -0
  278. data/lib/chef/node.rb +677 -0
  279. data/lib/chef/node/attribute.rb +487 -0
  280. data/lib/chef/openid_registration.rb +187 -0
  281. data/lib/chef/platform.rb +434 -0
  282. data/lib/chef/provider.rb +124 -0
  283. data/lib/chef/provider/breakpoint.rb +36 -0
  284. data/lib/chef/provider/cookbook_file.rb +100 -0
  285. data/lib/chef/provider/cron.rb +186 -0
  286. data/lib/chef/provider/cron/solaris.rb +195 -0
  287. data/lib/chef/provider/deploy.rb +418 -0
  288. data/lib/chef/provider/deploy/revision.rb +80 -0
  289. data/lib/chef/provider/deploy/timestamped.rb +33 -0
  290. data/lib/chef/provider/directory.rb +72 -0
  291. data/lib/chef/provider/env.rb +152 -0
  292. data/lib/chef/provider/env/windows.rb +75 -0
  293. data/lib/chef/provider/erl_call.rb +101 -0
  294. data/lib/chef/provider/execute.rb +65 -0
  295. data/lib/chef/provider/file.rb +226 -0
  296. data/lib/chef/provider/git.rb +243 -0
  297. data/lib/chef/provider/group.rb +133 -0
  298. data/lib/chef/provider/group/aix.rb +70 -0
  299. data/lib/chef/provider/group/dscl.rb +121 -0
  300. data/lib/chef/provider/group/gpasswd.rb +53 -0
  301. data/lib/chef/provider/group/groupadd.rb +91 -0
  302. data/lib/chef/provider/group/pw.rb +84 -0
  303. data/lib/chef/provider/group/suse.rb +53 -0
  304. data/lib/chef/provider/group/usermod.rb +57 -0
  305. data/lib/chef/provider/group/windows.rb +79 -0
  306. data/lib/chef/provider/http_request.rb +122 -0
  307. data/lib/chef/provider/ifconfig.rb +195 -0
  308. data/lib/chef/provider/link.rb +164 -0
  309. data/lib/chef/provider/log.rb +54 -0
  310. data/lib/chef/provider/mdadm.rb +91 -0
  311. data/lib/chef/provider/mount.rb +114 -0
  312. data/lib/chef/provider/mount/mount.rb +240 -0
  313. data/lib/chef/provider/mount/windows.rb +81 -0
  314. data/lib/chef/provider/ohai.rb +42 -0
  315. data/lib/chef/provider/package.rb +200 -0
  316. data/lib/chef/provider/package/apt.rb +145 -0
  317. data/lib/chef/provider/package/dpkg.rb +115 -0
  318. data/lib/chef/provider/package/easy_install.rb +136 -0
  319. data/lib/chef/provider/package/freebsd.rb +125 -0
  320. data/lib/chef/provider/package/macports.rb +105 -0
  321. data/lib/chef/provider/package/pacman.rb +101 -0
  322. data/lib/chef/provider/package/portage.rb +135 -0
  323. data/lib/chef/provider/package/rpm.rb +104 -0
  324. data/lib/chef/provider/package/rubygems.rb +465 -0
  325. data/lib/chef/provider/package/solaris.rb +130 -0
  326. data/lib/chef/provider/package/yum-dump.py +286 -0
  327. data/lib/chef/provider/package/yum.rb +1173 -0
  328. data/lib/chef/provider/package/zypper.rb +144 -0
  329. data/lib/chef/provider/remote_directory.rb +137 -0
  330. data/lib/chef/provider/remote_file.rb +118 -0
  331. data/lib/chef/provider/route.rb +193 -0
  332. data/lib/chef/provider/ruby_block.rb +34 -0
  333. data/lib/chef/provider/script.rb +55 -0
  334. data/lib/chef/provider/service.rb +122 -0
  335. data/lib/chef/provider/service/arch.rb +116 -0
  336. data/lib/chef/provider/service/debian.rb +130 -0
  337. data/lib/chef/provider/service/freebsd.rb +154 -0
  338. data/lib/chef/provider/service/gentoo.rb +53 -0
  339. data/lib/chef/provider/service/init.rb +71 -0
  340. data/lib/chef/provider/service/insserv.rb +52 -0
  341. data/lib/chef/provider/service/invokercd.rb +35 -0
  342. data/lib/chef/provider/service/redhat.rb +60 -0
  343. data/lib/chef/provider/service/simple.rb +120 -0
  344. data/lib/chef/provider/service/solaris.rb +85 -0
  345. data/lib/chef/provider/service/systemd.rb +102 -0
  346. data/lib/chef/provider/service/upstart.rb +198 -0
  347. data/lib/chef/provider/service/windows.rb +155 -0
  348. data/lib/chef/provider/subversion.rb +197 -0
  349. data/lib/chef/provider/template.rb +104 -0
  350. data/lib/chef/provider/user.rb +186 -0
  351. data/lib/chef/provider/user/dscl.rb +280 -0
  352. data/lib/chef/provider/user/pw.rb +113 -0
  353. data/lib/chef/provider/user/useradd.rb +137 -0
  354. data/lib/chef/provider/user/windows.rb +124 -0
  355. data/lib/chef/providers.rb +95 -0
  356. data/lib/chef/recipe.rb +129 -0
  357. data/lib/chef/resource.rb +609 -0
  358. data/lib/chef/resource/apt_package.rb +34 -0
  359. data/lib/chef/resource/bash.rb +33 -0
  360. data/lib/chef/resource/breakpoint.rb +35 -0
  361. data/lib/chef/resource/conditional.rb +90 -0
  362. data/lib/chef/resource/cookbook_file.rb +45 -0
  363. data/lib/chef/resource/cron.rb +188 -0
  364. data/lib/chef/resource/csh.rb +33 -0
  365. data/lib/chef/resource/deploy.rb +389 -0
  366. data/lib/chef/resource/deploy_revision.rb +40 -0
  367. data/lib/chef/resource/directory.rb +76 -0
  368. data/lib/chef/resource/dpkg_package.rb +34 -0
  369. data/lib/chef/resource/easy_install_package.rb +57 -0
  370. data/lib/chef/resource/env.rb +58 -0
  371. data/lib/chef/resource/erl_call.rb +83 -0
  372. data/lib/chef/resource/execute.rb +127 -0
  373. data/lib/chef/resource/file.rb +99 -0
  374. data/lib/chef/resource/freebsd_package.rb +35 -0
  375. data/lib/chef/resource/gem_package.rb +53 -0
  376. data/lib/chef/resource/git.rb +46 -0
  377. data/lib/chef/resource/group.rb +78 -0
  378. data/lib/chef/resource/http_request.rb +61 -0
  379. data/lib/chef/resource/ifconfig.rb +144 -0
  380. data/lib/chef/resource/link.rb +78 -0
  381. data/lib/chef/resource/log.rb +62 -0
  382. data/lib/chef/resource/macports_package.rb +29 -0
  383. data/lib/chef/resource/mdadm.rb +82 -0
  384. data/lib/chef/resource/mount.rb +134 -0
  385. data/lib/chef/resource/ohai.rb +40 -0
  386. data/lib/chef/resource/package.rb +80 -0
  387. data/lib/chef/resource/pacman_package.rb +33 -0
  388. data/lib/chef/resource/perl.rb +33 -0
  389. data/lib/chef/resource/portage_package.rb +33 -0
  390. data/lib/chef/resource/python.rb +33 -0
  391. data/lib/chef/resource/remote_directory.rb +109 -0
  392. data/lib/chef/resource/remote_file.rb +83 -0
  393. data/lib/chef/resource/route.rb +135 -0
  394. data/lib/chef/resource/rpm_package.rb +34 -0
  395. data/lib/chef/resource/ruby.rb +33 -0
  396. data/lib/chef/resource/ruby_block.rb +40 -0
  397. data/lib/chef/resource/scm.rb +147 -0
  398. data/lib/chef/resource/script.rb +60 -0
  399. data/lib/chef/resource/service.rb +151 -0
  400. data/lib/chef/resource/solaris_package.rb +36 -0
  401. data/lib/chef/resource/subversion.rb +36 -0
  402. data/lib/chef/resource/template.rb +69 -0
  403. data/lib/chef/resource/timestamped_deploy.rb +31 -0
  404. data/lib/chef/resource/user.rb +130 -0
  405. data/lib/chef/resource/yum_package.rb +63 -0
  406. data/lib/chef/resource_collection.rb +217 -0
  407. data/lib/chef/resource_collection/stepable_iterator.rb +124 -0
  408. data/lib/chef/resource_definition.rb +67 -0
  409. data/lib/chef/resource_definition_list.rb +38 -0
  410. data/lib/chef/resources.rb +64 -0
  411. data/lib/chef/rest.rb +400 -0
  412. data/lib/chef/rest/auth_credentials.rb +71 -0
  413. data/lib/chef/rest/cookie_jar.rb +31 -0
  414. data/lib/chef/rest/rest_request.rb +213 -0
  415. data/lib/chef/role.rb +343 -0
  416. data/lib/chef/run_context.rb +126 -0
  417. data/lib/chef/run_list.rb +165 -0
  418. data/lib/chef/run_list/run_list_expansion.rb +193 -0
  419. data/lib/chef/run_list/run_list_item.rb +92 -0
  420. data/lib/chef/run_list/versioned_recipe_list.rb +68 -0
  421. data/lib/chef/run_status.rb +121 -0
  422. data/lib/chef/runner.rb +105 -0
  423. data/lib/chef/sandbox.rb +153 -0
  424. data/lib/chef/search/query.rb +65 -0
  425. data/lib/chef/shef.rb +327 -0
  426. data/lib/chef/shef/ext.rb +569 -0
  427. data/lib/chef/shef/model_wrapper.rb +120 -0
  428. data/lib/chef/shef/shef_rest.rb +28 -0
  429. data/lib/chef/shef/shef_session.rb +285 -0
  430. data/lib/chef/shell_out.rb +249 -0
  431. data/lib/chef/shell_out/unix.rb +223 -0
  432. data/lib/chef/shell_out/windows.rb +588 -0
  433. data/lib/chef/solr_query.rb +187 -0
  434. data/lib/chef/solr_query/lucene.treetop +150 -0
  435. data/lib/chef/solr_query/lucene_nodes.rb +285 -0
  436. data/lib/chef/solr_query/query_transform.rb +65 -0
  437. data/lib/chef/solr_query/solr_http_request.rb +132 -0
  438. data/lib/chef/streaming_cookbook_uploader.rb +201 -0
  439. data/lib/chef/tasks/chef_repo.rake +334 -0
  440. data/lib/chef/util/file_edit.rb +122 -0
  441. data/lib/chef/util/windows.rb +56 -0
  442. data/lib/chef/util/windows/net_group.rb +101 -0
  443. data/lib/chef/util/windows/net_use.rb +121 -0
  444. data/lib/chef/util/windows/net_user.rb +198 -0
  445. data/lib/chef/util/windows/volume.rb +59 -0
  446. data/lib/chef/version.rb +23 -0
  447. data/lib/chef/version_class.rb +70 -0
  448. data/lib/chef/version_constraint.rb +116 -0
  449. data/lib/chef/webui_user.rb +231 -0
  450. metadata +764 -0
data/distro/common/html/knife-configure.1.html ADDED
@@ -0,0 +1,170 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta http-equiv='content-type' value='text/html;charset=utf8'>
5
+ <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
6
+ <title>knife-configure(1) - Generate configuration files for knife or Chef Client</title>
7
+ <style type='text/css' media='all'>
8
+ /* style: man */
9
+ body#manpage {margin:0}
10
+ .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
11
+ .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
12
+ .mp h2 {margin:10px 0 0 0}
13
+ .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
14
+ .mp h3 {margin:0 0 0 4ex}
15
+ .mp dt {margin:0;clear:left}
16
+ .mp dt.flush {float:left;width:8ex}
17
+ .mp dd {margin:0 0 0 9ex}
18
+ .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
19
+ .mp pre {margin-bottom:20px}
20
+ .mp pre+h2,.mp pre+h3 {margin-top:22px}
21
+ .mp h2+pre,.mp h3+pre {margin-top:5px}
22
+ .mp img {display:block;margin:auto}
23
+ .mp h1.man-title {display:none}
24
+ .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
25
+ .mp h2 {font-size:16px;line-height:1.25}
26
+ .mp h1 {font-size:20px;line-height:2}
27
+ .mp {text-align:justify;background:#fff}
28
+ .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
29
+ .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
30
+ .mp u {text-decoration:underline}
31
+ .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
32
+ .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
33
+ .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
34
+ .mp b.man-ref {font-weight:normal;color:#434241}
35
+ .mp pre {padding:0 4ex}
36
+ .mp pre code {font-weight:normal;color:#434241}
37
+ .mp h2+pre,h3+pre {padding-left:0}
38
+ ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
39
+ ol.man-decor {width:100%}
40
+ ol.man-decor li.tl {text-align:left}
41
+ ol.man-decor li.tc {text-align:center;letter-spacing:4px}
42
+ ol.man-decor li.tr {text-align:right;float:right}
43
+ </style>
44
+ <style type='text/css' media='all'>
45
+ /* style: toc */
46
+ .man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
47
+ .man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
48
+ .man-navigation a:hover {color:#111;text-decoration:underline}
49
+ </style>
50
+ </head>
51
+ <!--
52
+ The following styles are deprecated and will be removed at some point:
53
+ div#man, div#man ol.man, div#man ol.head, div#man ol.man.
54
+
55
+ The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
56
+ .man-navigation should be used instead.
57
+ -->
58
+ <body id='manpage'>
59
+ <div class='mp' id='man'>
60
+
61
+ <div class='man-navigation' style='display:none'>
62
+ <a href="#NAME">NAME</a>
63
+ <a href="#SYNOPSIS">SYNOPSIS</a>
64
+ <a href="#DESCRIPTION">DESCRIPTION</a>
65
+ <a href="#CONFIGURE-SUBCOMMANDS">CONFIGURE SUBCOMMANDS</a>
66
+ <a href="#EXAMPLES">EXAMPLES</a>
67
+ <a href="#SEE-ALSO">SEE ALSO</a>
68
+ <a href="#AUTHOR">AUTHOR</a>
69
+ <a href="#DOCUMENTATION">DOCUMENTATION</a>
70
+ <a href="#CHEF">CHEF</a>
71
+ </div>
72
+
73
+ <ol class='man-decor man-head man head'>
74
+ <li class='tl'>knife-configure(1)</li>
75
+ <li class='tc'>Chef Manual</li>
76
+ <li class='tr'>knife-configure(1)</li>
77
+ </ol>
78
+
79
+ <h2 id="NAME">NAME</h2>
80
+ <p class="man-name">
81
+ <code>knife-configure</code> - <span class="man-whatis">Generate configuration files for knife or Chef Client</span>
82
+ </p>
83
+
84
+ <h2 id="SYNOPSIS">SYNOPSIS</h2>
85
+
86
+ <p><strong>knife</strong> <strong>configure</strong> [client] <em>(options)</em></p>
87
+
88
+ <h2 id="DESCRIPTION">DESCRIPTION</h2>
89
+
90
+ <p>Generates a knife.rb configuration file interactively. When given the
91
+ --initial option, also creates a new administrative user.</p>
92
+
93
+ <h2 id="CONFIGURE-SUBCOMMANDS">CONFIGURE SUBCOMMANDS</h2>
94
+
95
+ <p><strong>knife configure</strong> <em>(options)</em></p>
96
+
97
+ <dl>
98
+ <dt><code>-i</code>, <code>--initial</code></dt><dd>Create an initial API Client</dd>
99
+ <dt><code>-r</code>, <code>--repository REPO</code></dt><dd>The path to your chef-repo</dd>
100
+ </dl>
101
+
102
+
103
+ <p>Create a configuration file for knife. This will prompt for values to
104
+ enter into the file. Default values are listed in square brackets if no
105
+ other entry is typed. See <strong>knife</strong>(1) for a description of
106
+ configuration options.</p>
107
+
108
+ <p><strong>knife configure client</strong> <em>directory</em></p>
109
+
110
+ <p>Read the <em>knife.rb</em> config file and generate a config file suitable for
111
+ use in <em>/etc/chef/client.rb</em> and copy the validation certificate into
112
+ the specified <em>directory</em>.</p>
113
+
114
+ <h2 id="EXAMPLES">EXAMPLES</h2>
115
+
116
+ <ul>
117
+ <li><p>On a freshly installed Chef Server, use <em>knife configure -i</em> to
118
+ create an administrator and knife configuration file. Leave the
119
+ field blank to accept the default value. On most systems, the
120
+ default values are acceptable.</p>
121
+
122
+ <p>user@host$ knife configure -i<br />
123
+ Please enter the chef server URL: [http://localhost:4000]<br />
124
+ Please enter a clientname for the new client: [username]<br />
125
+ Please enter the existing admin clientname: [chef-webui]<br />
126
+ Please enter the location of the existing admin client's private key: [/etc/chef/webui.pem]<br />
127
+ Please enter the validation clientname: [chef-validator]<br />
128
+ Please enter the location of the validation key: [/etc/chef/validation.pem]<br />
129
+ Please enter the path to a chef repository (or leave blank):<br />
130
+ Creating initial API user...<br />
131
+ Created (or updated) client[username]<br />
132
+ Configuration file written to /home/username/.chef/knife.rb</p>
133
+
134
+ <p>This creates a new administrator client named <em>username</em>, writes
135
+ a configuration file to <em>/home/username/.chef/knife.rb</em>, and the
136
+ private key to <em>/home/username/.chef/username.pem</em>. The
137
+ configuration file and private key may be copied to another system
138
+ to facilitate administration of the Chef Server from a remote
139
+ system. Depending on the value given for the Chef Server URL, you
140
+ may need to modify that setting after copying to a remote host.</p></li>
141
+ </ul>
142
+
143
+
144
+ <h2 id="SEE-ALSO">SEE ALSO</h2>
145
+
146
+ <p> <strong>knife</strong>(1) <strong>knife-client</strong>(1)</p>
147
+
148
+ <h2 id="AUTHOR">AUTHOR</h2>
149
+
150
+ <p> Chef was written by Adam Jacob <a href="&#109;&#x61;&#x69;&#108;&#116;&#x6f;&#x3a;&#97;&#x64;&#x61;&#109;&#64;&#111;&#112;&#115;&#99;&#x6f;&#100;&#101;&#x2e;&#x63;&#x6f;&#109;" data-bare-link="true">&#97;&#100;&#97;&#109;&#64;&#111;&#x70;&#x73;&#99;&#111;&#100;&#101;&#46;&#x63;&#x6f;&#109;</a> with many contributions from the community.</p>
151
+
152
+ <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
153
+
154
+ <p> This manual page was written by Joshua Timberman <a href="&#109;&#97;&#x69;&#108;&#x74;&#x6f;&#58;&#x6a;&#111;&#x73;&#x68;&#117;&#97;&#64;&#111;&#x70;&#x73;&#x63;&#x6f;&#x64;&#x65;&#46;&#99;&#x6f;&#109;" data-bare-link="true">&#x6a;&#x6f;&#x73;&#104;&#x75;&#x61;&#x40;&#x6f;&#112;&#x73;&#99;&#x6f;&#100;&#101;&#46;&#x63;&#x6f;&#109;</a>.
155
+ Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
156
+
157
+ <h2 id="CHEF">CHEF</h2>
158
+
159
+ <p> Knife is distributed with Chef. <a href="http://wiki.opscode.com/display/chef/Home" data-bare-link="true">http://wiki.opscode.com/display/chef/Home</a></p>
160
+
161
+
162
+ <ol class='man-decor man-foot man foot'>
163
+ <li class='tl'>Chef 0.10.8</li>
164
+ <li class='tc'>December 2011</li>
165
+ <li class='tr'>knife-configure(1)</li>
166
+ </ol>
167
+
168
+ </div>
169
+ </body>
170
+ </html>
data/distro/common/html/knife-cookbook-site.1.html ADDED
@@ -0,0 +1,241 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta http-equiv='content-type' value='text/html;charset=utf8'>
5
+ <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
6
+ <title>knife-cookbook-site(1) - Install and update open source cookbooks</title>
7
+ <style type='text/css' media='all'>
8
+ /* style: man */
9
+ body#manpage {margin:0}
10
+ .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
11
+ .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
12
+ .mp h2 {margin:10px 0 0 0}
13
+ .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
14
+ .mp h3 {margin:0 0 0 4ex}
15
+ .mp dt {margin:0;clear:left}
16
+ .mp dt.flush {float:left;width:8ex}
17
+ .mp dd {margin:0 0 0 9ex}
18
+ .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
19
+ .mp pre {margin-bottom:20px}
20
+ .mp pre+h2,.mp pre+h3 {margin-top:22px}
21
+ .mp h2+pre,.mp h3+pre {margin-top:5px}
22
+ .mp img {display:block;margin:auto}
23
+ .mp h1.man-title {display:none}
24
+ .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
25
+ .mp h2 {font-size:16px;line-height:1.25}
26
+ .mp h1 {font-size:20px;line-height:2}
27
+ .mp {text-align:justify;background:#fff}
28
+ .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
29
+ .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
30
+ .mp u {text-decoration:underline}
31
+ .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
32
+ .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
33
+ .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
34
+ .mp b.man-ref {font-weight:normal;color:#434241}
35
+ .mp pre {padding:0 4ex}
36
+ .mp pre code {font-weight:normal;color:#434241}
37
+ .mp h2+pre,h3+pre {padding-left:0}
38
+ ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
39
+ ol.man-decor {width:100%}
40
+ ol.man-decor li.tl {text-align:left}
41
+ ol.man-decor li.tc {text-align:center;letter-spacing:4px}
42
+ ol.man-decor li.tr {text-align:right;float:right}
43
+ </style>
44
+ <style type='text/css' media='all'>
45
+ /* style: toc */
46
+ .man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
47
+ .man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
48
+ .man-navigation a:hover {color:#111;text-decoration:underline}
49
+ </style>
50
+ </head>
51
+ <!--
52
+ The following styles are deprecated and will be removed at some point:
53
+ div#man, div#man ol.man, div#man ol.head, div#man ol.man.
54
+
55
+ The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
56
+ .man-navigation should be used instead.
57
+ -->
58
+ <body id='manpage'>
59
+ <div class='mp' id='man'>
60
+
61
+ <div class='man-navigation' style='display:none'>
62
+ <a href="#NAME">NAME</a>
63
+ <a href="#SYNOPSIS">SYNOPSIS</a>
64
+ <a href="#COOKBOOK-SITE-SUB-COMMANDS">COOKBOOK SITE SUB-COMMANDS</a>
65
+ <a href="#INSTALL">INSTALL</a>
66
+ <a href="#DOWNLOAD">DOWNLOAD</a>
67
+ <a href="#LIST">LIST</a>
68
+ <a href="#SEARCH">SEARCH</a>
69
+ <a href="#SHARE">SHARE</a>
70
+ <a href="#UNSHARE">UNSHARE</a>
71
+ <a href="#SHOW">SHOW</a>
72
+ <a href="#DESCRIPTION">DESCRIPTION</a>
73
+ <a href="#EXAMPLES">EXAMPLES</a>
74
+ <a href="#SEE-ALSO">SEE ALSO</a>
75
+ <a href="#AUTHOR">AUTHOR</a>
76
+ <a href="#DOCUMENTATION">DOCUMENTATION</a>
77
+ <a href="#CHEF">CHEF</a>
78
+ </div>
79
+
80
+ <ol class='man-decor man-head man head'>
81
+ <li class='tl'>knife-cookbook-site(1)</li>
82
+ <li class='tc'>Chef Manual</li>
83
+ <li class='tr'>knife-cookbook-site(1)</li>
84
+ </ol>
85
+
86
+ <h2 id="NAME">NAME</h2>
87
+ <p class="man-name">
88
+ <code>knife-cookbook-site</code> - <span class="man-whatis">Install and update open source cookbooks</span>
89
+ </p>
90
+
91
+ <h2 id="SYNOPSIS">SYNOPSIS</h2>
92
+
93
+ <p><strong>knife</strong> <strong>cookbook site</strong> <em>sub-command</em> <em>(options)</em></p>
94
+
95
+ <h2 id="COOKBOOK-SITE-SUB-COMMANDS">COOKBOOK SITE SUB-COMMANDS</h2>
96
+
97
+ <p><code>knife cookbook site</code> provides the following subcommands:</p>
98
+
99
+ <h2 id="INSTALL">INSTALL</h2>
100
+
101
+ <p><strong>cookbook site install COOKBOOK [VERSION]</strong> <em>(options)</em></p>
102
+
103
+ <dl>
104
+ <dt><code>-D</code>, <code>--no-dependencies</code></dt><dd>Do not install dependencies automatically</dd>
105
+ <dt><code>-o</code>, <code>--cookbook-path PATH</code></dt><dd>Install cookbooks to PATH</dd>
106
+ <dt><code>-B</code>, <code>--branch BRANCH</code></dt><dd>Default branch to work with [defaults to master]</dd>
107
+ </dl>
108
+
109
+
110
+ <p>Uses <span class="man-ref">git<span class="s">(1)</span></span> version control in conjunction with the cookbook site to
111
+ install community contributed cookbooks to your local cookbook
112
+ repository. Running <code>knife cookbook site install</code> does the following:</p>
113
+
114
+ <ol>
115
+ <li>A new "pristine copy" branch is created in git for tracking the
116
+ upstream;</li>
117
+ <li>All existing cookbooks are removed from the branch;</li>
118
+ <li>The cookbook is downloaded from the cookbook site in tarball form;</li>
119
+ <li>The downloaded cookbook is untarred, and its contents commited via git;</li>
120
+ <li>The pristine copy branch is merged into the master branch.</li>
121
+ </ol>
122
+
123
+
124
+ <p>By installing cookbook with this process, you can locally modify the
125
+ upstream cookbook in your master branch and let git maintain your
126
+ changes as a separate patch. When an updated upstream version becomes
127
+ available, you will be able to merge the upstream changes while
128
+ maintaining your local modifications.</p>
129
+
130
+ <p>Unless <em>-D</em> is specified, the process is applied recursively to all the
131
+ cookbooks <em>COOKBOOK</em> depends on (via metadata <em>dependencies</em>).</p>
132
+
133
+ <h2 id="DOWNLOAD">DOWNLOAD</h2>
134
+
135
+ <p><strong>knife cookbook site download COOKBOOK [VERSION]</strong> <em>(options)</em></p>
136
+
137
+ <dl>
138
+ <dt><code>-f</code>, <code>--file FILE</code></dt><dd>The filename to write to</dd>
139
+ <dt class="flush"><code>--force</code></dt><dd>Force download deprecated cookbook</dd>
140
+ </dl>
141
+
142
+
143
+ <p>Downloads a specific cookbook from the Community site, optionally
144
+ specifying a certain version.</p>
145
+
146
+ <h2 id="LIST">LIST</h2>
147
+
148
+ <p><strong>knife cookbook site list</strong> <em>(options)</em></p>
149
+
150
+ <dl>
151
+ <dt><code>-w</code>, <code>--with-uri</code></dt><dd>Show corresponding URIs</dd>
152
+ </dl>
153
+
154
+
155
+ <p>Lists available cookbooks from the Community site.</p>
156
+
157
+ <h2 id="SEARCH">SEARCH</h2>
158
+
159
+ <p><strong>knife cookbook site search QUERY</strong> <em>(options)</em></p>
160
+
161
+ <p>Searches for available cookbooks matching the specified query.</p>
162
+
163
+ <h2 id="SHARE">SHARE</h2>
164
+
165
+ <p><strong>knife cookbook site share COOKBOOK CATEGORY</strong> <em>(options)</em></p>
166
+
167
+ <dl>
168
+ <dt><code>-k</code>, <code>--key KEY</code></dt><dd>API Client Key</dd>
169
+ <dt><code>-u</code>, <code>--user USER</code></dt><dd>API Client Username</dd>
170
+ <dt><code>-o</code>, <code>--cookbook-path PATH:PATH</code></dt><dd>A colon-separated path to look for cookbooks in</dd>
171
+ </dl>
172
+
173
+
174
+ <p>Uploads the specified cookbook using the given category to the Opscode
175
+ cookbooks site. Requires a login user and certificate for the Opscode
176
+ Cookbooks site. By default, knife will use the username and API key
177
+ you've configured in your configuration file; otherwise you must
178
+ explicitly set these values on the command line or use an alternate
179
+ configuration file.</p>
180
+
181
+ <h2 id="UNSHARE">UNSHARE</h2>
182
+
183
+ <p><strong>knife cookbook site unshare COOKBOOK</strong></p>
184
+
185
+ <p>Stops sharing the specified cookbook on the Opscode cookbooks site.</p>
186
+
187
+ <h2 id="SHOW">SHOW</h2>
188
+
189
+ <p><strong>knife cookbook site show COOKBOOK [VERSION]</strong> <em>(options)</em></p>
190
+
191
+ <p>Shows information from the site about a particular cookbook.</p>
192
+
193
+ <h2 id="DESCRIPTION">DESCRIPTION</h2>
194
+
195
+ <p>The cookbook site, <a href="http://community.opscode.com/" data-bare-link="true">http://community.opscode.com/</a>, is a cookbook
196
+ distribution service operated by Opscode. This service provides users
197
+ with a central location to publish cookbooks for sharing with other
198
+ community members.</p>
199
+
200
+ <p><code>knife cookbook site</code> commands provide an interface to the cookbook
201
+ site's HTTP API. For commands that read data from the API, no account is
202
+ required. In order to upload cookbooks using the <code>knife cookbook site
203
+ share</code> command, you must create an account on the cookbook site and
204
+ configure your credentials via command line option or in your knife
205
+ configuration file.</p>
206
+
207
+ <h2 id="EXAMPLES">EXAMPLES</h2>
208
+
209
+ <p>Uploading cookbooks to the Opscode cookbooks site:</p>
210
+
211
+ <pre><code>knife cookbook site share example Other -k ~/.chef/USERNAME.pem -u USERNAME
212
+ </code></pre>
213
+
214
+ <h2 id="SEE-ALSO">SEE ALSO</h2>
215
+
216
+ <p> <strong><span class="man-ref">knife-cookbook<span class="s">(1)</span></span></strong>
217
+ <a href="http://community.opscode.com/cookbooks" data-bare-link="true">http://community.opscode.com/cookbooks</a></p>
218
+
219
+ <h2 id="AUTHOR">AUTHOR</h2>
220
+
221
+ <p> Chef was written by Adam Jacob <a href="&#x6d;&#97;&#105;&#x6c;&#116;&#x6f;&#58;&#97;&#100;&#x61;&#x6d;&#64;&#111;&#112;&#x73;&#99;&#111;&#x64;&#x65;&#x2e;&#x63;&#111;&#109;" data-bare-link="true">&#97;&#x64;&#97;&#109;&#x40;&#111;&#112;&#x73;&#x63;&#x6f;&#x64;&#101;&#x2e;&#99;&#x6f;&#x6d;</a> with many contributions from the community.</p>
222
+
223
+ <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
224
+
225
+ <p> This manual page was written by Joshua Timberman <a href="&#109;&#97;&#x69;&#x6c;&#x74;&#x6f;&#58;&#x6a;&#111;&#115;&#x68;&#x75;&#x61;&#x40;&#111;&#x70;&#115;&#99;&#x6f;&#x64;&#101;&#x2e;&#99;&#111;&#109;" data-bare-link="true">&#x6a;&#111;&#x73;&#x68;&#x75;&#x61;&#64;&#111;&#112;&#x73;&#x63;&#x6f;&#x64;&#101;&#x2e;&#x63;&#x6f;&#x6d;</a>.
226
+ Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
227
+
228
+ <h2 id="CHEF">CHEF</h2>
229
+
230
+ <p> Knife is distributed with Chef. <a href="http://wiki.opscode.com/display/chef/Home" data-bare-link="true">http://wiki.opscode.com/display/chef/Home</a></p>
231
+
232
+
233
+ <ol class='man-decor man-foot man foot'>
234
+ <li class='tl'>Chef 0.10.8</li>
235
+ <li class='tc'>December 2011</li>
236
+ <li class='tr'>knife-cookbook-site(1)</li>
237
+ </ol>
238
+
239
+ </div>
240
+ </body>
241
+ </html>
data/distro/common/html/knife-cookbook.1.html ADDED
@@ -0,0 +1,384 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta http-equiv='content-type' value='text/html;charset=utf8'>
5
+ <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
6
+ <title>knife-cookbook(1) - upload and manage chef cookbooks</title>
7
+ <style type='text/css' media='all'>
8
+ /* style: man */
9
+ body#manpage {margin:0}
10
+ .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
11
+ .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
12
+ .mp h2 {margin:10px 0 0 0}
13
+ .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
14
+ .mp h3 {margin:0 0 0 4ex}
15
+ .mp dt {margin:0;clear:left}
16
+ .mp dt.flush {float:left;width:8ex}
17
+ .mp dd {margin:0 0 0 9ex}
18
+ .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
19
+ .mp pre {margin-bottom:20px}
20
+ .mp pre+h2,.mp pre+h3 {margin-top:22px}
21
+ .mp h2+pre,.mp h3+pre {margin-top:5px}
22
+ .mp img {display:block;margin:auto}
23
+ .mp h1.man-title {display:none}
24
+ .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
25
+ .mp h2 {font-size:16px;line-height:1.25}
26
+ .mp h1 {font-size:20px;line-height:2}
27
+ .mp {text-align:justify;background:#fff}
28
+ .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
29
+ .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
30
+ .mp u {text-decoration:underline}
31
+ .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
32
+ .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
33
+ .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
34
+ .mp b.man-ref {font-weight:normal;color:#434241}
35
+ .mp pre {padding:0 4ex}
36
+ .mp pre code {font-weight:normal;color:#434241}
37
+ .mp h2+pre,h3+pre {padding-left:0}
38
+ ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
39
+ ol.man-decor {width:100%}
40
+ ol.man-decor li.tl {text-align:left}
41
+ ol.man-decor li.tc {text-align:center;letter-spacing:4px}
42
+ ol.man-decor li.tr {text-align:right;float:right}
43
+ </style>
44
+ <style type='text/css' media='all'>
45
+ /* style: toc */
46
+ .man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
47
+ .man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
48
+ .man-navigation a:hover {color:#111;text-decoration:underline}
49
+ </style>
50
+ </head>
51
+ <!--
52
+ The following styles are deprecated and will be removed at some point:
53
+ div#man, div#man ol.man, div#man ol.head, div#man ol.man.
54
+
55
+ The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
56
+ .man-navigation should be used instead.
57
+ -->
58
+ <body id='manpage'>
59
+ <div class='mp' id='man'>
60
+
61
+ <div class='man-navigation' style='display:none'>
62
+ <a href="#NAME">NAME</a>
63
+ <a href="#SYNOPSIS">SYNOPSIS</a>
64
+ <a href="#SUB-COMMANDS">SUB-COMMANDS</a>
65
+ <a href="#LIST">LIST</a>
66
+ <a href="#SHOW">SHOW</a>
67
+ <a href="#UPLOAD">UPLOAD</a>
68
+ <a href="#DOWNLOAD">DOWNLOAD</a>
69
+ <a href="#DELETE">DELETE</a>
70
+ <a href="#BULK-DELETE">BULK DELETE</a>
71
+ <a href="#COOKBOOK-CREATE">COOKBOOK CREATE</a>
72
+ <a href="#METADATA">METADATA</a>
73
+ <a href="#METADATA-FROM-FILE">METADATA FROM FILE</a>
74
+ <a href="#TEST">TEST</a>
75
+ <a href="#RECIPE-LIST">RECIPE LIST</a>
76
+ <a href="#DESCRIPTION">DESCRIPTION</a>
77
+ <a href="#SEE-ALSO">SEE ALSO</a>
78
+ <a href="#AUTHOR">AUTHOR</a>
79
+ <a href="#DOCUMENTATION">DOCUMENTATION</a>
80
+ <a href="#CHEF">CHEF</a>
81
+ </div>
82
+
83
+ <ol class='man-decor man-head man head'>
84
+ <li class='tl'>knife-cookbook(1)</li>
85
+ <li class='tc'>Chef Manual</li>
86
+ <li class='tr'>knife-cookbook(1)</li>
87
+ </ol>
88
+
89
+ <h2 id="NAME">NAME</h2>
90
+ <p class="man-name">
91
+ <code>knife-cookbook</code> - <span class="man-whatis">upload and manage chef cookbooks</span>
92
+ </p>
93
+
94
+ <h2 id="SYNOPSIS">SYNOPSIS</h2>
95
+
96
+ <p><strong>knife</strong> <strong>cookbook</strong> <em>sub-command</em> <em>(options)</em></p>
97
+
98
+ <h2 id="SUB-COMMANDS">SUB-COMMANDS</h2>
99
+
100
+ <p><code>knife cookbook</code> supports the following sub commands:</p>
101
+
102
+ <h2 id="LIST">LIST</h2>
103
+
104
+ <p><strong>knife cookbook list</strong> <em>(options)</em></p>
105
+
106
+ <dl>
107
+ <dt><code>-a</code>, <code>--all</code></dt><dd>show all versions of a cookbook instead of just the most recent</dd>
108
+ <dt><code>-w</code>, <code>--with-uri</code></dt><dd>show corresponding uris</dd>
109
+ </dl>
110
+
111
+
112
+ <p>Lists the cookbooks available on the Chef server.</p>
113
+
114
+ <h2 id="SHOW">SHOW</h2>
115
+
116
+ <p><strong>knife cookbook show cookbook [version] [part] [filename]</strong> <em>(options)</em></p>
117
+
118
+ <dl>
119
+ <dt><code>-f</code>, <code>--fqdn fqdn </code></dt><dd>the fqdn of the host to see the file for</dd>
120
+ <dt><code>-p</code>, <code>--platform platform </code></dt><dd>the platform to see the file for</dd>
121
+ <dt><code>-v</code>, <code>--platform-version version</code></dt><dd>the platform version to see the file for</dd>
122
+ <dt><code>-w</code>, <code>--with-uri</code></dt><dd>Show corresponding URIs</dd>
123
+ </dl>
124
+
125
+
126
+ <p>show a particular part of a <em>cookbook</em> for the specified <em>version</em>. <em>part</em> can be one of:</p>
127
+
128
+ <ul>
129
+ <li><em>attributes</em></li>
130
+ <li><em>definitions</em></li>
131
+ <li><em>files</em></li>
132
+ <li><em>libraries</em></li>
133
+ <li><em>providers</em></li>
134
+ <li><em>recipes</em></li>
135
+ <li><em>resources</em></li>
136
+ <li><em>templates</em></li>
137
+ </ul>
138
+
139
+
140
+ <h2 id="UPLOAD">UPLOAD</h2>
141
+
142
+ <p><strong>knife cookbook upload [cookbooks...]</strong> <em>(options)</em></p>
143
+
144
+ <dl>
145
+ <dt><code>-a</code>, <code>--all</code></dt><dd>upload all cookbooks, rather than just a single cookbook</dd>
146
+ <dt><code>-o</code>, <code>--cookbook-path path:path</code></dt><dd>a colon-separated path to look for cookbooks in</dd>
147
+ <dt><code>-d</code>, <code>--upload-dependencies</code></dt><dd>Uploads additional cookbooks that this cookbook lists in as
148
+ dependencies in its metadata.</dd>
149
+ <dt><code>-E</code>, <code>--environment ENVIRONMENT</code></dt><dd>An <em>ENVIRONMENT</em> to apply the uploaded cookbooks to. Specifying this
150
+ option will cause knife to edit the <em>ENVIRONMENT</em> to place a strict
151
+ version constraint on the cookbook version(s) uploaded.</dd>
152
+ <dt><code>--freeze</code></dt><dd>Sets the frozen flag on the uploaded cookbook(s) Any future attempt
153
+ to modify the cookbook without changing the version number will
154
+ return an error unless --force is specified.</dd>
155
+ <dt class="flush"><code>--force</code></dt><dd>Overrides the frozen flag on a cookbook, allowing you to overwrite a
156
+ cookbook version that has previously been uploaded with the --freeze
157
+ option.</dd>
158
+ </dl>
159
+
160
+
161
+ <p>Uploads one or more cookbooks from your local cookbook repository(ies)
162
+ to the Chef Server. Only files that don't yet exist on the server will
163
+ be uploaded.</p>
164
+
165
+ <p>As the command parses the name args as 1..n cookbook names:</p>
166
+
167
+ <pre><code>`knife cookbook upload COOKBOOK COOKBOOK ...`
168
+ </code></pre>
169
+
170
+ <p>works for one to many cookbooks.</p>
171
+
172
+ <h2 id="DOWNLOAD">DOWNLOAD</h2>
173
+
174
+ <p><strong>knife cookbook download cookbook [version]</strong> <em>(options)</em></p>
175
+
176
+ <dl>
177
+ <dt><code>-d</code>, <code>--dir download_directory</code></dt><dd>the directory to download the cookbook into</dd>
178
+ <dt><code>-f</code>, <code>--force</code></dt><dd>overwrite an existing directory with the download</dd>
179
+ <dt><code>-n</code>, <code>--latest</code></dt><dd>download the latest version of the cookbook</dd>
180
+ </dl>
181
+
182
+
183
+ <p>download a cookbook from the chef server. if no version is specified and
184
+ only one version exists on the server, that version will be downloaded.
185
+ if no version is specified and multiple versions are available on the
186
+ server, you will be prompted for a version to download.</p>
187
+
188
+ <h2 id="DELETE">DELETE</h2>
189
+
190
+ <p><strong>knife cookbook delete cookbook [version]</strong> <em>(options)</em></p>
191
+
192
+ <dl>
193
+ <dt><code>-a</code>, <code>--all</code></dt><dd>delete all versions</dd>
194
+ <dt><code>-p</code>, <code>--purge</code></dt><dd>purge files from backing store. this will disable any cookbook that contains any of the same files as the cookbook being purged.</dd>
195
+ </dl>
196
+
197
+
198
+ <p>delete the specified <em>version</em> of the named <em>cookbook</em>. if no version is
199
+ specified, and only one version exists on the server, that version will
200
+ be deleted. if multiple versions are available on the server, you will
201
+ be prompted for a version to delete.</p>
202
+
203
+ <h2 id="BULK-DELETE">BULK DELETE</h2>
204
+
205
+ <p><strong>knife cookbook bulk delete regex</strong> <em>(options)</em></p>
206
+
207
+ <dl>
208
+ <dt><code>-p</code>, <code>--purge</code></dt><dd>purge files from backing store. this will disable any cookbook that
209
+ contains any of the same files as the cookbook being purged.</dd>
210
+ </dl>
211
+
212
+
213
+ <p>delete cookbooks on the chef server based on a regular expression. the
214
+ regular expression (<em>regex</em>) should be in quotes, not in //'s.</p>
215
+
216
+ <h2 id="COOKBOOK-CREATE">COOKBOOK CREATE</h2>
217
+
218
+ <p><strong>knife cookbook create cookbook</strong> <em>(options)</em></p>
219
+
220
+ <dl>
221
+ <dt><code>-o</code>, <code>--cookbook-path path</code></dt><dd>the directory where the cookbook will be created</dd>
222
+ <dt><code>-r</code>, <code>--readme-format format</code></dt><dd>format of the readme file md, mkd, txt, rdoc</dd>
223
+ <dt><code>-c</code>, <code>--copyright copyright</code></dt><dd>name of copyright holder</dd>
224
+ <dt><code>-i</code>, <code>--license license</code></dt><dd>license for cookbook, apachev2 or none</dd>
225
+ <dt><code>-e</code>, <code>--email email</code></dt><dd>email address of cookbook maintainer</dd>
226
+ </dl>
227
+
228
+
229
+ <p>this is a helper command that creates a new cookbook directory in the
230
+ <code>cookbook_path</code>. the following directories and files are created for the
231
+ named cookbook.</p>
232
+
233
+ <ul>
234
+ <li>cookbook/attributes</li>
235
+ <li>cookbook/definitions</li>
236
+ <li>cookbook/files/default</li>
237
+ <li>cookbook/libraries</li>
238
+ <li>cookbook/metadata.rb</li>
239
+ <li>cookbook/providers</li>
240
+ <li>cookbook/readme.md</li>
241
+ <li>cookbook/recipes/default.rb</li>
242
+ <li>cookbook/resources</li>
243
+ <li>cookbook/templates/default</li>
244
+ </ul>
245
+
246
+
247
+ <p>supported readme formats are 'md' (default), 'mkd', 'txt', 'rdoc'. the
248
+ readme file will be written with the specified extension and a set of
249
+ helpful starting headers.</p>
250
+
251
+ <p>specify <code>-c</code> or <code>--copyright</code> with the name of the copyright holder as
252
+ your name or your company/organization name in a quoted string. if this
253
+ value is not specified an all-caps string <code>your_company_name</code> is used
254
+ which can be easily changed with find/replace.</p>
255
+
256
+ <p>specify <code>-i</code> or <code>--license</code> with the license that the cookbook is
257
+ distributed under for sharing with other people or posting to the
258
+ opscode cookbooks site. be aware of the licenses of files you put inside
259
+ the cookbook and follow any restrictions they describe. when using
260
+ <code>none</code> (default) or <code>apachev2</code>, comment header text and metadata file
261
+ are pre-filled. the <code>none</code> license will be treated as
262
+ non-redistributable.</p>
263
+
264
+ <p>specify <code>-e</code> or <code>--email</code> with the email address of the cookbook's
265
+ maintainer. if this value is not specified, an all-caps string
266
+ <code>your_email</code> is used which can easily be changed with find/replace.</p>
267
+
268
+ <p>the cookbook copyright, license, email and readme_format settings can be filled in the
269
+ <code>knife.rb</code>, for example with default values:</p>
270
+
271
+ <pre><code>cookbook_copyright "your_company_name"
272
+ cookbook_license "none"
273
+ cookbook_email "your_email"
274
+ readme_format "md"
275
+ </code></pre>
276
+
277
+ <h2 id="METADATA">METADATA</h2>
278
+
279
+ <p><strong>knife cookbook metadata cookbook</strong> <em>(options)</em></p>
280
+
281
+ <dl>
282
+ <dt><code>-a</code>, <code>--all</code></dt><dd>generate metadata for all cookbooks, rather than just a single cookbook</dd>
283
+ <dt><code>-o</code>, <code>--cookbook-path path:path</code></dt><dd>a colon-separated path to look for cookbooks in</dd>
284
+ </dl>
285
+
286
+
287
+ <p>generate cookbook metadata for the named <em>cookbook</em>. the <em>path</em> used here specifies where the cookbooks directory is located and corresponds to the <code>cookbook_path</code> configuration option.</p>
288
+
289
+ <h2 id="METADATA-FROM-FILE">METADATA FROM FILE</h2>
290
+
291
+ <p><strong>knife cookbook metadata from file</strong> <em>(options)</em></p>
292
+
293
+ <p>load the cookbook metadata from a specified file.</p>
294
+
295
+ <h2 id="TEST">TEST</h2>
296
+
297
+ <p><strong>knife cookbook test [cookbooks...]</strong> <em>(options)</em></p>
298
+
299
+ <dl>
300
+ <dt><code>-a</code>, <code>--all</code></dt><dd>test all cookbooks, rather than just a single cookbook</dd>
301
+ <dt><code>-o</code>, <code>--cookbook-path path:path</code></dt><dd>a colon-separated path to look for cookbooks in</dd>
302
+ </dl>
303
+
304
+
305
+ <p>test the specified cookbooks for syntax errors. this uses the built-in
306
+ ruby syntax checking option for files in the cookbook ending in <code>.rb</code>,
307
+ and the erb syntax check for files ending in <code>.erb</code> (templates).</p>
308
+
309
+ <h2 id="RECIPE-LIST">RECIPE LIST</h2>
310
+
311
+ <p><strong>knife recipe list [PATTERN]</strong></p>
312
+
313
+ <p>List available recipes from the server. Specify <em>PATTERN</em> as a regular
314
+ expression to limit the results.</p>
315
+
316
+ <h2 id="DESCRIPTION">DESCRIPTION</h2>
317
+
318
+ <p>Cookbooks are the fundamental unit of distribution in Chef. They
319
+ encapsulate all recipes of resources and assets used to configure a
320
+ particular aspect of the infrastructure. The following sub-commands can
321
+ be used to manipulate the cookbooks stored on the Chef Server.</p>
322
+
323
+ <p>On disk, cookbooks are directories with a defined structure. The
324
+ following directories may appear within a cookbook:</p>
325
+
326
+ <dl>
327
+ <dt>COOKBOOK/attributes/</dt><dd>Ruby files that define default parameters to be used in recipes</dd>
328
+ <dt>COOKBOOK/definitions/</dt><dd>Ruby files that contain <em>resource definitions</em></dd>
329
+ <dt>COOKBOOK/files/SPECIFICITY</dt><dd>Files of arbitrary type. These files may be downloaded by
330
+ <span class="man-ref">chef-client<span class="s">(8)</span></span> when configuring a host.</dd>
331
+ <dt>COOKBOOK/libraries/</dt><dd>Ruby files that contain library code needed for recipes</dd>
332
+ <dt>COOKBOOK/providers/</dt><dd>Ruby files that contain Lightweight Provider definitions</dd>
333
+ <dt>COOKBOOK/recipes/</dt><dd>Ruby files that use Chef's recipe DSL to describe the desired
334
+ configuration of a system</dd>
335
+ <dt>COOKBOOK/resources/</dt><dd>Ruby files that contain Lightweight Resource definitions</dd>
336
+ <dt>COOKBOOK/templates/SPECIFICITY</dt><dd>ERuby (ERb) template files. These are referenced by <em>recipes</em> and
337
+ evaluated to dynamically generate configuration files.</dd>
338
+ </dl>
339
+
340
+
341
+ <p><strong>SPECIFICITY</strong> is a feature of <em>files</em> and <em>templates</em> that allow you
342
+ to specify alternate files to be used on a specific OS platform or host.
343
+ The default specificity setting is <em>default</em>, that is files in
344
+ <code>COOKBOOK/files/default</code> will be used when a more specific copy is not
345
+ available. Further documentation for this feature is available on the
346
+ Chef wiki: <a href="http://wiki.opscode.com/display/chef/File+Distribution#FileDistribution-FileSpecificity" data-bare-link="true">http://wiki.opscode.com/display/chef/File+Distribution#FileDistribution-FileSpecificity</a></p>
347
+
348
+ <p>Cookbooks also contain a metadata file that defines various properties
349
+ of the cookbook. The most important of these are the <em>version</em> and the
350
+ <em>dependencies</em>. The <em>version</em> is used in combination with environments
351
+ to select which copy of a given cookbook is distributed to a node. The
352
+ <em>dependencies</em> are used by the server to determine which additional
353
+ cookbooks must be distributed to a given host when it requires a
354
+ cookbook.</p>
355
+
356
+ <h2 id="SEE-ALSO">SEE ALSO</h2>
357
+
358
+ <p> <strong><span class="man-ref">knife-environment<span class="s">(1)</span></span></strong> <strong><span class="man-ref">knife-cookbook-site<span class="s">(1)</span></span></strong>
359
+ <a href="http://wiki.opscode.com/display/chef/Cookbooks" data-bare-link="true">http://wiki.opscode.com/display/chef/Cookbooks</a>
360
+ <a href="http://wiki.opscode.com/display/chef/Metadata" data-bare-link="true">http://wiki.opscode.com/display/chef/Metadata</a></p>
361
+
362
+ <h2 id="AUTHOR">AUTHOR</h2>
363
+
364
+ <p> Chef was written by Adam Jacob <a href="&#x6d;&#x61;&#105;&#x6c;&#x74;&#x6f;&#x3a;&#x61;&#x64;&#x61;&#109;&#64;&#111;&#112;&#115;&#x63;&#111;&#x64;&#x65;&#x2e;&#x63;&#x6f;&#109;" data-bare-link="true">&#x61;&#100;&#x61;&#109;&#64;&#111;&#x70;&#x73;&#x63;&#111;&#x64;&#101;&#x2e;&#99;&#x6f;&#109;</a> with many contributions from the community.</p>
365
+
366
+ <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
367
+
368
+ <p> This manual page was written by Joshua Timberman <a href="&#x6d;&#x61;&#x69;&#x6c;&#x74;&#x6f;&#x3a;&#106;&#111;&#x73;&#104;&#x75;&#97;&#x40;&#x6f;&#x70;&#x73;&#x63;&#x6f;&#x64;&#x65;&#46;&#99;&#111;&#109;" data-bare-link="true">&#106;&#111;&#115;&#104;&#x75;&#97;&#64;&#111;&#x70;&#x73;&#x63;&#x6f;&#x64;&#101;&#x2e;&#99;&#111;&#109;</a>.
369
+ Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
370
+
371
+ <h2 id="CHEF">CHEF</h2>
372
+
373
+ <p> Knife is distributed with Chef. <a href="http://wiki.opscode.com/display/chef/Home" data-bare-link="true">http://wiki.opscode.com/display/chef/Home</a></p>
374
+
375
+
376
+ <ol class='man-decor man-foot man foot'>
377
+ <li class='tl'>Chef 0.10.8</li>
378
+ <li class='tc'>December 2011</li>
379
+ <li class='tr'>knife-cookbook(1)</li>
380
+ </ol>
381
+
382
+ </div>
383
+ </body>
384
+ </html>