chef-dk 2.6.2 → 3.0.36

Sign up to get free protection for your applications and to get access to all the features.
Files changed (377) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +126 -121
  3. data/Gemfile.lock +812 -807
  4. data/LICENSE +201 -201
  5. data/README.md +333 -333
  6. data/Rakefile +74 -74
  7. data/acceptance/.shared/kitchen_acceptance/.kitchen.digitalocean.yml +27 -27
  8. data/acceptance/.shared/kitchen_acceptance/.kitchen.ec2.yml +287 -287
  9. data/acceptance/.shared/kitchen_acceptance/.kitchen.vagrant.yml +52 -52
  10. data/acceptance/.shared/kitchen_acceptance/libraries/kitchen.rb +51 -51
  11. data/acceptance/.shared/kitchen_acceptance/metadata.rb +1 -1
  12. data/acceptance/Gemfile +21 -21
  13. data/acceptance/Gemfile.lock +334 -334
  14. data/acceptance/README.md +132 -132
  15. data/acceptance/trivial/.acceptance/acceptance-cookbook/.gitignore +2 -2
  16. data/acceptance/trivial/.acceptance/acceptance-cookbook/metadata.rb +2 -2
  17. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/destroy.rb +1 -1
  18. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/provision.rb +1 -1
  19. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/verify.rb +1 -1
  20. data/acceptance/trivial/.kitchen.yml +7 -7
  21. data/acceptance/trivial/test/integration/chefdk-current-install/inspec/chef_client_spec.rb +5 -5
  22. data/bin/chef +25 -25
  23. data/chef-dk.gemspec +60 -60
  24. data/lib/chef-dk.rb +19 -19
  25. data/lib/chef-dk/authenticated_http.rb +22 -22
  26. data/lib/chef-dk/builtin_commands.rb +59 -59
  27. data/lib/chef-dk/chef_runner.rb +114 -114
  28. data/lib/chef-dk/chef_server_api_multi.rb +73 -73
  29. data/lib/chef-dk/cli.rb +201 -201
  30. data/lib/chef-dk/command/base.rb +79 -79
  31. data/lib/chef-dk/command/clean_policy_cookbooks.rb +114 -114
  32. data/lib/chef-dk/command/clean_policy_revisions.rb +111 -111
  33. data/lib/chef-dk/command/delete_policy.rb +120 -120
  34. data/lib/chef-dk/command/delete_policy_group.rb +120 -120
  35. data/lib/chef-dk/command/diff.rb +315 -315
  36. data/lib/chef-dk/command/env.rb +89 -89
  37. data/lib/chef-dk/command/exec.rb +44 -44
  38. data/lib/chef-dk/command/export.rb +155 -155
  39. data/lib/chef-dk/command/gem.rb +47 -47
  40. data/lib/chef-dk/command/generate.rb +125 -125
  41. data/lib/chef-dk/command/generator_commands.rb +83 -83
  42. data/lib/chef-dk/command/generator_commands/app.rb +106 -106
  43. data/lib/chef-dk/command/generator_commands/attribute.rb +36 -36
  44. data/lib/chef-dk/command/generator_commands/base.rb +157 -157
  45. data/lib/chef-dk/command/generator_commands/build_cookbook.rb +125 -125
  46. data/lib/chef-dk/command/generator_commands/chef_exts/generator_desc_resource.rb +85 -85
  47. data/lib/chef-dk/command/generator_commands/chef_exts/quieter_doc_formatter.rb +38 -38
  48. data/lib/chef-dk/command/generator_commands/chef_exts/recipe_dsl_ext.rb +39 -39
  49. data/lib/chef-dk/command/generator_commands/cookbook.rb +241 -241
  50. data/lib/chef-dk/command/generator_commands/cookbook_code_file.rb +100 -100
  51. data/lib/chef-dk/command/generator_commands/cookbook_file.rb +45 -45
  52. data/lib/chef-dk/command/generator_commands/generator_generator.rb +174 -174
  53. data/lib/chef-dk/command/generator_commands/helpers.rb +36 -36
  54. data/lib/chef-dk/command/generator_commands/policyfile.rb +124 -126
  55. data/lib/chef-dk/command/generator_commands/recipe.rb +36 -36
  56. data/lib/chef-dk/command/generator_commands/repo.rb +123 -123
  57. data/lib/chef-dk/command/generator_commands/resource.rb +36 -36
  58. data/lib/chef-dk/command/generator_commands/template.rb +46 -46
  59. data/lib/chef-dk/command/install.rb +120 -120
  60. data/lib/chef-dk/command/provision.rb +436 -436
  61. data/lib/chef-dk/command/push.rb +117 -117
  62. data/lib/chef-dk/command/push_archive.rb +125 -125
  63. data/lib/chef-dk/command/shell_init.rb +179 -179
  64. data/lib/chef-dk/command/show_policy.rb +163 -163
  65. data/lib/chef-dk/command/undelete.rb +154 -154
  66. data/lib/chef-dk/command/update.rb +133 -133
  67. data/lib/chef-dk/command/verify.rb +629 -629
  68. data/lib/chef-dk/commands_map.rb +113 -113
  69. data/lib/chef-dk/completions/bash.sh.erb +5 -5
  70. data/lib/chef-dk/completions/chef.fish.erb +10 -10
  71. data/lib/chef-dk/completions/zsh.zsh.erb +21 -21
  72. data/lib/chef-dk/component_test.rb +227 -227
  73. data/lib/chef-dk/configurable.rb +88 -88
  74. data/lib/chef-dk/cookbook_metadata.rb +45 -45
  75. data/lib/chef-dk/cookbook_omnifetch.rb +32 -32
  76. data/lib/chef-dk/cookbook_profiler/git.rb +152 -151
  77. data/lib/chef-dk/cookbook_profiler/identifiers.rb +72 -72
  78. data/lib/chef-dk/cookbook_profiler/null_scm.rb +31 -31
  79. data/lib/chef-dk/exceptions.rb +151 -150
  80. data/lib/chef-dk/generator.rb +165 -165
  81. data/lib/chef-dk/helpers.rb +176 -176
  82. data/lib/chef-dk/pager.rb +104 -105
  83. data/lib/chef-dk/policyfile/artifactory_cookbook_source.rb +102 -102
  84. data/lib/chef-dk/policyfile/attribute_merge_checker.rb +110 -110
  85. data/lib/chef-dk/policyfile/chef_repo_cookbook_source.rb +138 -138
  86. data/lib/chef-dk/policyfile/chef_server_cookbook_source.rb +99 -99
  87. data/lib/chef-dk/policyfile/chef_server_lock_fetcher.rb +167 -164
  88. data/lib/chef-dk/policyfile/community_cookbook_source.rb +95 -95
  89. data/lib/chef-dk/policyfile/comparison_base.rb +123 -123
  90. data/lib/chef-dk/policyfile/cookbook_location_specification.rb +154 -154
  91. data/lib/chef-dk/policyfile/cookbook_locks.rb +466 -466
  92. data/lib/chef-dk/policyfile/cookbook_sources.rb +23 -23
  93. data/lib/chef-dk/policyfile/delivery_supermarket_source.rb +89 -89
  94. data/lib/chef-dk/policyfile/differ.rb +263 -263
  95. data/lib/chef-dk/policyfile/dsl.rb +288 -288
  96. data/lib/chef-dk/policyfile/git_lock_fetcher.rb +265 -0
  97. data/lib/chef-dk/policyfile/included_policies_cookbook_source.rb +156 -156
  98. data/lib/chef-dk/policyfile/lister.rb +229 -229
  99. data/lib/chef-dk/policyfile/local_lock_fetcher.rb +129 -123
  100. data/lib/chef-dk/policyfile/lock_applier.rb +80 -80
  101. data/lib/chef-dk/policyfile/null_cookbook_source.rb +49 -49
  102. data/lib/chef-dk/policyfile/policyfile_location_specification.rb +125 -122
  103. data/lib/chef-dk/policyfile/read_cookbook_for_compat_mode_upload.rb +124 -124
  104. data/lib/chef-dk/policyfile/reports/install.rb +69 -69
  105. data/lib/chef-dk/policyfile/reports/table_printer.rb +57 -57
  106. data/lib/chef-dk/policyfile/reports/upload.rb +70 -70
  107. data/lib/chef-dk/policyfile/solution_dependencies.rb +311 -312
  108. data/lib/chef-dk/policyfile/source_uri.rb +57 -57
  109. data/lib/chef-dk/policyfile/storage_config.rb +112 -102
  110. data/lib/chef-dk/policyfile/undo_record.rb +139 -139
  111. data/lib/chef-dk/policyfile/undo_stack.rb +128 -128
  112. data/lib/chef-dk/policyfile/uploader.rb +213 -213
  113. data/lib/chef-dk/policyfile_compiler.rb +528 -528
  114. data/lib/chef-dk/policyfile_lock.rb +581 -581
  115. data/lib/chef-dk/policyfile_services/clean_policies.rb +95 -95
  116. data/lib/chef-dk/policyfile_services/clean_policy_cookbooks.rb +123 -123
  117. data/lib/chef-dk/policyfile_services/export_repo.rb +419 -420
  118. data/lib/chef-dk/policyfile_services/install.rb +162 -162
  119. data/lib/chef-dk/policyfile_services/push.rb +112 -112
  120. data/lib/chef-dk/policyfile_services/push_archive.rb +164 -200
  121. data/lib/chef-dk/policyfile_services/rm_policy.rb +141 -141
  122. data/lib/chef-dk/policyfile_services/rm_policy_group.rb +85 -85
  123. data/lib/chef-dk/policyfile_services/show_policy.rb +234 -236
  124. data/lib/chef-dk/policyfile_services/undelete.rb +108 -108
  125. data/lib/chef-dk/policyfile_services/update_attributes.rb +110 -110
  126. data/lib/chef-dk/service_exception_inspectors.rb +24 -24
  127. data/lib/chef-dk/service_exception_inspectors/base.rb +39 -39
  128. data/lib/chef-dk/service_exception_inspectors/http.rb +119 -119
  129. data/lib/chef-dk/service_exceptions.rb +142 -142
  130. data/lib/chef-dk/shell_out.rb +36 -36
  131. data/lib/chef-dk/skeletons/code_generator/files/default/Berksfile +4 -4
  132. data/lib/chef-dk/skeletons/code_generator/files/default/build_cookbook/.kitchen.yml +21 -21
  133. data/lib/chef-dk/skeletons/code_generator/files/default/build_cookbook/README.md +146 -146
  134. data/lib/chef-dk/skeletons/code_generator/files/default/build_cookbook/test-fixture-recipe.rb +9 -9
  135. data/lib/chef-dk/skeletons/code_generator/files/default/chefignore +104 -107
  136. data/lib/chef-dk/skeletons/code_generator/files/default/cookbook_readmes/README-policy.md +9 -9
  137. data/lib/chef-dk/skeletons/code_generator/files/default/cookbook_readmes/README.md +66 -54
  138. data/lib/chef-dk/skeletons/code_generator/files/default/delivery-config.json +17 -17
  139. data/lib/chef-dk/skeletons/code_generator/files/default/delivery-project.toml +36 -36
  140. data/lib/chef-dk/skeletons/code_generator/files/default/gitignore +22 -22
  141. data/lib/chef-dk/skeletons/code_generator/files/default/repo/README.md +24 -24
  142. data/lib/chef-dk/skeletons/code_generator/files/default/repo/cookbooks/example/README.md +27 -27
  143. data/lib/chef-dk/skeletons/code_generator/files/default/repo/cookbooks/example/attributes/default.rb +8 -8
  144. data/lib/chef-dk/skeletons/code_generator/files/default/repo/cookbooks/example/metadata.rb +7 -7
  145. data/lib/chef-dk/skeletons/code_generator/files/default/repo/cookbooks/example/recipes/default.rb +9 -9
  146. data/lib/chef-dk/skeletons/code_generator/files/default/repo/data_bags/README.md +56 -56
  147. data/lib/chef-dk/skeletons/code_generator/files/default/repo/data_bags/example/example_item.json +3 -3
  148. data/lib/chef-dk/skeletons/code_generator/files/default/repo/dot-chef-repo.txt +6 -6
  149. data/lib/chef-dk/skeletons/code_generator/files/default/repo/environments/README.md +9 -9
  150. data/lib/chef-dk/skeletons/code_generator/files/default/repo/environments/example.json +12 -12
  151. data/lib/chef-dk/skeletons/code_generator/files/default/repo/policies/README.md +24 -24
  152. data/lib/chef-dk/skeletons/code_generator/files/default/repo/roles/README.md +9 -9
  153. data/lib/chef-dk/skeletons/code_generator/files/default/repo/roles/example.json +12 -12
  154. data/lib/chef-dk/skeletons/code_generator/files/default/spec_helper.rb +3 -3
  155. data/lib/chef-dk/skeletons/code_generator/files/default/spec_helper_policyfile.rb +3 -3
  156. data/lib/chef-dk/skeletons/code_generator/metadata.rb +8 -8
  157. data/lib/chef-dk/skeletons/code_generator/recipes/app.rb +89 -89
  158. data/lib/chef-dk/skeletons/code_generator/recipes/attribute.rb +13 -13
  159. data/lib/chef-dk/skeletons/code_generator/recipes/build_cookbook.rb +177 -177
  160. data/lib/chef-dk/skeletons/code_generator/recipes/cookbook.rb +158 -152
  161. data/lib/chef-dk/skeletons/code_generator/recipes/cookbook_file.rb +25 -25
  162. data/lib/chef-dk/skeletons/code_generator/recipes/helpers.rb +21 -21
  163. data/lib/chef-dk/skeletons/code_generator/recipes/policyfile.rb +9 -9
  164. data/lib/chef-dk/skeletons/code_generator/recipes/recipe.rb +52 -52
  165. data/lib/chef-dk/skeletons/code_generator/recipes/repo.rb +68 -68
  166. data/lib/chef-dk/skeletons/code_generator/recipes/resource.rb +13 -13
  167. data/lib/chef-dk/skeletons/code_generator/recipes/template.rb +32 -32
  168. data/lib/chef-dk/skeletons/code_generator/templates/default/CHANGELOG.md.erb +11 -0
  169. data/lib/chef-dk/skeletons/code_generator/templates/default/LICENSE.all_rights.erb +3 -3
  170. data/lib/chef-dk/skeletons/code_generator/templates/default/LICENSE.apachev2.erb +201 -201
  171. data/lib/chef-dk/skeletons/code_generator/templates/default/LICENSE.gplv2.erb +339 -339
  172. data/lib/chef-dk/skeletons/code_generator/templates/default/LICENSE.gplv3.erb +674 -674
  173. data/lib/chef-dk/skeletons/code_generator/templates/default/LICENSE.mit.erb +21 -21
  174. data/lib/chef-dk/skeletons/code_generator/templates/default/Policyfile.rb.erb +25 -25
  175. data/lib/chef-dk/skeletons/code_generator/templates/default/README.md.erb +4 -4
  176. data/lib/chef-dk/skeletons/code_generator/templates/default/build_cookbook/Berksfile.erb +7 -7
  177. data/lib/chef-dk/skeletons/code_generator/templates/default/build_cookbook/metadata.rb.erb +10 -10
  178. data/lib/chef-dk/skeletons/code_generator/templates/default/build_cookbook/recipe.rb.erb +8 -8
  179. data/lib/chef-dk/skeletons/code_generator/templates/default/helpers.rb.erb +39 -39
  180. data/lib/chef-dk/skeletons/code_generator/templates/default/inspec_default_test.rb.erb +18 -18
  181. data/lib/chef-dk/skeletons/code_generator/templates/default/kitchen.yml.erb +26 -26
  182. data/lib/chef-dk/skeletons/code_generator/templates/default/kitchen_policyfile.yml.erb +33 -33
  183. data/lib/chef-dk/skeletons/code_generator/templates/default/metadata.rb.erb +20 -20
  184. data/lib/chef-dk/skeletons/code_generator/templates/default/recipe.rb.erb +5 -5
  185. data/lib/chef-dk/skeletons/code_generator/templates/default/recipe_spec.rb.erb +35 -35
  186. data/lib/chef-dk/skeletons/code_generator/templates/default/repo/gitignore.erb +128 -128
  187. data/lib/chef-dk/skeletons/code_generator/templates/default/resource.rb.erb +1 -1
  188. data/lib/chef-dk/ui.rb +57 -57
  189. data/lib/chef-dk/version.rb +20 -20
  190. data/lib/kitchen/provisioner/policyfile_zero.rb +195 -195
  191. data/omnibus_overrides.rb +25 -25
  192. data/spec/shared/a_file_generator.rb +125 -125
  193. data/spec/shared/a_generated_file.rb +12 -12
  194. data/spec/shared/command_with_ui_object.rb +11 -11
  195. data/spec/shared/custom_generator_cookbook.rb +136 -136
  196. data/spec/shared/fixture_cookbook_checksums.rb +46 -46
  197. data/spec/shared/setup_git_committer_config.rb +54 -54
  198. data/spec/shared/setup_git_cookbooks.rb +53 -53
  199. data/spec/spec_helper.rb +51 -51
  200. data/spec/test_helpers.rb +84 -84
  201. data/spec/unit/chef_runner_spec.rb +139 -139
  202. data/spec/unit/chef_server_api_multi_spec.rb +120 -120
  203. data/spec/unit/cli_spec.rb +377 -377
  204. data/spec/unit/command/base_spec.rb +172 -172
  205. data/spec/unit/command/clean_policy_cookbooks_spec.rb +180 -180
  206. data/spec/unit/command/clean_policy_revisions_spec.rb +180 -180
  207. data/spec/unit/command/delete_policy_group_spec.rb +206 -206
  208. data/spec/unit/command/delete_policy_spec.rb +206 -206
  209. data/spec/unit/command/diff_spec.rb +311 -311
  210. data/spec/unit/command/env_spec.rb +52 -52
  211. data/spec/unit/command/exec_spec.rb +178 -178
  212. data/spec/unit/command/export_spec.rb +199 -199
  213. data/spec/unit/command/generate_spec.rb +142 -142
  214. data/spec/unit/command/generator_commands/app_spec.rb +166 -166
  215. data/spec/unit/command/generator_commands/attribute_spec.rb +31 -31
  216. data/spec/unit/command/generator_commands/base_spec.rb +181 -181
  217. data/spec/unit/command/generator_commands/build_cookbook_spec.rb +377 -377
  218. data/spec/unit/command/generator_commands/chef_exts/generator_desc_resource_spec.rb +97 -97
  219. data/spec/unit/command/generator_commands/chef_exts/recipe_dsl_ext_spec.rb +111 -111
  220. data/spec/unit/command/generator_commands/cookbook_file_spec.rb +31 -31
  221. data/spec/unit/command/generator_commands/cookbook_spec.rb +765 -756
  222. data/spec/unit/command/generator_commands/generator_generator_spec.rb +227 -227
  223. data/spec/unit/command/generator_commands/helpers_spec.rb +31 -31
  224. data/spec/unit/command/generator_commands/policyfile_spec.rb +223 -223
  225. data/spec/unit/command/generator_commands/recipe_spec.rb +37 -37
  226. data/spec/unit/command/generator_commands/repo_spec.rb +374 -374
  227. data/spec/unit/command/generator_commands/resource_spec.rb +31 -31
  228. data/spec/unit/command/generator_commands/template_spec.rb +31 -31
  229. data/spec/unit/command/install_spec.rb +179 -179
  230. data/spec/unit/command/provision_spec.rb +589 -589
  231. data/spec/unit/command/push_archive_spec.rb +153 -153
  232. data/spec/unit/command/push_spec.rb +198 -198
  233. data/spec/unit/command/shell_init_spec.rb +339 -339
  234. data/spec/unit/command/show_policy_spec.rb +234 -234
  235. data/spec/unit/command/undelete_spec.rb +244 -244
  236. data/spec/unit/command/update_spec.rb +283 -283
  237. data/spec/unit/command/verify_spec.rb +341 -341
  238. data/spec/unit/commands_map_spec.rb +57 -57
  239. data/spec/unit/component_test_spec.rb +128 -128
  240. data/spec/unit/configurable_spec.rb +68 -68
  241. data/spec/unit/cookbook_metadata_spec.rb +96 -96
  242. data/spec/unit/cookbook_profiler/git_spec.rb +176 -176
  243. data/spec/unit/cookbook_profiler/identifiers_spec.rb +81 -81
  244. data/spec/unit/fixtures/chef-runner-cookbooks/test_cookbook/recipes/recipe_one.rb +9 -9
  245. data/spec/unit/fixtures/chef-runner-cookbooks/test_cookbook/recipes/recipe_two.rb +9 -9
  246. data/spec/unit/fixtures/command/cli_test_command.rb +26 -26
  247. data/spec/unit/fixtures/command/explicit_path_example.rb +7 -7
  248. data/spec/unit/fixtures/configurable/test_config_loader.rb +5 -5
  249. data/spec/unit/fixtures/configurable/test_configurable.rb +10 -10
  250. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/.kitchen.yml +16 -16
  251. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/Berksfile +3 -3
  252. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/README.md +4 -4
  253. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/chefignore +96 -96
  254. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/metadata.rb +8 -8
  255. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/recipes/default.rb +8 -8
  256. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/.kitchen.yml +16 -16
  257. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/Berksfile +3 -3
  258. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/README.md +4 -4
  259. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/chefignore +96 -96
  260. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/metadata.rb +8 -8
  261. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/recipes/default.rb +8 -8
  262. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/.kitchen.yml +16 -16
  263. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/Berksfile +3 -3
  264. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/README.md +4 -4
  265. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/chefignore +96 -96
  266. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/metadata.rb +8 -8
  267. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/recipes/default.rb +8 -8
  268. data/spec/unit/fixtures/cookbooks_api/chef_server_universe.json +56 -56
  269. data/spec/unit/fixtures/cookbooks_api/pruned_chef_server_universe.json +30 -30
  270. data/spec/unit/fixtures/cookbooks_api/pruned_small_universe.json +1321 -1321
  271. data/spec/unit/fixtures/cookbooks_api/small_universe.json +2987 -2987
  272. data/spec/unit/fixtures/cookbooks_api/universe.json +1 -1
  273. data/spec/unit/fixtures/cookbooks_api/update_fixtures.rb +33 -33
  274. data/spec/unit/fixtures/dev_cookbooks/README.md +16 -16
  275. data/spec/unit/fixtures/eg_omnibus_dir/valid/embedded/apps/berkshelf/integration_test +2 -2
  276. data/spec/unit/fixtures/eg_omnibus_dir/valid/embedded/apps/berkshelf/verify_me +5 -5
  277. data/spec/unit/fixtures/eg_omnibus_dir/valid/embedded/apps/chef/verify_me +3 -3
  278. data/spec/unit/fixtures/eg_omnibus_dir/valid/embedded/apps/test-kitchen/verify_me +2 -2
  279. data/spec/unit/fixtures/example_cookbook/.gitignore +17 -17
  280. data/spec/unit/fixtures/example_cookbook/.kitchen.yml +16 -16
  281. data/spec/unit/fixtures/example_cookbook/Berksfile +3 -3
  282. data/spec/unit/fixtures/example_cookbook/README.md +4 -4
  283. data/spec/unit/fixtures/example_cookbook/chefignore +96 -96
  284. data/spec/unit/fixtures/example_cookbook/metadata.rb +8 -8
  285. data/spec/unit/fixtures/example_cookbook/recipes/default.rb +8 -8
  286. data/spec/unit/fixtures/example_cookbook_metadata_json_only/.gitignore +17 -17
  287. data/spec/unit/fixtures/example_cookbook_metadata_json_only/.kitchen.yml +16 -16
  288. data/spec/unit/fixtures/example_cookbook_metadata_json_only/Berksfile +3 -3
  289. data/spec/unit/fixtures/example_cookbook_metadata_json_only/README.md +4 -4
  290. data/spec/unit/fixtures/example_cookbook_metadata_json_only/chefignore +96 -96
  291. data/spec/unit/fixtures/example_cookbook_metadata_json_only/metadata.json +5 -5
  292. data/spec/unit/fixtures/example_cookbook_metadata_json_only/recipes/default.rb +8 -8
  293. data/spec/unit/fixtures/example_cookbook_no_metadata/.gitignore +17 -17
  294. data/spec/unit/fixtures/example_cookbook_no_metadata/.kitchen.yml +16 -16
  295. data/spec/unit/fixtures/example_cookbook_no_metadata/Berksfile +3 -3
  296. data/spec/unit/fixtures/example_cookbook_no_metadata/README.md +4 -4
  297. data/spec/unit/fixtures/example_cookbook_no_metadata/chefignore +96 -96
  298. data/spec/unit/fixtures/example_cookbook_no_metadata/recipes/default.rb +8 -8
  299. data/spec/unit/fixtures/local_path_cookbooks/another-local-cookbook/README.md +4 -4
  300. data/spec/unit/fixtures/local_path_cookbooks/another-local-cookbook/chefignore +96 -96
  301. data/spec/unit/fixtures/local_path_cookbooks/another-local-cookbook/metadata.rb +8 -8
  302. data/spec/unit/fixtures/local_path_cookbooks/another-local-cookbook/recipes/default.rb +8 -8
  303. data/spec/unit/fixtures/local_path_cookbooks/cookbook-with-a-dep/Berksfile +3 -3
  304. data/spec/unit/fixtures/local_path_cookbooks/cookbook-with-a-dep/README.md +4 -4
  305. data/spec/unit/fixtures/local_path_cookbooks/cookbook-with-a-dep/chefignore +96 -96
  306. data/spec/unit/fixtures/local_path_cookbooks/cookbook-with-a-dep/metadata.rb +9 -9
  307. data/spec/unit/fixtures/local_path_cookbooks/cookbook-with-a-dep/recipes/default.rb +8 -8
  308. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/.kitchen.yml +16 -16
  309. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/Berksfile +3 -3
  310. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/README.md +4 -4
  311. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/chefignore +96 -96
  312. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/metadata.rb +8 -8
  313. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/recipes/default.rb +8 -8
  314. data/spec/unit/fixtures/local_path_cookbooks/metadata-missing/README.md +2 -2
  315. data/spec/unit/fixtures/local_path_cookbooks/noignore-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/.kitchen.yml +16 -16
  316. data/spec/unit/fixtures/local_path_cookbooks/noignore-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/README.md +4 -4
  317. data/spec/unit/fixtures/local_path_cookbooks/noignore-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/metadata.rb +8 -8
  318. data/spec/unit/fixtures/local_path_cookbooks/noignore-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/recipes/default.rb +8 -8
  319. data/spec/unit/generator_spec.rb +119 -119
  320. data/spec/unit/pager_spec.rb +117 -117
  321. data/spec/unit/policyfile/artifactory_cookbook_source_spec.rb +59 -59
  322. data/spec/unit/policyfile/attribute_merge_checker_spec.rb +80 -80
  323. data/spec/unit/policyfile/chef_repo_cookbook_source_spec.rb +93 -93
  324. data/spec/unit/policyfile/chef_server_cookbook_source_spec.rb +55 -55
  325. data/spec/unit/policyfile/chef_server_lock_fetcher_spec.rb +161 -161
  326. data/spec/unit/policyfile/community_cookbook_source_spec.rb +83 -83
  327. data/spec/unit/policyfile/comparison_base_spec.rb +340 -340
  328. data/spec/unit/policyfile/cookbook_location_specification_spec.rb +347 -347
  329. data/spec/unit/policyfile/cookbook_locks_spec.rb +527 -527
  330. data/spec/unit/policyfile/delivery_supermarket_source_spec.rb +129 -129
  331. data/spec/unit/policyfile/differ_spec.rb +686 -686
  332. data/spec/unit/policyfile/git_lock_fetcher_spec.rb +155 -0
  333. data/spec/unit/policyfile/included_policies_cookbook_source_spec.rb +242 -242
  334. data/spec/unit/policyfile/lister_spec.rb +268 -268
  335. data/spec/unit/policyfile/local_lock_fetcher_spec.rb +173 -173
  336. data/spec/unit/policyfile/lock_applier_spec.rb +100 -100
  337. data/spec/unit/policyfile/null_cookbook_source_spec.rb +34 -34
  338. data/spec/unit/policyfile/read_cookbook_for_compat_mode_upload_spec.rb +92 -92
  339. data/spec/unit/policyfile/reports/install_spec.rb +114 -114
  340. data/spec/unit/policyfile/reports/upload_spec.rb +94 -94
  341. data/spec/unit/policyfile/solution_dependencies_spec.rb +170 -170
  342. data/spec/unit/policyfile/source_uri_spec.rb +36 -36
  343. data/spec/unit/policyfile/storage_config_spec.rb +180 -180
  344. data/spec/unit/policyfile/undo_record_spec.rb +258 -258
  345. data/spec/unit/policyfile/undo_stack_spec.rb +265 -265
  346. data/spec/unit/policyfile/uploader_spec.rb +409 -409
  347. data/spec/unit/policyfile_demands_spec.rb +1197 -1197
  348. data/spec/unit/policyfile_evaluation_spec.rb +628 -638
  349. data/spec/unit/policyfile_includes_dsl_spec.rb +159 -159
  350. data/spec/unit/policyfile_includes_spec.rb +720 -720
  351. data/spec/unit/policyfile_install_with_includes_spec.rb +232 -232
  352. data/spec/unit/policyfile_lock_build_spec.rb +1065 -1065
  353. data/spec/unit/policyfile_lock_install_spec.rb +137 -137
  354. data/spec/unit/policyfile_lock_serialization_spec.rb +424 -424
  355. data/spec/unit/policyfile_lock_validation_spec.rb +608 -608
  356. data/spec/unit/policyfile_services/clean_policies_spec.rb +236 -236
  357. data/spec/unit/policyfile_services/clean_policy_cookbooks_spec.rb +272 -272
  358. data/spec/unit/policyfile_services/export_repo_spec.rb +473 -478
  359. data/spec/unit/policyfile_services/install_spec.rb +209 -209
  360. data/spec/unit/policyfile_services/push_archive_spec.rb +359 -374
  361. data/spec/unit/policyfile_services/push_spec.rb +249 -249
  362. data/spec/unit/policyfile_services/rm_policy_group_spec.rb +237 -237
  363. data/spec/unit/policyfile_services/rm_policy_spec.rb +263 -263
  364. data/spec/unit/policyfile_services/show_policy_spec.rb +887 -887
  365. data/spec/unit/policyfile_services/undelete_spec.rb +302 -302
  366. data/spec/unit/policyfile_services/update_attributes_spec.rb +229 -229
  367. data/spec/unit/policyfile_services/update_spec.rb +140 -140
  368. data/spec/unit/service_exception_inspectors/base_spec.rb +41 -41
  369. data/spec/unit/service_exception_inspectors/http_spec.rb +138 -138
  370. data/spec/unit/shell_out_spec.rb +34 -34
  371. data/tasks/announce.rb +57 -57
  372. data/tasks/bin/bundle-platform.bat +2 -2
  373. data/tasks/dependencies.rb +89 -89
  374. data/tasks/templates/prerelease.md.erb +35 -35
  375. data/tasks/templates/release.md.erb +34 -34
  376. data/warning.txt +9 -9
  377. metadata +9 -5
data/LICENSE CHANGED
@@ -1,201 +1,201 @@
1
- Apache License
2
- Version 2.0, January 2004
3
- http://www.apache.org/licenses/
4
-
5
- TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
-
7
- 1. Definitions.
8
-
9
- "License" shall mean the terms and conditions for use, reproduction,
10
- and distribution as defined by Sections 1 through 9 of this document.
11
-
12
- "Licensor" shall mean the copyright owner or entity authorized by
13
- the copyright owner that is granting the License.
14
-
15
- "Legal Entity" shall mean the union of the acting entity and all
16
- other entities that control, are controlled by, or are under common
17
- control with that entity. For the purposes of this definition,
18
- "control" means (i) the power, direct or indirect, to cause the
19
- direction or management of such entity, whether by contract or
20
- otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
- outstanding shares, or (iii) beneficial ownership of such entity.
22
-
23
- "You" (or "Your") shall mean an individual or Legal Entity
24
- exercising permissions granted by this License.
25
-
26
- "Source" form shall mean the preferred form for making modifications,
27
- including but not limited to software source code, documentation
28
- source, and configuration files.
29
-
30
- "Object" form shall mean any form resulting from mechanical
31
- transformation or translation of a Source form, including but
32
- not limited to compiled object code, generated documentation,
33
- and conversions to other media types.
34
-
35
- "Work" shall mean the work of authorship, whether in Source or
36
- Object form, made available under the License, as indicated by a
37
- copyright notice that is included in or attached to the work
38
- (an example is provided in the Appendix below).
39
-
40
- "Derivative Works" shall mean any work, whether in Source or Object
41
- form, that is based on (or derived from) the Work and for which the
42
- editorial revisions, annotations, elaborations, or other modifications
43
- represent, as a whole, an original work of authorship. For the purposes
44
- of this License, Derivative Works shall not include works that remain
45
- separable from, or merely link (or bind by name) to the interfaces of,
46
- the Work and Derivative Works thereof.
47
-
48
- "Contribution" shall mean any work of authorship, including
49
- the original version of the Work and any modifications or additions
50
- to that Work or Derivative Works thereof, that is intentionally
51
- submitted to Licensor for inclusion in the Work by the copyright owner
52
- or by an individual or Legal Entity authorized to submit on behalf of
53
- the copyright owner. For the purposes of this definition, "submitted"
54
- means any form of electronic, verbal, or written communication sent
55
- to the Licensor or its representatives, including but not limited to
56
- communication on electronic mailing lists, source code control systems,
57
- and issue tracking systems that are managed by, or on behalf of, the
58
- Licensor for the purpose of discussing and improving the Work, but
59
- excluding communication that is conspicuously marked or otherwise
60
- designated in writing by the copyright owner as "Not a Contribution."
61
-
62
- "Contributor" shall mean Licensor and any individual or Legal Entity
63
- on behalf of whom a Contribution has been received by Licensor and
64
- subsequently incorporated within the Work.
65
-
66
- 2. Grant of Copyright License. Subject to the terms and conditions of
67
- this License, each Contributor hereby grants to You a perpetual,
68
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
- copyright license to reproduce, prepare Derivative Works of,
70
- publicly display, publicly perform, sublicense, and distribute the
71
- Work and such Derivative Works in Source or Object form.
72
-
73
- 3. Grant of Patent License. Subject to the terms and conditions of
74
- this License, each Contributor hereby grants to You a perpetual,
75
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
- (except as stated in this section) patent license to make, have made,
77
- use, offer to sell, sell, import, and otherwise transfer the Work,
78
- where such license applies only to those patent claims licensable
79
- by such Contributor that are necessarily infringed by their
80
- Contribution(s) alone or by combination of their Contribution(s)
81
- with the Work to which such Contribution(s) was submitted. If You
82
- institute patent litigation against any entity (including a
83
- cross-claim or counterclaim in a lawsuit) alleging that the Work
84
- or a Contribution incorporated within the Work constitutes direct
85
- or contributory patent infringement, then any patent licenses
86
- granted to You under this License for that Work shall terminate
87
- as of the date such litigation is filed.
88
-
89
- 4. Redistribution. You may reproduce and distribute copies of the
90
- Work or Derivative Works thereof in any medium, with or without
91
- modifications, and in Source or Object form, provided that You
92
- meet the following conditions:
93
-
94
- (a) You must give any other recipients of the Work or
95
- Derivative Works a copy of this License; and
96
-
97
- (b) You must cause any modified files to carry prominent notices
98
- stating that You changed the files; and
99
-
100
- (c) You must retain, in the Source form of any Derivative Works
101
- that You distribute, all copyright, patent, trademark, and
102
- attribution notices from the Source form of the Work,
103
- excluding those notices that do not pertain to any part of
104
- the Derivative Works; and
105
-
106
- (d) If the Work includes a "NOTICE" text file as part of its
107
- distribution, then any Derivative Works that You distribute must
108
- include a readable copy of the attribution notices contained
109
- within such NOTICE file, excluding those notices that do not
110
- pertain to any part of the Derivative Works, in at least one
111
- of the following places: within a NOTICE text file distributed
112
- as part of the Derivative Works; within the Source form or
113
- documentation, if provided along with the Derivative Works; or,
114
- within a display generated by the Derivative Works, if and
115
- wherever such third-party notices normally appear. The contents
116
- of the NOTICE file are for informational purposes only and
117
- do not modify the License. You may add Your own attribution
118
- notices within Derivative Works that You distribute, alongside
119
- or as an addendum to the NOTICE text from the Work, provided
120
- that such additional attribution notices cannot be construed
121
- as modifying the License.
122
-
123
- You may add Your own copyright statement to Your modifications and
124
- may provide additional or different license terms and conditions
125
- for use, reproduction, or distribution of Your modifications, or
126
- for any such Derivative Works as a whole, provided Your use,
127
- reproduction, and distribution of the Work otherwise complies with
128
- the conditions stated in this License.
129
-
130
- 5. Submission of Contributions. Unless You explicitly state otherwise,
131
- any Contribution intentionally submitted for inclusion in the Work
132
- by You to the Licensor shall be under the terms and conditions of
133
- this License, without any additional terms or conditions.
134
- Notwithstanding the above, nothing herein shall supersede or modify
135
- the terms of any separate license agreement you may have executed
136
- with Licensor regarding such Contributions.
137
-
138
- 6. Trademarks. This License does not grant permission to use the trade
139
- names, trademarks, service marks, or product names of the Licensor,
140
- except as required for reasonable and customary use in describing the
141
- origin of the Work and reproducing the content of the NOTICE file.
142
-
143
- 7. Disclaimer of Warranty. Unless required by applicable law or
144
- agreed to in writing, Licensor provides the Work (and each
145
- Contributor provides its Contributions) on an "AS IS" BASIS,
146
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
- implied, including, without limitation, any warranties or conditions
148
- of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
- PARTICULAR PURPOSE. You are solely responsible for determining the
150
- appropriateness of using or redistributing the Work and assume any
151
- risks associated with Your exercise of permissions under this License.
152
-
153
- 8. Limitation of Liability. In no event and under no legal theory,
154
- whether in tort (including negligence), contract, or otherwise,
155
- unless required by applicable law (such as deliberate and grossly
156
- negligent acts) or agreed to in writing, shall any Contributor be
157
- liable to You for damages, including any direct, indirect, special,
158
- incidental, or consequential damages of any character arising as a
159
- result of this License or out of the use or inability to use the
160
- Work (including but not limited to damages for loss of goodwill,
161
- work stoppage, computer failure or malfunction, or any and all
162
- other commercial damages or losses), even if such Contributor
163
- has been advised of the possibility of such damages.
164
-
165
- 9. Accepting Warranty or Additional Liability. While redistributing
166
- the Work or Derivative Works thereof, You may choose to offer,
167
- and charge a fee for, acceptance of support, warranty, indemnity,
168
- or other liability obligations and/or rights consistent with this
169
- License. However, in accepting such obligations, You may act only
170
- on Your own behalf and on Your sole responsibility, not on behalf
171
- of any other Contributor, and only if You agree to indemnify,
172
- defend, and hold each Contributor harmless for any liability
173
- incurred by, or claims asserted against, such Contributor by reason
174
- of your accepting any such warranty or additional liability.
175
-
176
- END OF TERMS AND CONDITIONS
177
-
178
- APPENDIX: How to apply the Apache License to your work.
179
-
180
- To apply the Apache License to your work, attach the following
181
- boilerplate notice, with the fields enclosed by brackets "[]"
182
- replaced with your own identifying information. (Don't include
183
- the brackets!) The text should be enclosed in the appropriate
184
- comment syntax for the file format. We also recommend that a
185
- file or class name and description of purpose be included on the
186
- same "printed page" as the copyright notice for easier
187
- identification within third-party archives.
188
-
189
- Copyright [yyyy] [name of copyright owner]
190
-
191
- Licensed under the Apache License, Version 2.0 (the "License");
192
- you may not use this file except in compliance with the License.
193
- You may obtain a copy of the License at
194
-
195
- http://www.apache.org/licenses/LICENSE-2.0
196
-
197
- Unless required by applicable law or agreed to in writing, software
198
- distributed under the License is distributed on an "AS IS" BASIS,
199
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
- See the License for the specific language governing permissions and
201
- limitations under the License.
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for reasonable and customary use in describing the
141
+ origin of the Work and reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Additional Liability. While redistributing
166
+ the Work or Derivative Works thereof, You may choose to offer,
167
+ and charge a fee for, acceptance of support, warranty, indemnity,
168
+ or other liability obligations and/or rights consistent with this
169
+ License. However, in accepting such obligations, You may act only
170
+ on Your own behalf and on Your sole responsibility, not on behalf
171
+ of any other Contributor, and only if You agree to indemnify,
172
+ defend, and hold each Contributor harmless for any liability
173
+ incurred by, or claims asserted against, such Contributor by reason
174
+ of your accepting any such warranty or additional liability.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright [yyyy] [name of copyright owner]
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.
data/README.md CHANGED
@@ -1,333 +1,333 @@
1
- # Chef Development Kit
2
-
3
- [![Build Status Master](https://travis-ci.org/chef/chef-dk.svg?branch=master)](https://travis-ci.org/chef/chef-dk)
4
- [![Build Status Master](https://ci.appveyor.com/api/projects/status/github/chef/chef-dk?branch=master&svg=true&passingText=master%20-%20Ok&pendingText=master%20-%20Pending&failingText=master%20-%20Failing)](https://ci.appveyor.com/project/Chef/chef-dk/branch/master)
5
- [![](https://img.shields.io/badge/Release%20Policy-Cadence%20Release-brightgreen.svg)](https://github.com/chef/chef-rfc/blob/master/rfc086-chef-oss-project-policies.md#cadence-release)
6
-
7
- Chef Development Kit (ChefDK) brings Chef and the development tools developed by the Chef Community together and acts as the consistent interface to this awesomeness. This awesomeness is composed of:
8
-
9
- * [Chef][]
10
- * [Berkshelf][]
11
- * [Test Kitchen][]
12
- * [ChefSpec][]
13
- * [Foodcritic][]
14
- * [Cookstyle][]
15
- * [Delivery CLI][]
16
- * [Push Jobs Client][]
17
-
18
- This repository contains the code for the `chef` command. The full
19
- package is built with omnibus. Project and component build definitions
20
- are in the omnibus directory in this repository.
21
-
22
- ## Installation
23
-
24
- You can get the [latest release of ChefDK from the downloads page][ChefDK].
25
-
26
- On Mac OS X, you can also use [homebrew-cask](https://caskroom.github.io/)
27
- to `brew cask install chefdk`.
28
-
29
- Once you install the package, the `chef-client` suite, `berks`,
30
- `kitchen`, and this application (`chef`) will be symlinked into your
31
- system bin directory, ready to use.
32
-
33
- ### Pre-release Candidates
34
-
35
- The following commands will download the latest ChefDK package from the `current` channel. The `current` channel holds builds that have passed testing and are candidates for release.
36
- More information about flags supported by install.sh available here: https://docs.chef.io/api_omnitruck.html
37
-
38
- #### Linux and OS/X:
39
-
40
- In a terminal, run:
41
-
42
- `curl https://omnitruck.chef.io/install.sh | sudo bash -s -- -c current -P chefdk`
43
-
44
- To download a specific version, append the `-v` flag. EG, `-v 0.9.0`.
45
-
46
- #### Windows
47
-
48
- Open up a Powershell command prompt as Administrator and run:
49
-
50
- `. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -channel current -project chefdk`
51
-
52
- To download a specific version, append the `-version` flag. EG, `-version 0.9.0`.
53
-
54
- ## Usage
55
-
56
- For help with [Berkshelf][], [Test Kitchen][], [ChefSpec][], [Foodcritic][], [Delivery CLI][] or [Push Jobs Client][],
57
- visit those projects' homepages for documentation and guides. For help with
58
- `chef-client` and `knife`, visit the [Chef documentation][]
59
- and [Learn Chef][].
60
-
61
- ### The `chef` Command
62
-
63
- Our goal is for `chef` to become a workflow tool that builds on the
64
- ideas of Berkshelf to provide an awesome experience that encourages
65
- quick iteration and testing (and makes those things easy) and provides a
66
- way to easily, reliably, and repeatably roll out new automation code to
67
- your infrastructure.
68
-
69
- While we've got a long way to go before we reach that goal we do have
70
- some helpful bits of functionality already included in the `chef`
71
- command:
72
-
73
- #### `chef generate`
74
- The generate subcommand generates skeleton Chef code
75
- layouts so you can skip repetitive boilerplate and get down to
76
- automating your infrastructure quickly. Unlike other generators, it only
77
- generates the minimum required files when creating a cookbook so you can
78
- focus on the task at hand without getting overwhelmed by stuff you don't
79
- need.
80
-
81
- The following generators are built-in:
82
-
83
- * `chef generate app` Creates an "application" layout that supports
84
- multiple cookbooks. This is a somewhat experimental compromise between
85
- the one-repo-per-cookbook and monolithic-chef-repo styles of cookbook
86
- management.
87
-
88
- * `chef generate cookbook` Creates a single cookbook.
89
- * `chef generate recipe` Creates a new recipe file in an existing
90
- cookbook.
91
- * `chef generate attribute` Creates a new attributes file in an existing
92
- cookbook.
93
- * `chef generate template` Creates a new template file in an existing
94
- cookbook. Use the `-s SOURCE` option to copy a source file's content to
95
- populate the template.
96
- * `chef generate file` Creates a new cookbook file in an existing
97
- cookbook. Supports the `-s SOURCE` option similar to template.
98
- * `chef generate lwrp` Creates a new LWRP resource and provider in an
99
- existing cookbook.
100
-
101
- The `chef generate` command also accepts additional `--generator-arg key=value`
102
- pairs that can be used to supply ad-hoc data to a generator cookbook.
103
- For example, you might specify `--generator-arg database=mysql` and then only
104
- write a template for `recipes/mysql.rb` if `context.database == 'mysql'`.
105
-
106
- #### `chef gem`
107
- `chef gem` is a wrapper command that manages installation and updating
108
- of rubygems for the Ruby installation embedded in the ChefDK package.
109
- This allows you to install knife plugins, Test Kitchen drivers, and
110
- other Ruby applications that are not packaged with ChefDK.
111
-
112
- Gems are installed to a `.chefdk` directory in your home directory; any
113
- executables included with a gem you install will be created in
114
- `~/.chefdk/gem/ruby/2.1.0/bin`. You can run these executables with
115
- `chef exec`, or use `chef shell-init` to add ChefDK's paths to your
116
- environment. Those commands are documented below.
117
-
118
- ### `chef exec`
119
- `chef exec <command>` runs any arbitrary shell command with the PATH
120
- environment variable and the ruby environment variables (`GEM_HOME`,
121
- `GEM_PATH`, etc.) setup to point at the embedded ChefDK omnibus environment.
122
-
123
- ### `chef shell-init`
124
- `chef shell-init SHELL_NAME` emits shell commands that modify your
125
- environment to make ChefDK your primary ruby. It supports bash, zsh,
126
- fish and PowerShell (posh). For more information to help you decide if
127
- this is desirable and instructions, see "Using ChefDK as Your Primary
128
- Development Environment" below.
129
-
130
- ### `chef install`
131
- `chef install` reads a `Policyfile.rb` document, which contains a
132
- `run_list` and optional cookbook version constraints, finds a set of
133
- cookbooks that provide the desired recipes and meet dependency
134
- constraints, and emits a `Policyfile.lock.json` describing the expanded
135
- run list and locked cookbook set. The `Policyfile.lock.json` can be used
136
- to install the cookbooks on another machine. The policy lock can be
137
- uploaded to a Chef Server (via the `chef push` command) to apply the
138
- expanded run list and locked cookbook set to nodes in your
139
- infrastructure. See the POLICYFILE_README.md for further details.
140
-
141
- ### `chef push`
142
- `chef push POLICY_GROUP` uploads a Policyfile.lock.json along with the cookbooks it
143
- references to a Chef Server. The policy lock is applied to a
144
- `POLICY_GROUP`, which is a set of nodes that share the same run list and
145
- cookbook set. This command operates in compatibility mode and has the
146
- same caveats as `chef install`. See the POLICYFILE_README.md for further
147
- details.
148
-
149
- ### `chef update`
150
- `chef update` updates a Policyfile.lock.json with the latest cookbooks
151
- from upstream sources. It supports an `--attributes` flag which will
152
- cause only attributes from the Policyfile.rb to be updated.
153
-
154
- ### `chef diff`
155
- `chef diff` shows an itemized diff between Policyfile locks. It can
156
- compare Policyfile locks from local disk, git, and/or the Chef Server,
157
- based on the options given.
158
-
159
- #### `chef verify`
160
- `chef verify` tests the embedded applications. By default it runs a
161
- quick "smoke test" to verify that the embedded applications are
162
- installed correctly and can run basic commands. As an end user this is
163
- probably all you'll ever need, but `verify` can also optionally run unit
164
- and integration tests by supplying the `--unit` and `--integration`
165
- flags, respectively.
166
-
167
- You can also focus on a specific suite of tests by passing it as an argument.
168
- For example `chef verify git` will only run the smoke tests for the `git` suite.
169
-
170
- *WARNING:* The integration tests will do dangerous things like start
171
- HTTP servers with access to your filesystem and even create users and
172
- groups if run with sufficient privileges. The tests may also be
173
- sensitive to your machine's configuration. If you choose to run these,
174
- we recommend to only run them on dedicated, isolated hosts (we do this
175
- in our build cluster to verify each build).
176
-
177
- ### Using ChefDK as Your Primary Development Environment
178
-
179
- By default, ChefDK only adds a few select applications to your `PATH`
180
- and packages them in such a way that they are isolated from any other
181
- Ruby development tools you have on your system. If you're happily using
182
- your system ruby, rvm, rbenv, chruby or any other development
183
- environment, you can continue to do so. Just ensure that the ChefDK
184
- provided applications appear first in your `PATH` before any
185
- gem-installed versions and you're good to go.
186
-
187
- If you'd like to use ChefDK as your primary Ruby/Chef development
188
- environment, however, you can do so by initializing your shell with
189
- ChefDK's environment.
190
-
191
- To try it temporarily, in a new terminal session, run:
192
-
193
- ```sh
194
- eval "$(chef shell-init SHELL_NAME)"
195
- ```
196
-
197
- where `SHELL_NAME` is the name of your shell (usually bash, but zsh is
198
- also common). This modifies your `PATH` and `GEM_*` environment
199
- variables to include ChefDK's paths (run without the `eval` to see the
200
- generated code). Now your default `ruby` and associated tools will be
201
- the ones from ChefDK:
202
-
203
- ```sh
204
- which ruby
205
- # => /opt/chefdk/embedded/bin/ruby
206
- ```
207
-
208
- To add ChefDK to your shell's environment permanently, add the
209
- initialization step to your shell's profile:
210
-
211
- ```sh
212
- echo 'eval "$(chef shell-init SHELL_NAME)"' >> ~/.YOUR_SHELL_PROFILE
213
- ```
214
-
215
- Where `YOUR_SHELL_PROFILE` is `~/.bash_profile` for most bash users,
216
- `~/.zshrc` for zsh, and `~/.bashrc` on Ubuntu.
217
-
218
- #### Powershell
219
-
220
- You can use `chef shell-init` with PowerShell on Windows.
221
-
222
- To try it in your current session:
223
-
224
- ```posh
225
- chef shell-init powershell | Invoke-Expression
226
- ```
227
-
228
- To enable it permanently:
229
-
230
- ```posh
231
- "chef shell-init powershell | Invoke-Expression" >> $PROFILE
232
- ```
233
-
234
- #### Fish
235
-
236
- `chef shell-init` also supports fish.
237
-
238
- To try it:
239
-
240
- ```fish
241
- eval (chef shell-init fish)
242
- ```
243
-
244
- To permanently enable:
245
-
246
- ```fish
247
- echo 'eval (chef shell-init SHELL_NAME)' >> ~/.config/fish/config.fish
248
- ```
249
-
250
- ## Uninstallation Instructions
251
-
252
- ### Mac OS X
253
-
254
- You can uninstall Chef Development Kit on Mac using the below commands.
255
-
256
- First, remove the main package files:
257
-
258
- ```sh
259
- # Remove the installed files
260
- sudo rm -rf /opt/chefdk
261
-
262
- # Remove the system installation entry
263
- sudo pkgutil --forget com.getchef.pkg.chefdk
264
- ```
265
-
266
- Next, remove the symlinks which the Chef Development Kit installs. The
267
- location for these differs based on your OS X version.
268
-
269
- Pre-El Capitan:
270
-
271
- ```sh
272
- # Symlinks are in /usr/bin
273
- ls -la /usr/bin | egrep '/opt/chefdk' | awk '{ print $9 }' | sudo xargs -I % rm -f /usr/bin/%
274
- ```
275
-
276
- Post-El Capitan:
277
-
278
- ```sh
279
- # Symlinks are in /usr/local/bin
280
- ls -la /usr/local/bin | egrep '/opt/chefdk' | awk '{ print $9 }' | sudo xargs -I % rm -f /usr/local/bin/%
281
- ```
282
-
283
- ### Windows
284
-
285
- You can use `Add / Remove Programs` on Windows to remove the Chef Development
286
- Kit from your system.
287
-
288
- ### RHEL
289
-
290
- You can use `rpm` to uninstall Chef Development Kit on RHEL based systems:
291
-
292
- ```sh
293
- rpm -qa *chefdk*
294
- yum remove <package>
295
- rm -rf /opt/chefdk
296
- rm -rf ~/.chefdk
297
- ```
298
-
299
- ### Ubuntu
300
-
301
- You can use `dpkg` to uninstall Chef Development Kit on Ubuntu based systems:
302
-
303
- ```sh
304
- dpkg --list | grep chefdk # or dpkg --status chefdk
305
-
306
- # Purge chefdk from the system.
307
- # see man dkpg for details
308
- dpkg -P chefdk
309
- ```
310
-
311
- ## Contributing
312
-
313
- For information on contributing to this project see <https://github.com/chef/chef/blob/master/CONTRIBUTING.md>
314
-
315
- # For ChefDK Developers
316
-
317
- See the [Development Guide](CONTRIBUTING.md) for how to get started with
318
- development on the ChefDK itself, as well as details on how dependencies,
319
- packaging, and building works.
320
-
321
- - - -
322
-
323
- [Berkshelf]: https://docs.chef.io/berkshelf.html "Berkshelf"
324
- [Chef]: https://www.chef.io/chef/ "Chef"
325
- [ChefDK]: https://downloads.chef.io/chefdk "Chef Development Kit"
326
- [Chef Documentation]: https://docs.chef.io "Chef Documentation"
327
- [ChefSpec]: http://chefspec.github.io/chefspec/ "ChefSpec"
328
- [Cookstyle]: https://docs.chef.io/cookstyle.html "Cookstyle"
329
- [Foodcritic]: http://foodcritic.io "Foodcritic"
330
- [Learn Chef]: https://learn.chef.io "Learn Chef"
331
- [Test Kitchen]: http://kitchen.ci "Test Kitchen"
332
- [Delivery CLI]: https://docs.chef.io/delivery_cli.html "Delivery CLI"
333
- [Push Jobs Client]: https://docs.chef.io/push_jobs.html#push-jobs-client "Push Jobs Client"
1
+ # Chef Development Kit
2
+
3
+ [![Build Status Master](https://travis-ci.org/chef/chef-dk.svg?branch=master)](https://travis-ci.org/chef/chef-dk)
4
+ [![Build Status Master](https://ci.appveyor.com/api/projects/status/github/chef/chef-dk?branch=master&svg=true&passingText=master%20-%20Ok&pendingText=master%20-%20Pending&failingText=master%20-%20Failing)](https://ci.appveyor.com/project/Chef/chef-dk/branch/master)
5
+ [![](https://img.shields.io/badge/Release%20Policy-Cadence%20Release-brightgreen.svg)](https://github.com/chef/chef-rfc/blob/master/rfc086-chef-oss-project-policies.md#cadence-release)
6
+
7
+ Chef Development Kit (ChefDK) brings Chef and the development tools developed by the Chef Community together and acts as the consistent interface to this awesomeness. This awesomeness is composed of:
8
+
9
+ * [Chef][]
10
+ * [Berkshelf][]
11
+ * [Test Kitchen][]
12
+ * [ChefSpec][]
13
+ * [Foodcritic][]
14
+ * [Cookstyle][]
15
+ * [Delivery CLI][]
16
+ * [Push Jobs Client][]
17
+
18
+ This repository contains the code for the `chef` command. The full
19
+ package is built with omnibus. Project and component build definitions
20
+ are in the omnibus directory in this repository.
21
+
22
+ ## Installation
23
+
24
+ You can get the [latest release of ChefDK from the downloads page][ChefDK].
25
+
26
+ On Mac OS X, you can also use [homebrew-cask](https://caskroom.github.io/)
27
+ to `brew cask install chefdk`.
28
+
29
+ Once you install the package, the `chef-client` suite, `berks`,
30
+ `kitchen`, and this application (`chef`) will be symlinked into your
31
+ system bin directory, ready to use.
32
+
33
+ ### Pre-release Candidates
34
+
35
+ The following commands will download the latest ChefDK package from the `current` channel. The `current` channel holds builds that have passed testing and are candidates for release.
36
+ More information about flags supported by install.sh available here: https://docs.chef.io/api_omnitruck.html
37
+
38
+ #### Linux and OS/X:
39
+
40
+ In a terminal, run:
41
+
42
+ `curl https://omnitruck.chef.io/install.sh | sudo bash -s -- -c current -P chefdk`
43
+
44
+ To download a specific version, append the `-v` flag. EG, `-v 0.9.0`.
45
+
46
+ #### Windows
47
+
48
+ Open up a Powershell command prompt as Administrator and run:
49
+
50
+ `. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -channel current -project chefdk`
51
+
52
+ To download a specific version, append the `-version` flag. EG, `-version 0.9.0`.
53
+
54
+ ## Usage
55
+
56
+ For help with [Berkshelf][], [Test Kitchen][], [ChefSpec][], [Foodcritic][], [Delivery CLI][] or [Push Jobs Client][],
57
+ visit those projects' homepages for documentation and guides. For help with
58
+ `chef-client` and `knife`, visit the [Chef documentation][]
59
+ and [Learn Chef][].
60
+
61
+ ### The `chef` Command
62
+
63
+ Our goal is for `chef` to become a workflow tool that builds on the
64
+ ideas of Berkshelf to provide an awesome experience that encourages
65
+ quick iteration and testing (and makes those things easy) and provides a
66
+ way to easily, reliably, and repeatably roll out new automation code to
67
+ your infrastructure.
68
+
69
+ While we've got a long way to go before we reach that goal we do have
70
+ some helpful bits of functionality already included in the `chef`
71
+ command:
72
+
73
+ #### `chef generate`
74
+ The generate subcommand generates skeleton Chef code
75
+ layouts so you can skip repetitive boilerplate and get down to
76
+ automating your infrastructure quickly. Unlike other generators, it only
77
+ generates the minimum required files when creating a cookbook so you can
78
+ focus on the task at hand without getting overwhelmed by stuff you don't
79
+ need.
80
+
81
+ The following generators are built-in:
82
+
83
+ * `chef generate app` Creates an "application" layout that supports
84
+ multiple cookbooks. This is a somewhat experimental compromise between
85
+ the one-repo-per-cookbook and monolithic-chef-repo styles of cookbook
86
+ management.
87
+
88
+ * `chef generate cookbook` Creates a single cookbook.
89
+ * `chef generate recipe` Creates a new recipe file in an existing
90
+ cookbook.
91
+ * `chef generate attribute` Creates a new attributes file in an existing
92
+ cookbook.
93
+ * `chef generate template` Creates a new template file in an existing
94
+ cookbook. Use the `-s SOURCE` option to copy a source file's content to
95
+ populate the template.
96
+ * `chef generate file` Creates a new cookbook file in an existing
97
+ cookbook. Supports the `-s SOURCE` option similar to template.
98
+ * `chef generate lwrp` Creates a new LWRP resource and provider in an
99
+ existing cookbook.
100
+
101
+ The `chef generate` command also accepts additional `--generator-arg key=value`
102
+ pairs that can be used to supply ad-hoc data to a generator cookbook.
103
+ For example, you might specify `--generator-arg database=mysql` and then only
104
+ write a template for `recipes/mysql.rb` if `context.database == 'mysql'`.
105
+
106
+ #### `chef gem`
107
+ `chef gem` is a wrapper command that manages installation and updating
108
+ of rubygems for the Ruby installation embedded in the ChefDK package.
109
+ This allows you to install knife plugins, Test Kitchen drivers, and
110
+ other Ruby applications that are not packaged with ChefDK.
111
+
112
+ Gems are installed to a `.chefdk` directory in your home directory; any
113
+ executables included with a gem you install will be created in
114
+ `~/.chefdk/gem/ruby/2.1.0/bin`. You can run these executables with
115
+ `chef exec`, or use `chef shell-init` to add ChefDK's paths to your
116
+ environment. Those commands are documented below.
117
+
118
+ ### `chef exec`
119
+ `chef exec <command>` runs any arbitrary shell command with the PATH
120
+ environment variable and the ruby environment variables (`GEM_HOME`,
121
+ `GEM_PATH`, etc.) setup to point at the embedded ChefDK omnibus environment.
122
+
123
+ ### `chef shell-init`
124
+ `chef shell-init SHELL_NAME` emits shell commands that modify your
125
+ environment to make ChefDK your primary ruby. It supports bash, zsh,
126
+ fish and PowerShell (posh). For more information to help you decide if
127
+ this is desirable and instructions, see "Using ChefDK as Your Primary
128
+ Development Environment" below.
129
+
130
+ ### `chef install`
131
+ `chef install` reads a `Policyfile.rb` document, which contains a
132
+ `run_list` and optional cookbook version constraints, finds a set of
133
+ cookbooks that provide the desired recipes and meet dependency
134
+ constraints, and emits a `Policyfile.lock.json` describing the expanded
135
+ run list and locked cookbook set. The `Policyfile.lock.json` can be used
136
+ to install the cookbooks on another machine. The policy lock can be
137
+ uploaded to a Chef Server (via the `chef push` command) to apply the
138
+ expanded run list and locked cookbook set to nodes in your
139
+ infrastructure. See the POLICYFILE_README.md for further details.
140
+
141
+ ### `chef push`
142
+ `chef push POLICY_GROUP` uploads a Policyfile.lock.json along with the cookbooks it
143
+ references to a Chef Server. The policy lock is applied to a
144
+ `POLICY_GROUP`, which is a set of nodes that share the same run list and
145
+ cookbook set. This command operates in compatibility mode and has the
146
+ same caveats as `chef install`. See the POLICYFILE_README.md for further
147
+ details.
148
+
149
+ ### `chef update`
150
+ `chef update` updates a Policyfile.lock.json with the latest cookbooks
151
+ from upstream sources. It supports an `--attributes` flag which will
152
+ cause only attributes from the Policyfile.rb to be updated.
153
+
154
+ ### `chef diff`
155
+ `chef diff` shows an itemized diff between Policyfile locks. It can
156
+ compare Policyfile locks from local disk, git, and/or the Chef Server,
157
+ based on the options given.
158
+
159
+ #### `chef verify`
160
+ `chef verify` tests the embedded applications. By default it runs a
161
+ quick "smoke test" to verify that the embedded applications are
162
+ installed correctly and can run basic commands. As an end user this is
163
+ probably all you'll ever need, but `verify` can also optionally run unit
164
+ and integration tests by supplying the `--unit` and `--integration`
165
+ flags, respectively.
166
+
167
+ You can also focus on a specific suite of tests by passing it as an argument.
168
+ For example `chef verify git` will only run the smoke tests for the `git` suite.
169
+
170
+ *WARNING:* The integration tests will do dangerous things like start
171
+ HTTP servers with access to your filesystem and even create users and
172
+ groups if run with sufficient privileges. The tests may also be
173
+ sensitive to your machine's configuration. If you choose to run these,
174
+ we recommend to only run them on dedicated, isolated hosts (we do this
175
+ in our build cluster to verify each build).
176
+
177
+ ### Using ChefDK as Your Primary Development Environment
178
+
179
+ By default, ChefDK only adds a few select applications to your `PATH`
180
+ and packages them in such a way that they are isolated from any other
181
+ Ruby development tools you have on your system. If you're happily using
182
+ your system ruby, rvm, rbenv, chruby or any other development
183
+ environment, you can continue to do so. Just ensure that the ChefDK
184
+ provided applications appear first in your `PATH` before any
185
+ gem-installed versions and you're good to go.
186
+
187
+ If you'd like to use ChefDK as your primary Ruby/Chef development
188
+ environment, however, you can do so by initializing your shell with
189
+ ChefDK's environment.
190
+
191
+ To try it temporarily, in a new terminal session, run:
192
+
193
+ ```sh
194
+ eval "$(chef shell-init SHELL_NAME)"
195
+ ```
196
+
197
+ where `SHELL_NAME` is the name of your shell (usually bash, but zsh is
198
+ also common). This modifies your `PATH` and `GEM_*` environment
199
+ variables to include ChefDK's paths (run without the `eval` to see the
200
+ generated code). Now your default `ruby` and associated tools will be
201
+ the ones from ChefDK:
202
+
203
+ ```sh
204
+ which ruby
205
+ # => /opt/chefdk/embedded/bin/ruby
206
+ ```
207
+
208
+ To add ChefDK to your shell's environment permanently, add the
209
+ initialization step to your shell's profile:
210
+
211
+ ```sh
212
+ echo 'eval "$(chef shell-init SHELL_NAME)"' >> ~/.YOUR_SHELL_PROFILE
213
+ ```
214
+
215
+ Where `YOUR_SHELL_PROFILE` is `~/.bash_profile` for most bash users,
216
+ `~/.zshrc` for zsh, and `~/.bashrc` on Ubuntu.
217
+
218
+ #### Powershell
219
+
220
+ You can use `chef shell-init` with PowerShell on Windows.
221
+
222
+ To try it in your current session:
223
+
224
+ ```posh
225
+ chef shell-init powershell | Invoke-Expression
226
+ ```
227
+
228
+ To enable it permanently:
229
+
230
+ ```posh
231
+ "chef shell-init powershell | Invoke-Expression" >> $PROFILE
232
+ ```
233
+
234
+ #### Fish
235
+
236
+ `chef shell-init` also supports fish.
237
+
238
+ To try it:
239
+
240
+ ```fish
241
+ eval (chef shell-init fish)
242
+ ```
243
+
244
+ To permanently enable:
245
+
246
+ ```fish
247
+ echo 'eval (chef shell-init SHELL_NAME)' >> ~/.config/fish/config.fish
248
+ ```
249
+
250
+ ## Uninstallation Instructions
251
+
252
+ ### Mac OS X
253
+
254
+ You can uninstall Chef Development Kit on Mac using the below commands.
255
+
256
+ First, remove the main package files:
257
+
258
+ ```sh
259
+ # Remove the installed files
260
+ sudo rm -rf /opt/chefdk
261
+
262
+ # Remove the system installation entry
263
+ sudo pkgutil --forget com.getchef.pkg.chefdk
264
+ ```
265
+
266
+ Next, remove the symlinks which the Chef Development Kit installs. The
267
+ location for these differs based on your OS X version.
268
+
269
+ Pre-El Capitan:
270
+
271
+ ```sh
272
+ # Symlinks are in /usr/bin
273
+ ls -la /usr/bin | egrep '/opt/chefdk' | awk '{ print $9 }' | sudo xargs -I % rm -f /usr/bin/%
274
+ ```
275
+
276
+ Post-El Capitan:
277
+
278
+ ```sh
279
+ # Symlinks are in /usr/local/bin
280
+ ls -la /usr/local/bin | egrep '/opt/chefdk' | awk '{ print $9 }' | sudo xargs -I % rm -f /usr/local/bin/%
281
+ ```
282
+
283
+ ### Windows
284
+
285
+ You can use `Add / Remove Programs` on Windows to remove the Chef Development
286
+ Kit from your system.
287
+
288
+ ### RHEL
289
+
290
+ You can use `rpm` to uninstall Chef Development Kit on RHEL based systems:
291
+
292
+ ```sh
293
+ rpm -qa *chefdk*
294
+ yum remove <package>
295
+ rm -rf /opt/chefdk
296
+ rm -rf ~/.chefdk
297
+ ```
298
+
299
+ ### Ubuntu
300
+
301
+ You can use `dpkg` to uninstall Chef Development Kit on Ubuntu based systems:
302
+
303
+ ```sh
304
+ dpkg --list | grep chefdk # or dpkg --status chefdk
305
+
306
+ # Purge chefdk from the system.
307
+ # see man dkpg for details
308
+ dpkg -P chefdk
309
+ ```
310
+
311
+ ## Contributing
312
+
313
+ For information on contributing to this project see <https://github.com/chef/chef/blob/master/CONTRIBUTING.md>
314
+
315
+ # For ChefDK Developers
316
+
317
+ See the [Development Guide](CONTRIBUTING.md) for how to get started with
318
+ development on the ChefDK itself, as well as details on how dependencies,
319
+ packaging, and building works.
320
+
321
+ - - -
322
+
323
+ [Berkshelf]: https://docs.chef.io/berkshelf.html "Berkshelf"
324
+ [Chef]: https://www.chef.io/chef/ "Chef"
325
+ [ChefDK]: https://downloads.chef.io/chefdk "Chef Development Kit"
326
+ [Chef Documentation]: https://docs.chef.io "Chef Documentation"
327
+ [ChefSpec]: http://chefspec.github.io/chefspec/ "ChefSpec"
328
+ [Cookstyle]: https://docs.chef.io/cookstyle.html "Cookstyle"
329
+ [Foodcritic]: http://foodcritic.io "Foodcritic"
330
+ [Learn Chef]: https://learn.chef.io "Learn Chef"
331
+ [Test Kitchen]: http://kitchen.ci "Test Kitchen"
332
+ [Delivery CLI]: https://docs.chef.io/delivery_cli.html "Delivery CLI"
333
+ [Push Jobs Client]: https://docs.chef.io/push_jobs.html#push-jobs-client "Push Jobs Client"