chef 11.6.2-x86-mingw32 → 11.8.0.rc.1-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (628) hide show
  1. data/CONTRIBUTING.md +12 -12
  2. data/Rakefile +11 -14
  3. data/bin/chef-apply +2 -2
  4. data/bin/chef-client +2 -2
  5. data/bin/chef-service-manager +2 -2
  6. data/bin/chef-shell +3 -0
  7. data/bin/chef-solo +2 -2
  8. data/bin/knife +3 -3
  9. data/distro/arch/etc/rc.d/chef-client +2 -2
  10. data/distro/arch/etc/rc.d/chef-server +2 -2
  11. data/distro/arch/etc/rc.d/chef-server-webui +2 -2
  12. data/distro/arch/etc/rc.d/chef-solr +2 -2
  13. data/distro/common/html/chef-client.8.html +3 -3
  14. data/distro/common/html/chef-expander.8.html +3 -3
  15. data/distro/common/html/chef-expanderctl.8.html +3 -3
  16. data/distro/common/html/chef-server-webui.8.html +3 -3
  17. data/distro/common/html/chef-server.8.html +3 -3
  18. data/distro/common/html/chef-shell.1.html +3 -3
  19. data/distro/common/html/chef-solo.8.html +3 -3
  20. data/distro/common/html/chef-solr.8.html +4 -4
  21. data/distro/common/html/knife-bootstrap.1.html +3 -3
  22. data/distro/common/html/knife-client.1.html +3 -3
  23. data/distro/common/html/knife-configure.1.html +13 -13
  24. data/distro/common/html/knife-cookbook-site.1.html +3 -3
  25. data/distro/common/html/knife-cookbook.1.html +7 -7
  26. data/distro/common/html/knife-data-bag.1.html +3 -3
  27. data/distro/common/html/knife-environment.1.html +3 -3
  28. data/distro/common/html/knife-exec.1.html +3 -3
  29. data/distro/common/html/knife-index.1.html +3 -3
  30. data/distro/common/html/knife-node.1.html +3 -3
  31. data/distro/common/html/knife-role.1.html +3 -3
  32. data/distro/common/html/knife-search.1.html +3 -3
  33. data/distro/common/html/knife-ssh.1.html +3 -3
  34. data/distro/common/html/knife-status.1.html +3 -3
  35. data/distro/common/html/knife-tag.1.html +3 -3
  36. data/distro/common/html/knife.1.html +3 -3
  37. data/distro/common/man/man1/README.md +58 -0
  38. data/distro/common/man/man1/chef-shell.1 +114 -219
  39. data/distro/common/man/man1/knife-bootstrap.1 +176 -180
  40. data/distro/common/man/man1/knife-client.1 +368 -0
  41. data/distro/common/man/man1/knife-configure.1 +147 -85
  42. data/distro/common/man/man1/knife-cookbook-site.1 +465 -133
  43. data/distro/common/man/man1/knife-cookbook.1 +614 -304
  44. data/distro/common/man/man1/knife-data-bag.1 +476 -113
  45. data/distro/common/man/man1/knife-delete.1 +132 -0
  46. data/distro/common/man/man1/knife-deps.1 +219 -0
  47. data/distro/common/man/man1/knife-diff.1 +212 -0
  48. data/distro/common/man/man1/knife-download.1 +220 -0
  49. data/distro/common/man/man1/knife-edit.1 +126 -0
  50. data/distro/common/man/man1/knife-environment.1 +324 -0
  51. data/distro/common/man/man1/knife-exec.1 +317 -35
  52. data/distro/common/man/man1/knife-index-rebuild.1 +115 -0
  53. data/distro/common/man/man1/knife-list.1 +167 -0
  54. data/distro/common/man/man1/knife-node.1 +567 -123
  55. data/distro/common/man/man1/knife-raw.1 +170 -0
  56. data/distro/common/man/man1/knife-recipe-list.1 +133 -0
  57. data/distro/common/man/man1/knife-role.1 +367 -81
  58. data/distro/common/man/man1/knife-search.1 +267 -243
  59. data/distro/common/man/man1/knife-show.1 +138 -0
  60. data/distro/common/man/man1/knife-ssh.1 +241 -66
  61. data/distro/common/man/man1/knife-status.1 +202 -24
  62. data/distro/common/man/man1/knife-tag.1 +176 -39
  63. data/distro/common/man/man1/knife-upload.1 +239 -0
  64. data/distro/common/man/man1/knife-user.1 +317 -0
  65. data/distro/common/man/man1/knife-xargs.1 +166 -0
  66. data/distro/common/man/man1/knife.1 +227 -284
  67. data/distro/common/man/man8/chef-client.8 +247 -81
  68. data/distro/common/man/man8/chef-solo.8 +142 -110
  69. data/distro/common/markdown/man1/knife-bootstrap.mkd +1 -1
  70. data/distro/common/markdown/man1/knife-configure.mkd +11 -11
  71. data/distro/common/markdown/man1/knife-cookbook.mkd +4 -4
  72. data/distro/common/markdown/man8/chef-expander.mkd +1 -1
  73. data/distro/common/markdown/man8/chef-expanderctl.mkd +1 -1
  74. data/distro/debian/etc/init.d/chef-client +1 -1
  75. data/distro/debian/etc/init.d/chef-expander +1 -1
  76. data/distro/debian/etc/init.d/chef-server +1 -1
  77. data/distro/debian/etc/init.d/chef-server-webui +1 -1
  78. data/distro/debian/etc/init.d/chef-solr +1 -1
  79. data/distro/debian/etc/init/chef-client.conf +1 -1
  80. data/distro/debian/etc/init/chef-expander.conf +1 -1
  81. data/distro/debian/etc/init/chef-server-webui.conf +1 -1
  82. data/distro/debian/etc/init/chef-server.conf +1 -1
  83. data/distro/debian/etc/init/chef-solr.conf +1 -1
  84. data/distro/redhat/etc/init.d/chef-client +1 -1
  85. data/distro/redhat/etc/init.d/chef-server +2 -2
  86. data/distro/redhat/etc/init.d/chef-server-webui +2 -2
  87. data/distro/redhat/etc/init.d/chef-solr +2 -2
  88. data/lib/chef/api_client.rb +20 -5
  89. data/lib/chef/application.rb +53 -22
  90. data/lib/chef/application/agent.rb +2 -2
  91. data/lib/chef/application/client.rb +34 -24
  92. data/lib/chef/application/knife.rb +10 -0
  93. data/lib/chef/application/solo.rb +9 -27
  94. data/lib/chef/application/windows_service.rb +24 -10
  95. data/lib/chef/application/windows_service_manager.rb +8 -0
  96. data/lib/chef/checksum/storage.rb +2 -2
  97. data/lib/chef/checksum/storage/filesystem.rb +2 -2
  98. data/lib/chef/chef_fs/chef_fs_data_store.rb +1 -1
  99. data/lib/chef/chef_fs/command_line.rb +2 -1
  100. data/lib/chef/chef_fs/config.rb +19 -64
  101. data/lib/chef/chef_fs/data_handler/client_data_handler.rb +1 -2
  102. data/lib/chef/chef_fs/file_system.rb +2 -2
  103. data/lib/chef/chef_fs/file_system/acl_entry.rb +1 -1
  104. data/lib/chef/chef_fs/file_system/chef_repository_file_system_acls_dir.rb +37 -0
  105. data/lib/chef/chef_fs/file_system/chef_repository_file_system_cookbook_dir.rb +16 -8
  106. data/lib/chef/chef_fs/file_system/chef_repository_file_system_cookbook_entry.rb +19 -4
  107. data/lib/chef/chef_fs/file_system/chef_repository_file_system_cookbooks_dir.rb +27 -12
  108. data/lib/chef/chef_fs/file_system/chef_repository_file_system_entry.rb +31 -3
  109. data/lib/chef/chef_fs/file_system/chef_repository_file_system_root_dir.rb +12 -5
  110. data/lib/chef/chef_fs/file_system/chef_server_root_dir.rb +12 -2
  111. data/lib/chef/chef_fs/file_system/cookbook_dir.rb +3 -2
  112. data/lib/chef/chef_fs/file_system/cookbook_file.rb +2 -5
  113. data/lib/chef/chef_fs/file_system/cookbooks_dir.rb +21 -6
  114. data/lib/chef/chef_fs/file_system/data_bag_dir.rb +1 -1
  115. data/lib/chef/chef_fs/file_system/data_bags_dir.rb +3 -2
  116. data/lib/chef/chef_fs/file_system/file_system_entry.rb +15 -5
  117. data/lib/chef/chef_fs/file_system/multiplexed_dir.rb +2 -1
  118. data/lib/chef/chef_fs/file_system/nodes_dir.rb +1 -1
  119. data/lib/chef/chef_fs/file_system/operation_failed_error.rb +8 -0
  120. data/lib/chef/chef_fs/file_system/rest_list_dir.rb +4 -2
  121. data/lib/chef/chef_fs/file_system/rest_list_entry.rb +4 -6
  122. data/lib/chef/chef_fs/knife.rb +39 -22
  123. data/lib/chef/chef_fs/path_utils.rb +5 -0
  124. data/lib/chef/client.rb +9 -3
  125. data/lib/chef/config.rb +306 -115
  126. data/lib/chef/config_fetcher.rb +79 -0
  127. data/lib/chef/cookbook/file_vendor.rb +5 -5
  128. data/lib/chef/cookbook/metadata.rb +2 -2
  129. data/lib/chef/cookbook/syntax_check.rb +6 -16
  130. data/lib/chef/cookbook_site_streaming_uploader.rb +8 -4
  131. data/lib/chef/cookbook_uploader.rb +10 -8
  132. data/lib/chef/cookbook_version.rb +24 -8
  133. data/lib/chef/daemon.rb +14 -75
  134. data/lib/chef/data_bag.rb +2 -3
  135. data/lib/chef/dsl/include_recipe.rb +2 -2
  136. data/lib/chef/event_dispatch/base.rb +1 -1
  137. data/lib/chef/event_dispatch/dispatcher.rb +1 -1
  138. data/lib/chef/file_access_control/windows.rb +1 -1
  139. data/lib/chef/formatters/doc.rb +5 -5
  140. data/lib/chef/formatters/error_inspectors/api_error_formatting.rb +2 -2
  141. data/lib/chef/formatters/error_inspectors/compile_error_inspector.rb +2 -2
  142. data/lib/chef/formatters/error_inspectors/cookbook_sync_error_inspector.rb +2 -2
  143. data/lib/chef/formatters/error_inspectors/node_load_error_inspector.rb +2 -2
  144. data/lib/chef/formatters/error_inspectors/resource_failure_inspector.rb +2 -2
  145. data/lib/chef/handler/json_file.rb +2 -2
  146. data/lib/chef/http.rb +386 -0
  147. data/lib/chef/{rest → http}/auth_credentials.rb +1 -1
  148. data/lib/chef/http/authenticator.rb +89 -0
  149. data/lib/chef/http/basic_client.rb +114 -0
  150. data/lib/chef/{rest → http}/cookie_jar.rb +1 -1
  151. data/lib/chef/http/cookie_manager.rb +56 -0
  152. data/lib/chef/http/decompressor.rb +137 -0
  153. data/lib/chef/{rest/rest_request.rb → http/http_request.rb} +13 -74
  154. data/lib/chef/http/json_input.rb +53 -0
  155. data/lib/chef/http/json_output.rb +69 -0
  156. data/lib/chef/http/json_to_model_output.rb +34 -0
  157. data/lib/chef/http/simple.rb +16 -0
  158. data/lib/chef/http/ssl_policies.rb +129 -0
  159. data/lib/chef/knife.rb +45 -23
  160. data/lib/chef/knife/bootstrap.rb +10 -3
  161. data/lib/chef/knife/bootstrap/chef-full.erb +10 -1
  162. data/lib/chef/knife/client_create.rb +1 -1
  163. data/lib/chef/knife/configure.rb +1 -1
  164. data/lib/chef/knife/cookbook_create.rb +7 -7
  165. data/lib/chef/knife/cookbook_download.rb +2 -2
  166. data/lib/chef/knife/cookbook_metadata_from_file.rb +2 -2
  167. data/lib/chef/knife/cookbook_show.rb +3 -3
  168. data/lib/chef/knife/cookbook_site_install.rb +2 -2
  169. data/lib/chef/knife/cookbook_site_list.rb +2 -2
  170. data/lib/chef/knife/cookbook_site_search.rb +3 -3
  171. data/lib/chef/knife/cookbook_site_show.rb +5 -5
  172. data/lib/chef/knife/core/bootstrap_context.rb +7 -3
  173. data/lib/chef/knife/core/node_editor.rb +16 -36
  174. data/lib/chef/knife/core/node_presenter.rb +1 -1
  175. data/lib/chef/knife/core/subcommand_loader.rb +5 -5
  176. data/lib/chef/knife/core/ui.rb +9 -13
  177. data/lib/chef/knife/data_bag_create.rb +7 -5
  178. data/lib/chef/knife/data_bag_delete.rb +3 -3
  179. data/lib/chef/knife/data_bag_edit.rb +9 -7
  180. data/lib/chef/knife/data_bag_from_file.rb +10 -8
  181. data/lib/chef/knife/data_bag_list.rb +2 -2
  182. data/lib/chef/knife/data_bag_show.rb +9 -7
  183. data/lib/chef/knife/delete.rb +2 -0
  184. data/lib/chef/knife/deps.rb +2 -0
  185. data/lib/chef/knife/diff.rb +6 -0
  186. data/lib/chef/knife/download.rb +6 -0
  187. data/lib/chef/knife/edit.rb +5 -8
  188. data/lib/chef/knife/environment_from_file.rb +2 -2
  189. data/lib/chef/knife/help_topics.rb +1 -1
  190. data/lib/chef/knife/index_rebuild.rb +2 -2
  191. data/lib/chef/knife/list.rb +2 -0
  192. data/lib/chef/knife/raw.rb +31 -5
  193. data/lib/chef/knife/show.rb +2 -0
  194. data/lib/chef/knife/ssh.rb +21 -7
  195. data/lib/chef/knife/status.rb +1 -1
  196. data/lib/chef/knife/upload.rb +2 -0
  197. data/lib/chef/knife/xargs.rb +2 -0
  198. data/lib/chef/mixin/checksum.rb +2 -2
  199. data/lib/chef/mixin/command.rb +46 -17
  200. data/lib/chef/mixin/convert_to_class_name.rb +8 -8
  201. data/lib/chef/mixin/create_path.rb +9 -9
  202. data/lib/chef/mixin/deep_merge.rb +2 -2
  203. data/lib/chef/mixin/from_file.rb +6 -6
  204. data/lib/chef/mixin/language_include_recipe.rb +2 -2
  205. data/lib/chef/mixin/params_validate.rb +21 -21
  206. data/lib/chef/mixin/shell_out.rb +9 -0
  207. data/lib/chef/mixin/template.rb +13 -16
  208. data/lib/chef/mixin/why_run.rb +16 -16
  209. data/lib/chef/mixin/windows_architecture_helper.rb +5 -5
  210. data/lib/chef/mixin/xml_escape.rb +10 -10
  211. data/lib/chef/monkey_patches/numeric.rb +1 -1
  212. data/lib/chef/monkey_patches/regexp.rb +4 -4
  213. data/lib/chef/monkey_patches/string.rb +3 -3
  214. data/lib/chef/monkey_patches/tempfile.rb +2 -2
  215. data/lib/chef/node.rb +8 -0
  216. data/lib/chef/node/attribute.rb +1 -1
  217. data/lib/chef/platform/provider_mapping.rb +26 -1
  218. data/lib/chef/provider/batch.rb +3 -3
  219. data/lib/chef/provider/cron.rb +27 -13
  220. data/lib/chef/provider/cron/aix.rb +48 -0
  221. data/lib/chef/provider/cron/solaris.rb +6 -40
  222. data/lib/chef/provider/cron/unix.rb +76 -0
  223. data/lib/chef/provider/deploy/timestamped.rb +4 -4
  224. data/lib/chef/provider/erl_call.rb +1 -1
  225. data/lib/chef/provider/execute.rb +2 -2
  226. data/lib/chef/provider/git.rb +1 -0
  227. data/lib/chef/provider/group.rb +21 -21
  228. data/lib/chef/provider/group/dscl.rb +9 -9
  229. data/lib/chef/provider/group/gpasswd.rb +5 -5
  230. data/lib/chef/provider/group/groupadd.rb +11 -10
  231. data/lib/chef/provider/group/pw.rb +11 -11
  232. data/lib/chef/provider/group/suse.rb +4 -4
  233. data/lib/chef/provider/group/usermod.rb +8 -8
  234. data/lib/chef/provider/group/windows.rb +9 -9
  235. data/lib/chef/provider/http_request.rb +8 -8
  236. data/lib/chef/provider/ifconfig.rb +57 -37
  237. data/lib/chef/provider/ifconfig/aix.rb +99 -0
  238. data/lib/chef/provider/log.rb +3 -3
  239. data/lib/chef/provider/mdadm.rb +5 -4
  240. data/lib/chef/provider/mount.rb +12 -12
  241. data/lib/chef/provider/mount/aix.rb +179 -0
  242. data/lib/chef/provider/mount/mount.rb +29 -15
  243. data/lib/chef/provider/package.rb +26 -16
  244. data/lib/chef/provider/package/aix.rb +146 -0
  245. data/lib/chef/provider/package/apt.rb +16 -31
  246. data/lib/chef/provider/package/dpkg.rb +9 -9
  247. data/lib/chef/provider/package/freebsd.rb +2 -2
  248. data/lib/chef/provider/package/ips.rb +3 -3
  249. data/lib/chef/provider/package/macports.rb +1 -1
  250. data/lib/chef/provider/package/pacman.rb +8 -8
  251. data/lib/chef/provider/package/rpm.rb +14 -14
  252. data/lib/chef/provider/package/rubygems.rb +1 -1
  253. data/lib/chef/provider/package/smartos.rb +3 -3
  254. data/lib/chef/provider/package/solaris.rb +16 -6
  255. data/lib/chef/provider/package/yum-dump.py +4 -4
  256. data/lib/chef/provider/package/yum.rb +3 -3
  257. data/lib/chef/provider/powershell_script.rb +7 -7
  258. data/lib/chef/provider/remote_file/ftp.rb +1 -0
  259. data/lib/chef/provider/remote_file/http.rb +6 -13
  260. data/lib/chef/provider/remote_file/local_file.rb +1 -0
  261. data/lib/chef/provider/resource_update.rb +9 -9
  262. data/lib/chef/provider/ruby_block.rb +3 -3
  263. data/lib/chef/provider/script.rb +1 -1
  264. data/lib/chef/provider/service.rb +2 -2
  265. data/lib/chef/provider/service/debian.rb +35 -15
  266. data/lib/chef/provider/service/freebsd.rb +9 -9
  267. data/lib/chef/provider/service/gentoo.rb +4 -4
  268. data/lib/chef/provider/service/init.rb +1 -1
  269. data/lib/chef/provider/service/insserv.rb +2 -2
  270. data/lib/chef/provider/service/invokercd.rb +1 -1
  271. data/lib/chef/provider/service/redhat.rb +2 -2
  272. data/lib/chef/provider/service/simple.rb +6 -6
  273. data/lib/chef/provider/service/solaris.rb +1 -1
  274. data/lib/chef/provider/service/systemd.rb +3 -3
  275. data/lib/chef/provider/service/upstart.rb +15 -15
  276. data/lib/chef/provider/subversion.rb +6 -5
  277. data/lib/chef/provider/user.rb +13 -9
  278. data/lib/chef/provider/user/dscl.rb +28 -28
  279. data/lib/chef/provider/user/pw.rb +11 -11
  280. data/lib/chef/provider/user/useradd.rb +1 -1
  281. data/lib/chef/provider/user/windows.rb +7 -7
  282. data/lib/chef/provider/windows_script.rb +7 -7
  283. data/lib/chef/providers.rb +4 -0
  284. data/lib/chef/recipe.rb +2 -19
  285. data/lib/chef/resource/apt_package.rb +3 -3
  286. data/lib/chef/resource/bash.rb +3 -3
  287. data/lib/chef/resource/batch.rb +4 -4
  288. data/lib/chef/resource/bff_package.rb +36 -0
  289. data/lib/chef/resource/breakpoint.rb +3 -3
  290. data/lib/chef/resource/cron.rb +5 -5
  291. data/lib/chef/resource/csh.rb +3 -3
  292. data/lib/chef/resource/deploy.rb +16 -3
  293. data/lib/chef/resource/deploy_revision.rb +6 -6
  294. data/lib/chef/resource/directory.rb +2 -2
  295. data/lib/chef/resource/dpkg_package.rb +4 -4
  296. data/lib/chef/resource/easy_install_package.rb +1 -1
  297. data/lib/chef/resource/erl_call.rb +1 -1
  298. data/lib/chef/resource/freebsd_package.rb +4 -4
  299. data/lib/chef/resource/group.rb +15 -6
  300. data/lib/chef/resource/http_request.rb +6 -6
  301. data/lib/chef/resource/ifconfig.rb +4 -4
  302. data/lib/chef/resource/ips_package.rb +2 -2
  303. data/lib/chef/resource/log.rb +12 -11
  304. data/lib/chef/resource/macports_package.rb +2 -2
  305. data/lib/chef/resource/mount.rb +11 -12
  306. data/lib/chef/resource/ohai.rb +3 -3
  307. data/lib/chef/resource/pacman_package.rb +4 -4
  308. data/lib/chef/resource/perl.rb +3 -3
  309. data/lib/chef/resource/portage_package.rb +4 -4
  310. data/lib/chef/resource/powershell_script.rb +3 -3
  311. data/lib/chef/resource/python.rb +3 -3
  312. data/lib/chef/resource/route.rb +4 -4
  313. data/lib/chef/resource/rpm_package.rb +2 -2
  314. data/lib/chef/resource/ruby.rb +3 -3
  315. data/lib/chef/resource/ruby_block.rb +3 -3
  316. data/lib/chef/resource/scm.rb +10 -2
  317. data/lib/chef/resource/script.rb +5 -5
  318. data/lib/chef/resource/service.rb +5 -5
  319. data/lib/chef/resource/smartos_package.rb +8 -6
  320. data/lib/chef/resource/solaris_package.rb +8 -7
  321. data/lib/chef/resource/subversion.rb +3 -3
  322. data/lib/chef/resource/timestamped_deploy.rb +4 -4
  323. data/lib/chef/resource/user.rb +13 -13
  324. data/lib/chef/resource/windows_script.rb +6 -6
  325. data/lib/chef/resource/yum_package.rb +2 -2
  326. data/lib/chef/resource_collection.rb +1 -1
  327. data/lib/chef/resource_collection/stepable_iterator.rb +22 -22
  328. data/lib/chef/resource_definition.rb +8 -8
  329. data/lib/chef/resource_definition_list.rb +2 -2
  330. data/lib/chef/resource_reporter.rb +8 -2
  331. data/lib/chef/resources.rb +2 -0
  332. data/lib/chef/rest.rb +70 -334
  333. data/lib/chef/role.rb +17 -13
  334. data/lib/chef/run_context.rb +14 -0
  335. data/lib/chef/run_context/cookbook_compiler.rb +3 -3
  336. data/lib/chef/run_lock.rb +73 -20
  337. data/lib/chef/server_api.rb +41 -0
  338. data/lib/chef/shell.rb +3 -19
  339. data/lib/chef/shell/shell_session.rb +1 -1
  340. data/lib/chef/streaming_cookbook_uploader.rb +30 -26
  341. data/lib/chef/tasks/chef_repo.rake +17 -17
  342. data/lib/chef/util/backup.rb +2 -1
  343. data/lib/chef/util/diff.rb +76 -33
  344. data/lib/chef/util/windows.rb +2 -2
  345. data/lib/chef/util/windows/net_group.rb +2 -2
  346. data/lib/chef/util/windows/net_use.rb +2 -2
  347. data/lib/chef/util/windows/net_user.rb +3 -3
  348. data/lib/chef/util/windows/volume.rb +3 -3
  349. data/lib/chef/version.rb +1 -1
  350. data/lib/chef/win32/api/file.rb +1 -1
  351. data/lib/chef/win32/api/synchronization.rb +89 -0
  352. data/lib/chef/win32/handle.rb +1 -1
  353. data/lib/chef/win32/mutex.rb +94 -0
  354. data/lib/chef/win32/security/ace.rb +1 -1
  355. data/lib/chef/win32/security/sid.rb +1 -1
  356. data/lib/chef/win32/version.rb +5 -3
  357. data/spec/data/bootstrap/no_proxy.erb +2 -0
  358. data/spec/data/cookbooks/openldap/metadata.rb +8 -0
  359. data/spec/data/cookbooks/preseed/files/default/preseed-template.seed +4 -0
  360. data/spec/data/trusted_certs/example.crt +22 -0
  361. data/spec/data/trusted_certs/intermediate.pem +27 -0
  362. data/spec/data/trusted_certs/opscode.pem +38 -0
  363. data/spec/data/trusted_certs/root.pem +22 -0
  364. data/spec/functional/assets/PkgA.1.0.0.0.bff +0 -0
  365. data/spec/functional/assets/PkgA.2.0.0.0.bff +0 -0
  366. data/spec/functional/assets/dummy-1-0.aix6.1.noarch.rpm +0 -0
  367. data/spec/functional/assets/dummy-2-0.aix6.1.noarch.rpm +0 -0
  368. data/spec/functional/assets/mytest-1.0-1.noarch.rpm +0 -0
  369. data/spec/functional/assets/mytest-2.0-1.noarch.rpm +0 -0
  370. data/spec/functional/knife/cookbook_delete_spec.rb +4 -7
  371. data/spec/functional/knife/exec_spec.rb +0 -3
  372. data/spec/functional/knife/ssh_spec.rb +2 -6
  373. data/spec/functional/resource/base.rb +41 -0
  374. data/spec/functional/resource/batch_spec.rb +6 -33
  375. data/spec/functional/resource/bff_spec.rb +122 -0
  376. data/spec/functional/resource/cron_spec.rb +147 -0
  377. data/spec/functional/resource/group_spec.rb +204 -0
  378. data/spec/functional/resource/ifconfig_spec.rb +163 -0
  379. data/spec/functional/resource/link_spec.rb +4 -4
  380. data/spec/functional/resource/mount_spec.rb +207 -0
  381. data/spec/functional/resource/package_spec.rb +95 -17
  382. data/spec/functional/resource/powershell_spec.rb +21 -22
  383. data/spec/functional/resource/registry_spec.rb +5 -19
  384. data/spec/functional/resource/remote_file_spec.rb +14 -0
  385. data/spec/functional/resource/rpm_spec.rb +122 -0
  386. data/spec/functional/resource/template_spec.rb +11 -44
  387. data/spec/functional/resource/user_spec.rb +2 -1
  388. data/spec/functional/run_lock_spec.rb +48 -5
  389. data/spec/functional/shell_spec.rb +46 -26
  390. data/spec/functional/tiny_server_spec.rb +2 -2
  391. data/spec/functional/version_spec.rb +35 -0
  392. data/spec/functional/win32/versions_spec.rb +3 -3
  393. data/spec/integration/client/client_spec.rb +146 -0
  394. data/spec/integration/knife/chef_fs_data_store_spec.rb +353 -0
  395. data/spec/integration/knife/chef_repo_path_spec.rb +72 -19
  396. data/spec/integration/knife/common_options_spec.rb +103 -0
  397. data/spec/integration/knife/download_spec.rb +38 -2
  398. data/spec/integration/knife/raw_spec.rb +63 -0
  399. data/spec/integration/knife/upload_spec.rb +20 -4
  400. data/spec/integration/solo/solo_spec.rb +78 -25
  401. data/spec/spec_helper.rb +35 -1
  402. data/spec/support/lib/chef/provider/easy.rb +4 -4
  403. data/spec/support/lib/chef/provider/snakeoil.rb +4 -4
  404. data/spec/support/lib/chef/resource/cat.rb +5 -5
  405. data/spec/support/lib/chef/resource/with_state.rb +37 -0
  406. data/spec/support/lib/library_load_order.rb +22 -0
  407. data/spec/support/platform_helpers.rb +8 -0
  408. data/spec/support/shared/functional/file_resource.rb +4 -22
  409. data/spec/support/shared/functional/windows_script.rb +48 -0
  410. data/spec/support/shared/integration/integration_helper.rb +5 -22
  411. data/spec/support/shared/integration/knife_support.rb +3 -3
  412. data/spec/support/shared/unit/script_resource.rb +7 -7
  413. data/spec/support/shared/unit/windows_script_resource.rb +7 -7
  414. data/spec/tiny_server.rb +2 -2
  415. data/spec/unit/api_client/registration_spec.rb +1 -1
  416. data/spec/unit/api_client_spec.rb +25 -2
  417. data/spec/unit/application/apply.rb +1 -9
  418. data/spec/unit/application/client_spec.rb +19 -44
  419. data/spec/unit/application/solo_spec.rb +10 -50
  420. data/spec/unit/application_spec.rb +51 -80
  421. data/spec/unit/checksum/storage/filesystem_spec.rb +3 -2
  422. data/spec/unit/chef_fs/file_system/operation_failed_error_spec.rb +47 -0
  423. data/spec/unit/chef_spec.rb +2 -2
  424. data/spec/unit/client_spec.rb +2 -18
  425. data/spec/unit/config_fetcher_spec.rb +98 -0
  426. data/spec/unit/config_spec.rb +107 -29
  427. data/spec/unit/cookbook/metadata_spec.rb +50 -50
  428. data/spec/unit/cookbook/synchronizer_spec.rb +3 -3
  429. data/spec/unit/cookbook/syntax_check_spec.rb +1 -2
  430. data/spec/unit/cookbook_loader_spec.rb +28 -12
  431. data/spec/unit/cookbook_manifest_spec.rb +11 -11
  432. data/spec/unit/cookbook_site_streaming_uploader.rb +200 -0
  433. data/spec/unit/cookbook_version_spec.rb +16 -0
  434. data/spec/unit/daemon_spec.rb +0 -132
  435. data/spec/unit/data_bag_item_spec.rb +6 -6
  436. data/spec/unit/data_bag_spec.rb +6 -8
  437. data/spec/unit/digester_spec.rb +2 -2
  438. data/spec/unit/encrypted_data_bag_item_spec.rb +0 -15
  439. data/spec/unit/file_cache_spec.rb +1 -1
  440. data/spec/unit/formatters/error_inspectors/compile_error_inspector_spec.rb +4 -4
  441. data/spec/unit/formatters/error_inspectors/cookbook_resolve_error_inspector_spec.rb +2 -2
  442. data/spec/unit/formatters/error_inspectors/cookbook_sync_error_inspector_spec.rb +2 -2
  443. data/spec/unit/formatters/error_inspectors/node_load_error_inspector_spec.rb +2 -2
  444. data/spec/unit/formatters/error_inspectors/registration_error_inspector_spec.rb +2 -2
  445. data/spec/unit/formatters/error_inspectors/resource_failure_inspector_spec.rb +4 -4
  446. data/spec/unit/formatters/error_inspectors/run_list_expansion_error_inspector_spec.rb +2 -2
  447. data/spec/unit/handler_spec.rb +5 -5
  448. data/spec/unit/http/ssl_policies_spec.rb +170 -0
  449. data/spec/unit/knife/bootstrap_spec.rb +31 -14
  450. data/spec/unit/knife/client_bulk_delete_spec.rb +8 -8
  451. data/spec/unit/knife/client_create_spec.rb +2 -2
  452. data/spec/unit/knife/client_delete_spec.rb +2 -2
  453. data/spec/unit/knife/client_edit_spec.rb +2 -2
  454. data/spec/unit/knife/client_list_spec.rb +2 -2
  455. data/spec/unit/knife/client_reregister_spec.rb +2 -2
  456. data/spec/unit/knife/client_show_spec.rb +2 -2
  457. data/spec/unit/knife/config_file_selection_spec.rb +53 -36
  458. data/spec/unit/knife/configure_spec.rb +0 -6
  459. data/spec/unit/knife/cookbook_create_spec.rb +1 -12
  460. data/spec/unit/knife/cookbook_metadata_from_file_spec.rb +2 -2
  461. data/spec/unit/knife/cookbook_show_spec.rb +3 -3
  462. data/spec/unit/knife/cookbook_site_install_spec.rb +1 -1
  463. data/spec/unit/knife/core/bootstrap_context_spec.rb +10 -2
  464. data/spec/unit/knife/core/ui_spec.rb +118 -0
  465. data/spec/unit/knife/data_bag_show_spec.rb +2 -2
  466. data/spec/unit/knife/environment_from_file_spec.rb +2 -2
  467. data/spec/unit/knife/index_rebuild_spec.rb +1 -1
  468. data/spec/unit/knife/node_delete_spec.rb +3 -3
  469. data/spec/unit/knife/node_edit_spec.rb +35 -8
  470. data/spec/unit/knife/node_list_spec.rb +3 -3
  471. data/spec/unit/knife/node_run_list_add_spec.rb +3 -3
  472. data/spec/unit/knife/node_show_spec.rb +3 -3
  473. data/spec/unit/knife/role_create_spec.rb +3 -3
  474. data/spec/unit/knife/role_delete_spec.rb +3 -3
  475. data/spec/unit/knife/role_list_spec.rb +2 -2
  476. data/spec/unit/knife/ssh_spec.rb +1 -8
  477. data/spec/unit/knife_spec.rb +0 -2
  478. data/spec/unit/log_spec.rb +2 -2
  479. data/spec/unit/mash_spec.rb +2 -2
  480. data/spec/unit/mixin/checksum_spec.rb +3 -3
  481. data/spec/unit/mixin/command_spec.rb +1 -1
  482. data/spec/unit/mixin/convert_to_class_name_spec.rb +7 -7
  483. data/spec/unit/mixin/deprecation_spec.rb +2 -2
  484. data/spec/unit/mixin/params_validate_spec.rb +72 -72
  485. data/spec/unit/mixin/securable_spec.rb +0 -14
  486. data/spec/unit/mixin/shell_out_spec.rb +1 -1
  487. data/spec/unit/mixin/template_spec.rb +34 -0
  488. data/spec/unit/mixin/windows_architecture_helper_spec.rb +5 -5
  489. data/spec/unit/mixin/xml_escape_spec.rb +2 -2
  490. data/spec/unit/node/attribute_spec.rb +11 -11
  491. data/spec/unit/node/immutable_collections_spec.rb +2 -2
  492. data/spec/unit/node_spec.rb +5 -0
  493. data/spec/unit/platform_spec.rb +36 -35
  494. data/spec/unit/provider/cron/{solaris_spec.rb → unix_spec.rb} +6 -6
  495. data/spec/unit/provider/cron_spec.rb +21 -3
  496. data/spec/unit/provider/deploy/timestamped_spec.rb +5 -5
  497. data/spec/unit/provider/deploy_spec.rb +21 -7
  498. data/spec/unit/provider/env_spec.rb +2 -2
  499. data/spec/unit/provider/execute_spec.rb +2 -2
  500. data/spec/unit/provider/file/content_spec.rb +0 -8
  501. data/spec/unit/provider/git_spec.rb +29 -9
  502. data/spec/unit/provider/group/dscl_spec.rb +12 -12
  503. data/spec/unit/provider/group/gpasswd_spec.rb +2 -2
  504. data/spec/unit/provider/group/groupadd_spec.rb +14 -0
  505. data/spec/unit/provider/group/groupmod_spec.rb +13 -13
  506. data/spec/unit/provider/group/pw_spec.rb +16 -16
  507. data/spec/unit/provider/group/usermod_spec.rb +10 -9
  508. data/spec/unit/provider/group/windows_spec.rb +14 -0
  509. data/spec/unit/provider/group_spec.rb +29 -29
  510. data/spec/unit/provider/http_request_spec.rb +15 -15
  511. data/spec/unit/provider/ifconfig/aix_spec.rb +180 -0
  512. data/spec/unit/provider/ifconfig_spec.rb +9 -9
  513. data/spec/unit/provider/link_spec.rb +2 -2
  514. data/spec/unit/provider/log_spec.rb +8 -8
  515. data/spec/unit/provider/mdadm_spec.rb +14 -11
  516. data/spec/unit/provider/mount/aix_spec.rb +237 -0
  517. data/spec/unit/provider/mount/mount_spec.rb +2 -0
  518. data/spec/unit/provider/mount/windows_spec.rb +2 -2
  519. data/spec/unit/provider/mount_spec.rb +6 -6
  520. data/spec/unit/provider/package/aix_spec.rb +171 -0
  521. data/spec/unit/provider/package/apt_spec.rb +130 -171
  522. data/spec/unit/provider/package/dpkg_spec.rb +3 -3
  523. data/spec/unit/provider/package/freebsd_spec.rb +28 -0
  524. data/spec/unit/provider/package/ips_spec.rb +1 -1
  525. data/spec/unit/provider/package/rpm_spec.rb +15 -15
  526. data/spec/unit/provider/package/smartos_spec.rb +21 -3
  527. data/spec/unit/provider/package_spec.rb +4 -2
  528. data/spec/unit/provider/powershell_spec.rb +3 -3
  529. data/spec/unit/provider/remote_directory_spec.rb +2 -2
  530. data/spec/unit/provider/remote_file/ftp_spec.rb +0 -5
  531. data/spec/unit/provider/remote_file/http_spec.rb +12 -28
  532. data/spec/unit/provider/remote_file/local_file_spec.rb +2 -1
  533. data/spec/unit/provider/route_spec.rb +2 -2
  534. data/spec/unit/provider/ruby_block_spec.rb +2 -2
  535. data/spec/unit/provider/service/arch_service_spec.rb +17 -17
  536. data/spec/unit/provider/service/debian_service_spec.rb +242 -152
  537. data/spec/unit/provider/service/freebsd_service_spec.rb +9 -9
  538. data/spec/unit/provider/service/gentoo_service_spec.rb +9 -9
  539. data/spec/unit/provider/service/init_service_spec.rb +11 -11
  540. data/spec/unit/provider/service/insserv_service_spec.rb +5 -5
  541. data/spec/unit/provider/service/invokercd_service_spec.rb +10 -10
  542. data/spec/unit/provider/service/redhat_spec.rb +6 -6
  543. data/spec/unit/provider/service/simple_service_spec.rb +6 -6
  544. data/spec/unit/provider/service/solaris_smf_service_spec.rb +4 -4
  545. data/spec/unit/provider/service/systemd_service_spec.rb +3 -3
  546. data/spec/unit/provider/service/upstart_service_spec.rb +5 -5
  547. data/spec/unit/provider/service/windows_spec.rb +7 -7
  548. data/spec/unit/provider/subversion_spec.rb +1 -1
  549. data/spec/unit/provider/user/dscl_spec.rb +21 -21
  550. data/spec/unit/provider/user/pw_spec.rb +2 -2
  551. data/spec/unit/provider/user/windows_spec.rb +5 -5
  552. data/spec/unit/provider/user_spec.rb +39 -47
  553. data/spec/unit/resource/apt_package_spec.rb +6 -6
  554. data/spec/unit/resource/bash_spec.rb +5 -5
  555. data/spec/unit/resource/batch_spec.rb +7 -7
  556. data/spec/unit/resource/breakpoint_spec.rb +8 -8
  557. data/spec/unit/resource/chef_gem_spec.rb +6 -6
  558. data/spec/unit/resource/cookbook_file_spec.rb +11 -11
  559. data/spec/unit/resource/cron_spec.rb +15 -15
  560. data/spec/unit/resource/csh_spec.rb +5 -5
  561. data/spec/unit/resource/deploy_revision_spec.rb +6 -6
  562. data/spec/unit/resource/deploy_spec.rb +50 -36
  563. data/spec/unit/resource/directory_spec.rb +1 -1
  564. data/spec/unit/resource/dpkg_package_spec.rb +6 -6
  565. data/spec/unit/resource/env_spec.rb +1 -1
  566. data/spec/unit/resource/erl_call_spec.rb +1 -1
  567. data/spec/unit/resource/freebsd_package_spec.rb +6 -6
  568. data/spec/unit/resource/gem_package_spec.rb +6 -6
  569. data/spec/unit/resource/git_spec.rb +8 -8
  570. data/spec/unit/resource/group_spec.rb +11 -11
  571. data/spec/unit/resource/http_request_spec.rb +7 -7
  572. data/spec/unit/resource/ifconfig_spec.rb +1 -1
  573. data/spec/unit/resource/ips_package_spec.rb +6 -6
  574. data/spec/unit/resource/link_spec.rb +1 -1
  575. data/spec/unit/resource/log_spec.rb +13 -10
  576. data/spec/unit/resource/macports_package_spec.rb +2 -2
  577. data/spec/unit/resource/mdadm_spec.rb +3 -3
  578. data/spec/unit/resource/mount_spec.rb +13 -13
  579. data/spec/unit/resource/ohai_spec.rb +1 -1
  580. data/spec/unit/resource/package_spec.rb +6 -6
  581. data/spec/unit/resource/pacman_package_spec.rb +6 -6
  582. data/spec/unit/resource/perl_spec.rb +5 -5
  583. data/spec/unit/resource/portage_package_spec.rb +6 -6
  584. data/spec/unit/resource/powershell_spec.rb +5 -5
  585. data/spec/unit/resource/python_spec.rb +5 -5
  586. data/spec/unit/resource/registry_key_spec.rb +2 -2
  587. data/spec/unit/resource/remote_directory_spec.rb +9 -9
  588. data/spec/unit/resource/remote_file_spec.rb +4 -4
  589. data/spec/unit/resource/route_spec.rb +13 -13
  590. data/spec/unit/resource/rpm_package_spec.rb +2 -2
  591. data/spec/unit/resource/ruby_block_spec.rb +4 -4
  592. data/spec/unit/resource/ruby_spec.rb +5 -5
  593. data/spec/unit/resource/scm_spec.rb +14 -1
  594. data/spec/unit/resource/script_spec.rb +5 -5
  595. data/spec/unit/resource/service_spec.rb +18 -18
  596. data/spec/unit/resource/smartos_package_spec.rb +6 -6
  597. data/spec/unit/resource/solaris_package_spec.rb +57 -0
  598. data/spec/unit/resource/subversion_spec.rb +6 -6
  599. data/spec/unit/resource/timestamped_deploy_spec.rb +4 -4
  600. data/spec/unit/resource/user_spec.rb +13 -13
  601. data/spec/unit/resource/yum_package_spec.rb +7 -7
  602. data/spec/unit/resource_collection/stepable_iterator_spec.rb +21 -21
  603. data/spec/unit/resource_definition_spec.rb +23 -23
  604. data/spec/unit/resource_reporter_spec.rb +27 -0
  605. data/spec/unit/rest/auth_credentials_spec.rb +0 -94
  606. data/spec/unit/rest_spec.rb +117 -99
  607. data/spec/unit/role_spec.rb +57 -4
  608. data/spec/unit/run_context/cookbook_compiler_spec.rb +4 -20
  609. data/spec/unit/run_context_spec.rb +44 -3
  610. data/spec/unit/run_list/run_list_item_spec.rb +1 -1
  611. data/spec/unit/run_lock_spec.rb +6 -3
  612. data/spec/unit/scan_access_control_spec.rb +2 -2
  613. data/spec/unit/search/query_spec.rb +3 -3
  614. data/spec/unit/util/backup_spec.rb +6 -13
  615. data/spec/unit/util/diff_spec.rb +36 -53
  616. data/spec/unit/version/platform_spec.rb +3 -3
  617. data/spec/unit/version_class_spec.rb +5 -5
  618. data/spec/unit/version_constraint/platform_spec.rb +2 -2
  619. data/spec/unit/windows_service_spec.rb +54 -0
  620. metadata +290 -108
  621. checksums.yaml +0 -7
  622. data/distro/common/man/man1/knife-index.1 +0 -29
  623. data/distro/common/man/man8/chef-expander.8 +0 -97
  624. data/distro/common/man/man8/chef-expanderctl.8 +0 -62
  625. data/distro/common/man/man8/chef-server-webui.8 +0 -155
  626. data/distro/common/man/man8/chef-server.8 +0 -147
  627. data/distro/common/man/man8/chef-solr.8 +0 -122
  628. data/lib/chef/chef_fs/raw_request.rb +0 -79
@@ -0,0 +1,167 @@
1
+ .TH "KNIFE-LIST" "1" "Chef 11.8.0" "" "knife list"
2
+ .SH NAME
3
+ knife-list \- The man page for the knife list subcommand.
4
+ .
5
+ .nr rst2man-indent-level 0
6
+ .
7
+ .de1 rstReportMargin
8
+ \\$1 \\n[an-margin]
9
+ level \\n[rst2man-indent-level]
10
+ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11
+ -
12
+ \\n[rst2man-indent0]
13
+ \\n[rst2man-indent1]
14
+ \\n[rst2man-indent2]
15
+ ..
16
+ .de1 INDENT
17
+ .\" .rstReportMargin pre:
18
+ . RS \\$1
19
+ . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
20
+ . nr rst2man-indent-level +1
21
+ .\" .rstReportMargin post:
22
+ ..
23
+ .de UNINDENT
24
+ . RE
25
+ .\" indent \\n[an-margin]
26
+ .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
27
+ .nr rst2man-indent-level -1
28
+ .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
+ .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30
+ ..
31
+ .\" Man page generated from reStructuredText.
32
+ .
33
+ .sp
34
+ The \fBknife list\fP subcommand is used to view a list of objects on the server. This subcommand works similar to \fBknife cookbook list\fP, \fBknife data bag list\fP, \fBknife environment list\fP, \fBknife node list\fP, and \fBknife role list\fP, but with a single verb (and a single action).
35
+ .sp
36
+ \fBCommon Options\fP
37
+ .sp
38
+ The following options can be run with all Knife sub\-commands and plug\-ins:
39
+ .INDENT 0.0
40
+ .TP
41
+ .B \fB\-c CONFIG\fP, \fB\-\-config CONFIG\fP
42
+ The configuration file to use.
43
+ .TP
44
+ .B \fB\-\-color\fP
45
+ Indicates that colored output will be used.
46
+ .TP
47
+ .B \fB\-d\fP, \fB\-\-disable\-editing\fP
48
+ Indicates that $EDITOR will not be opened; data will be accepted as\-is.
49
+ .TP
50
+ .B \fB\-\-defaults\fP
51
+ Indicates that Knife will use the default value, instead of asking a user to provide one.
52
+ .TP
53
+ .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
54
+ The $EDITOR that is used for all interactive commands.
55
+ .TP
56
+ .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
57
+ The name of the environment. When this option is added to a command, the command will run only against the named environment.
58
+ .TP
59
+ .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
60
+ Indicates that the private key will be saved to a specified file name.
61
+ .TP
62
+ .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
63
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
64
+ .TP
65
+ .B \fB\-h\fP, \fB\-\-help\fP
66
+ Shows help for the command.
67
+ .TP
68
+ .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
69
+ The private key that Knife will use to sign requests made by the API client to the server.
70
+ .TP
71
+ .B \fB\-\-no\-color\fP
72
+ Indicates that color will not be used in the output.
73
+ .TP
74
+ .B \fB\-p PASSWORD\fP, \fB\-\-password PASSWORD\fP
75
+ The user password.
76
+ .TP
77
+ .B \fB\-\-print\-after\fP
78
+ Indicates that data will be shown after a destructive operation.
79
+ .TP
80
+ .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
81
+ The URL for the server.
82
+ .TP
83
+ .B \fB\-u USER\fP, \fB\-\-user USER\fP
84
+ The user name used by Knife to sign requests made by the API client to the server. Authentication will fail if the user name does not match the private key.
85
+ .TP
86
+ .B \fB\-v\fP, \fB\-\-version\fP
87
+ The version of the chef\-client.
88
+ .TP
89
+ .B \fB\-V\fP, \fB\-\-verbose\fP
90
+ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
91
+ .TP
92
+ .B \fB\-y\fP, \fB\-\-yes\fP
93
+ Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
94
+ .UNINDENT
95
+ .sp
96
+ \fBSyntax\fP
97
+ .sp
98
+ This argument has the following syntax:
99
+ .sp
100
+ .nf
101
+ .ft C
102
+ $ knife list [PATTERN...] (options)
103
+ .ft P
104
+ .fi
105
+ .sp
106
+ \fBOptions\fP
107
+ .sp
108
+ This subcommand has the following options:
109
+ .INDENT 0.0
110
+ .TP
111
+ .B \fB\-\-chef\-repo\-path PATH\fP
112
+ The path to the chef\-repo. This setting will override the default path to the chef\-repo. Default: same as specified by \fBchef_repo_path\fP in config.rb.
113
+ .TP
114
+ .B \fB\-\-concurrency\fP
115
+ The number of allowed concurrent connections. Default: \fB10\fP.
116
+ .TP
117
+ .B \fB\-d\fP
118
+ Indicates that a directory\(aqs children will not be shown when a directory matches a pattern. Default value: \fBfalse\fP.
119
+ .TP
120
+ .B \fB\-f\fP, \fB\-\-flat\fP
121
+ Indicates that a list of file names will be shown. Set to \fBfalse\fP to view ls\-like output. Default: \fBfalse\fP.
122
+ .TP
123
+ .B \fB\-\-local\fP
124
+ Indicates that only contents of the local directory will be returned. Default: \fBfalse\fP.
125
+ .TP
126
+ .B \fB\-1\fP
127
+ Indicates that only one column of results will be shown. Default: \fBfalse\fP.
128
+ .TP
129
+ .B \fB\-p\fP
130
+ Indicates that trailing slashes (/) will be shown for directories. Default: \fBfalse\fP.
131
+ .TP
132
+ .B \fB\-R\fP
133
+ Indicates that directories will be listed recursively. Default: \fBfalse\fP.
134
+ .TP
135
+ .B \fB\-\-repo\-mode MODE\fP
136
+ The layout of the local chef\-repo. Possible values: \fBstatic\fP, \fBeverything\fP, or \fBhosted_everything\fP. Use \fBstatic\fP for just roles, environments, cookbooks, and data bags. By default, \fBeverything\fP and \fBhosted_everything\fP are dynamically selected depending on the server type. Default: \fBeverything\fP / \fBhosted_everything\fP.
137
+ .UNINDENT
138
+ .sp
139
+ \fBExamples\fP
140
+ .sp
141
+ For example, to view a list of roles on the server:
142
+ .sp
143
+ .nf
144
+ .ft C
145
+ $ knife list roles/
146
+ .ft P
147
+ .fi
148
+ .sp
149
+ To view a list of roles and environments on the server:
150
+ .sp
151
+ .nf
152
+ .ft C
153
+ $ knife list roles/ environments/
154
+ .ft P
155
+ .fi
156
+ .sp
157
+ To view a list of absolutely everything on the server:
158
+ .sp
159
+ .nf
160
+ .ft C
161
+ $ knife list \-R /
162
+ .ft P
163
+ .fi
164
+ .SH AUTHOR
165
+ Opscode
166
+ .\" Generated by docutils manpage writer.
167
+ .
@@ -1,134 +1,578 @@
1
- .\" generated with Ronn/v0.7.3
2
- .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
- .
4
- .TH "KNIFE\-NODE" "1" "October 2013" "Chef 11.6.2" "Chef Manual"
5
- .
6
- .SH "NAME"
7
- \fBknife\-node\fR \- Manage the hosts in your infrastructure
8
- .
9
- .SH "SYNOPSIS"
10
- \fBknife\fR \fBnode\fR \fIsub\-command\fR \fI(options)\fR
11
- .
12
- .SH "DESCRIPTION"
13
- Nodes are data structures that represent hosts configured with Chef\. Nodes have a \fBname\fR, a String that uniquely identifies the node, \fBattributes\fR, a nested Hash of properties that describe how the host should be configured, a \fBchef_environment\fR, a String representing the environment to which the node belongs, and a \fBrun_list\fR, an ordered list of \fBrecipes\fR or \fBroles\fR that chef\-client should apply when configuring a host\.
14
- .
15
- .P
16
- When a host communicates with a Chef Server, it authenticates using its \fBnode_name\fR for identification and signs its reqests with a private key\. The Server validates the request by looking up a \fBclient\fR object with a name identical to the \fBnode_name\fR submitted with the request and verifes the signature using the public key for that \fBclient\fR object\. \fBNOTE\fR that the \fBclient\fR is a different object in the system\. It is associated with a node by virtue of having a matching name\.
17
- .
18
- .P
19
- By default \fBchef\-client\fR(8) will create a node using the FQDN of the host for the node name, though this may be overridden by configuration settings\.
20
- .
21
- .SH "NODE SUB\-COMMANDS"
22
- The following \fBnode\fR subcommands are available:
23
- .
24
- .SH "BULK DELETE"
25
- \fBknife node bulk delete\fR \fIregex\fR \fI(options)\fR
26
- .
27
- .P
28
- Deletes nodes for which the name matches the regular expression \fIregex\fR on the Chef Server\. The regular expression should be given in quotes, and should not be surrounded with forward slashes (as is typical of regular expression literals in scripting languages)\.
29
- .
30
- .SH "CREATE"
31
- \fBknife node create\fR \fIname\fR \fI(options)\fR
32
- .
33
- .P
34
- Create a new node\. Unless the \-\-disable\-editing option is given, an empty node object will be created and displayed in your text editor\. If the editor exits with a successful exit status, the node data will be posted to the Chef Server to create the node\.
35
- .
36
- .SH "DELETE"
37
- \fBknife node delete\fR \fIname\fR \fI(options)\fR
38
- .
39
- .P
40
- Deletes the node identified by \fIname\fR on the Chef Server\.
41
- .
42
- .SH "EDIT"
43
- \fBknife node edit\fR \fIname\fR \fI(options)\fR
44
- .
1
+ .TH "KNIFE-NODE" "1" "Chef 11.8.0" "" "knife node"
2
+ .SH NAME
3
+ knife-node \- The man page for the knife node subcommand.
4
+ .
5
+ .nr rst2man-indent-level 0
6
+ .
7
+ .de1 rstReportMargin
8
+ \\$1 \\n[an-margin]
9
+ level \\n[rst2man-indent-level]
10
+ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11
+ -
12
+ \\n[rst2man-indent0]
13
+ \\n[rst2man-indent1]
14
+ \\n[rst2man-indent2]
15
+ ..
16
+ .de1 INDENT
17
+ .\" .rstReportMargin pre:
18
+ . RS \\$1
19
+ . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
20
+ . nr rst2man-indent-level +1
21
+ .\" .rstReportMargin post:
22
+ ..
23
+ .de UNINDENT
24
+ . RE
25
+ .\" indent \\n[an-margin]
26
+ .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
27
+ .nr rst2man-indent-level -1
28
+ .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
+ .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30
+ ..
31
+ .\" Man page generated from reStructuredText.
32
+ .
33
+ .sp
34
+ A node is any physical, virtual, or cloud machine that is configured to be maintained by a chef\-client.
35
+ .sp
36
+ The \fBknife node\fP subcommand is used to manage the nodes that exist on a server.
37
+ .sp
38
+ This subcommand has the following syntax:
39
+ .sp
40
+ .nf
41
+ .ft C
42
+ $ knife node [ARGUMENT] (options)
43
+ .ft P
44
+ .fi
45
+ .SH COMMON OPTIONS
46
+ .sp
47
+ The following options can be run with all Knife sub\-commands and plug\-ins:
48
+ .INDENT 0.0
45
49
  .TP
46
- \fB\-a\fR, \fB\-\-all\fR
47
- Display all node data in the editor\. By default, default, override, and automatic attributes are not shown\.
48
- .
49
- .P
50
- Edit the node identified by \fIname\fR\. Like \fBknife node create\fR, the node will be displayed in your text editor unless the \-n option is present\.
51
- .
52
- .SH "FROM FILE"
53
- \fBknife node from file\fR \fIfile\fR \fI(options)\fR
54
- .
55
- .P
56
- Create a node from a JSON format \fIfile\fR\.
57
- .
58
- .SH "LIST"
59
- \fBknife node list\fR \fI(options)\fR
60
- .
50
+ .B \fB\-c CONFIG\fP, \fB\-\-config CONFIG\fP
51
+ The configuration file to use.
61
52
  .TP
62
- \fB\-w\fR, \fB\-\-with\-uri\fR
63
- Show corresponding URIs
64
- .
65
- .P
66
- List all nodes\.
67
- .
68
- .SH "RUN_LIST ADD"
69
- \fBknife node run_list add\fR \fIname\fR \fIrun list item\fR \fI(options)\fR
70
- .
53
+ .B \fB\-\-color\fP
54
+ Indicates that colored output will be used.
71
55
  .TP
72
- \fB\-a\fR, \fB\-\-after ITEM\fR
73
- Place the ENTRY in the run list after ITEM
74
- .
75
- .P
76
- Add the \fIrun list item\fR to the node\'s \fBrun_list\fR\. See Run list
77
- .
78
- .SH "RUN_LIST REMOVE"
79
- \fBknife node run_list remove\fR \fInode name\fR \fIrun list item\fR \fI(options)\fR
80
- .
81
- .P
82
- Remove the \fIrun list item\fR from the node\'s \fBrun_list\fR\.
83
- .
84
- .SH "SHOW"
85
- \fBknife node show\fR \fInode name\fR \fI(options)\fR
86
- .
56
+ .B \fB\-d\fP, \fB\-\-disable\-editing\fP
57
+ Indicates that $EDITOR will not be opened; data will be accepted as\-is.
87
58
  .TP
88
- \fB\-a\fR, \fB\-\-attribute [ATTR]\fR
89
- Show only one attribute
90
- .
59
+ .B \fB\-\-defaults\fP
60
+ Indicates that Knife will use the default value, instead of asking a user to provide one.
91
61
  .TP
92
- \fB\-r\fR, \fB\-\-run\-list\fR
93
- Show only the run list
94
- .
62
+ .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
63
+ The $EDITOR that is used for all interactive commands.
95
64
  .TP
96
- \fB\-F\fR, \fB\-\-format FORMAT\fR
97
- Display the node in a different format\.
98
- .
65
+ .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
66
+ The name of the environment. When this option is added to a command, the command will run only against the named environment.
99
67
  .TP
100
- \fB\-m\fR, \fB\-\-medium\fR
101
- Display more, but not all, of the node\'s data when using the default \fIsummary\fR format
102
- .
103
- .P
104
- Displays the node identified by \fInode name\fR on stdout\.
105
- .
106
- .SH "RUN LIST ITEM FORMAT"
107
- Run list items may be either roles or recipes\. When adding a role to a run list, the correct syntax is "role[ROLE_NAME]"
108
- .
109
- .P
110
- When adding a recipe to a run list, there are several valid formats:
111
- .
68
+ .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
69
+ Indicates that the private key will be saved to a specified file name.
112
70
  .TP
113
- Fully Qualified Format
114
- "recipe[COOKBOOK::RECIPE_NAME]", for example, "recipe[chef::client]"
115
- .
71
+ .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
72
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
116
73
  .TP
117
- Cookbook Recipe Format
118
- For brevity, the recipe part of the fully qualified format may be omitted, and recipes specified as "COOKBOOK::RECIPE_NAME", e\.g\., "chef::client"
119
- .
74
+ .B \fB\-h\fP, \fB\-\-help\fP
75
+ Shows help for the command.
120
76
  .TP
121
- Default Recipe Format
122
- When adding the default recipe of a cookbook to a run list, the recipe name may be omitted as well, e\.g\., "chef::default" may be written as just "chef"
123
- .
124
- .SH "SEE ALSO"
125
- \fBknife\-client\fR(1) \fBknife\-search\fR(1) \fBknife\-role\fR(1)
126
- .
127
- .SH "AUTHOR"
128
- Chef was written by Adam Jacob \fIadam@opscode\.com\fR with many contributions from the community\.
129
- .
130
- .SH "DOCUMENTATION"
131
- This manual page was written by Joshua Timberman \fIjoshua@opscode\.com\fR\. Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2\.0 License\.
77
+ .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
78
+ The private key that Knife will use to sign requests made by the API client to the server.
79
+ .TP
80
+ .B \fB\-\-no\-color\fP
81
+ Indicates that color will not be used in the output.
82
+ .TP
83
+ .B \fB\-p PASSWORD\fP, \fB\-\-password PASSWORD\fP
84
+ The user password.
85
+ .TP
86
+ .B \fB\-\-print\-after\fP
87
+ Indicates that data will be shown after a destructive operation.
88
+ .TP
89
+ .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
90
+ The URL for the server.
91
+ .TP
92
+ .B \fB\-u USER\fP, \fB\-\-user USER\fP
93
+ The user name used by Knife to sign requests made by the API client to the server. Authentication will fail if the user name does not match the private key.
94
+ .TP
95
+ .B \fB\-v\fP, \fB\-\-version\fP
96
+ The version of the chef\-client.
97
+ .TP
98
+ .B \fB\-V\fP, \fB\-\-verbose\fP
99
+ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
100
+ .TP
101
+ .B \fB\-y\fP, \fB\-\-yes\fP
102
+ Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
103
+ .UNINDENT
104
+ .SH BULK DELETE
105
+ .sp
106
+ The \fBbulk delete\fP argument is used to delete one or more nodes that match a pattern defined by a regular expression. The regular expression must be within quotes and not be surrounded by forward slashes (/).
107
+ .sp
108
+ \fBSyntax\fP
109
+ .sp
110
+ This argument has the following syntax:
111
+ .sp
112
+ .nf
113
+ .ft C
114
+ $ knife node bulk delete REGEX
115
+ .ft P
116
+ .fi
117
+ .sp
118
+ \fBOptions\fP
119
+ .sp
120
+ This command does not have any specific options.
121
+ .sp
122
+ \fBExamples\fP
123
+ .sp
124
+ To bulk delete many nodes, use a regular expression to define the pattern:
125
+ .sp
126
+ .nf
127
+ .ft C
128
+ $ knife node bulk delete "^[0\-9]{3}$"
129
+ .ft P
130
+ .fi
131
+ .sp
132
+ Type \fBY\fP to confirm a deletion.
133
+ .SH CREATE
134
+ .sp
135
+ The \fBcreate\fP argument is used to add a node to the server. Node data is stored as JSON on the server.
136
+ .sp
137
+ \fBSyntax\fP
138
+ .sp
139
+ This argument has the following syntax:
140
+ .sp
141
+ .nf
142
+ .ft C
143
+ $ knife node create NODE_NAME
144
+ .ft P
145
+ .fi
146
+ .sp
147
+ \fBOptions\fP
148
+ .sp
149
+ This command does not have any specific options.
150
+ .sp
151
+ \fBExamples\fP
152
+ .sp
153
+ To add a node, enter:
154
+ .sp
155
+ .nf
156
+ .ft C
157
+ $ knife node create node1
158
+ .ft P
159
+ .fi
160
+ .sp
161
+ In the $EDITOR enter the node data in JSON:
162
+ .sp
163
+ .nf
164
+ .ft C
165
+ ## sample:
166
+ {
167
+ "normal": {
168
+ },
169
+ "name": "foobar",
170
+ "override": {
171
+ },
172
+ "default": {
173
+ },
174
+ "json_class": "Chef::Node",
175
+ "automatic": {
176
+ },
177
+ "run_list": [
178
+ "recipe[zsh]",
179
+ "role[webserver]"
180
+ ],
181
+ "chef_type": "node"
182
+ }
183
+ .ft P
184
+ .fi
185
+ .sp
186
+ When finished, save it.
187
+ .SH DELETE
188
+ .sp
189
+ The \fBdelete\fP argument is used to delete a node from the server.
190
+ .IP Note
191
+ Deleting a node will not delete any corresponding API clients.
192
+ .RE
193
+ .sp
194
+ \fBSyntax\fP
195
+ .sp
196
+ This argument has the following syntax:
197
+ .sp
198
+ .nf
199
+ .ft C
200
+ $ knife node delete NODE_NAME
201
+ .ft P
202
+ .fi
203
+ .sp
204
+ \fBOptions\fP
205
+ .sp
206
+ This command does not have any specific options.
207
+ .sp
208
+ \fBExamples\fP
209
+ .sp
210
+ To delete a node called "dev", enter:
211
+ .sp
212
+ .nf
213
+ .ft C
214
+ $ knife node delete dev
215
+ .ft P
216
+ .fi
217
+ .SH EDIT
218
+ .sp
219
+ The \fBedit\fP argument is used to edit the details of a node on a server. Node data is stored as JSON on the server.
220
+ .sp
221
+ \fBSyntax\fP
222
+ .sp
223
+ This argument has the following syntax:
224
+ .sp
225
+ .nf
226
+ .ft C
227
+ $ knife node edit NODE_NAME (options)
228
+ .ft P
229
+ .fi
230
+ .sp
231
+ \fBOptions\fP
232
+ .sp
233
+ This argument has the following options:
234
+ .INDENT 0.0
235
+ .TP
236
+ .B \fB\-a\fP, \fB\-\-all\fP
237
+ Displays a node in the $EDITOR. By default, attributes that are default, override, or automatic are not shown.
238
+ .UNINDENT
239
+ .sp
240
+ \fBExamples\fP
241
+ .sp
242
+ To edit the data for a node named "node1", enter:
243
+ .sp
244
+ .nf
245
+ .ft C
246
+ $ knife node edit node1 \-a
247
+ .ft P
248
+ .fi
249
+ .sp
250
+ Update the role data in JSON:
251
+ .sp
252
+ .nf
253
+ .ft C
254
+ ## sample:
255
+ {
256
+ "normal": {
257
+ },
258
+ "name": "node1",
259
+ "override": {
260
+ },
261
+ "default": {
262
+ },
263
+ "json_class": "Chef::Node",
264
+ "automatic": {
265
+ },
266
+ "run_list": [
267
+ "recipe[devops]",
268
+ "role[webserver]"
269
+ ],
270
+ "chef_type": "node"
271
+ }
272
+ .ft P
273
+ .fi
274
+ .sp
275
+ When finished, save it.
276
+ .SH FROM FILE
277
+ .sp
278
+ The \fBfrom file\fP argument is used to create a node using existing node data as a template.
279
+ .sp
280
+ \fBSyntax\fP
281
+ .sp
282
+ This argument has the following syntax:
283
+ .sp
284
+ .nf
285
+ .ft C
286
+ $ knife node from file FILE
287
+ .ft P
288
+ .fi
289
+ .sp
290
+ \fBOptions\fP
291
+ .sp
292
+ This command does not have any specific options.
293
+ .sp
294
+ \fBExamples\fP
295
+ .sp
296
+ To add a node using data contained in a JSON file:
297
+ .sp
298
+ .nf
299
+ .ft C
300
+ $ knife node from file "path to JSON file"
301
+ .ft P
302
+ .fi
303
+ .SH LIST
304
+ .sp
305
+ The \fBlist\fP argument is used to view all of the nodes that exist on a server.
306
+ .sp
307
+ \fBSyntax\fP
308
+ .sp
309
+ This argument has the following syntax:
310
+ .sp
311
+ .nf
312
+ .ft C
313
+ $ knife node list (options)
314
+ .ft P
315
+ .fi
316
+ .sp
317
+ \fBOptions\fP
318
+ .sp
319
+ This argument has the following options:
320
+ .INDENT 0.0
321
+ .TP
322
+ .B \fB\-w\fP, \fB\-\-with\-uri\fP
323
+ Indicates that the corresponding URIs will be shown.
324
+ .UNINDENT
325
+ .sp
326
+ \fBExamples\fP
327
+ .sp
328
+ To verify the list of nodes that are registered with the server, enter:
329
+ .sp
330
+ .nf
331
+ .ft C
332
+ $ knife node list
333
+ .ft P
334
+ .fi
335
+ .sp
336
+ to return something similar to:
337
+ .sp
338
+ .nf
339
+ .ft C
340
+ i\-12345678
341
+ rs\-123456
342
+ .ft P
343
+ .fi
344
+ .SH RUN_LIST ADD
345
+ .sp
346
+ The \fBrun_list add\fP argument is used to add run list items (roles or recipes) to a node. A recipe must be in one of the following formats: fully qualified, cookbook, or default. Both roles and recipes must be in quotes, for example: \fB\(aqrole[ROLE_NAME]\(aq\fP or \fB\(aqrecipe[COOKBOOK::RECIPE_NAME]\(aq\fP. Use a comma to separate roles and recipes when adding more than one, like this: \fB\(aqrecipe[COOKBOOK::RECIPE_NAME],COOKBOOK::RECIPE_NAME,role[ROLE_NAME]\(aq\fP.
347
+ .sp
348
+ \fBSyntax\fP
349
+ .sp
350
+ This argument has the following syntax:
351
+ .sp
352
+ .nf
353
+ .ft C
354
+ $ knife node run_list add NODE_NAME RUN_LIST_ITEM (options)
355
+ .ft P
356
+ .fi
357
+ .sp
358
+ \fBOptions\fP
359
+ .sp
360
+ This argument has the following options:
361
+ .INDENT 0.0
362
+ .TP
363
+ .B \fB\-a ITEM\fP, \fB\-\-after ITEM\fP
364
+ Use this to add the run list item after the specified run list item.
365
+ .UNINDENT
366
+ .sp
367
+ \fBExamples\fP
368
+ .sp
369
+ To add a role to a run list, enter:
370
+ .sp
371
+ .nf
372
+ .ft C
373
+ $ knife node run_list add node \(aqrole[ROLE_NAME]\(aq
374
+ .ft P
375
+ .fi
376
+ .sp
377
+ To add roles and recipes to a run list, enter:
378
+ .sp
379
+ .nf
380
+ .ft C
381
+ $ knife node run_list add node \(aqrecipe[COOKBOOK::RECIPE_NAME],recipe[COOKBOOK::RECIPE_NAME],role[ROLE_NAME]\(aq
382
+ .ft P
383
+ .fi
384
+ .sp
385
+ To add a recipe to a run list using the fully qualified format, enter:
386
+ .sp
387
+ .nf
388
+ .ft C
389
+ $ knife node run_list add node \(aqrecipe[COOKBOOK::RECIPE_NAME]\(aq
390
+ .ft P
391
+ .fi
392
+ .sp
393
+ To add a recipe to a run list using the cookbook format, enter:
394
+ .sp
395
+ .nf
396
+ .ft C
397
+ $ knife node run_list add node \(aqCOOKBOOK::RECIPE_NAME\(aq
398
+ .ft P
399
+ .fi
400
+ .sp
401
+ To add the default recipe of a cookbook to a run list, enter:
402
+ .sp
403
+ .nf
404
+ .ft C
405
+ $ knife node run_list add node \(aqCOOKBOOK\(aq
406
+ .ft P
407
+ .fi
408
+ .SH RUN_LIST REMOVE
409
+ .sp
410
+ The \fBrun_list remove\fP argument is used to remove run list items (roles or recipes) from a node. A recipe must be in one of the following formats: fully qualified, cookbook, or default. Both roles and recipes must be in quotes, for example: \fB\(aqrole[ROLE_NAME]\(aq\fP or \fB\(aqrecipe[COOKBOOK::RECIPE_NAME]\(aq\fP. Use a comma to separate roles and recipes when removing more than one, like this: \fB\(aqrecipe[COOKBOOK::RECIPE_NAME],COOKBOOK::RECIPE_NAME,role[ROLE_NAME]\(aq\fP.
411
+ .sp
412
+ \fBSyntax\fP
413
+ .sp
414
+ This argument has the following syntax:
415
+ .sp
416
+ .nf
417
+ .ft C
418
+ $ knife node run_list remove NODE_NAME RUN_LIST_ITEM
419
+ .ft P
420
+ .fi
421
+ .sp
422
+ \fBOptions\fP
423
+ .sp
424
+ This command does not have any specific options.
425
+ .sp
426
+ \fBExamples\fP
427
+ .sp
428
+ To remove a role from a run list, enter:
429
+ .sp
430
+ .nf
431
+ .ft C
432
+ $ knife node run_list remove node \(aqrole[ROLE_NAME]\(aq
433
+ .ft P
434
+ .fi
435
+ .sp
436
+ To remove a recipe from a run list using the fully qualified format, enter:
437
+ .sp
438
+ .nf
439
+ .ft C
440
+ $ knife node run_list remove node \(aqrecipe[COOKBOOK::RECIPE_NAME]\(aq
441
+ .ft P
442
+ .fi
443
+ .SH SHOW
444
+ .sp
445
+ The \fBshow\fP argument is used to display information about a node.
446
+ .sp
447
+ \fBSyntax\fP
448
+ .sp
449
+ This argument has the following syntax:
450
+ .sp
451
+ .nf
452
+ .ft C
453
+ $ knife node show NODE_NAME (options)
454
+ .ft P
455
+ .fi
456
+ .sp
457
+ \fBOptions\fP
458
+ .sp
459
+ This argument has the following options:
460
+ .INDENT 0.0
461
+ .TP
462
+ .B \fB\-a ATTR\fP, \fB\-\-attribute ATTR\fP
463
+ The attribute (or attributes) to show.
464
+ .TP
465
+ .B \fB\-l\fP, \fB\-\-long\fP
466
+ Display long output when searching nodes while using the default summary format.
467
+ .TP
468
+ .B \fB\-m\fP, \fB\-\-medium\fP
469
+ Display more, but not all, of a node\(aqs data when searching using the default summary format.
470
+ .TP
471
+ .B \fB\-r\fP, \fB\-\-run\-list\fP
472
+ Indicates that only the run\-list will be shown.
473
+ .UNINDENT
474
+ .sp
475
+ \fBExamples\fP
476
+ .sp
477
+ To view all data for a node named "build", enter:
478
+ .sp
479
+ .nf
480
+ .ft C
481
+ $ knife node show build
482
+ .ft P
483
+ .fi
484
+ .sp
485
+ to return:
486
+ .sp
487
+ .nf
488
+ .ft C
489
+ Node Name: build
490
+ Environment: _default
491
+ FQDN:
492
+ IP:
493
+ Run List:
494
+ Roles:
495
+ Recipes:
496
+ Platform:
497
+ .ft P
498
+ .fi
499
+ .sp
500
+ To show basic information about a node, truncated and nicely formatted:
501
+ .sp
502
+ .nf
503
+ .ft C
504
+ knife node show <node_name>
505
+ .ft P
506
+ .fi
507
+ .sp
508
+ To show all information about a node, nicely formatted:
509
+ .sp
510
+ .nf
511
+ .ft C
512
+ knife node show \-l <node_name>
513
+ .ft P
514
+ .fi
515
+ .sp
516
+ To list a single node attribute:
517
+ .sp
518
+ .nf
519
+ .ft C
520
+ knife node show <node_name> \-a <attribute_name>
521
+ .ft P
522
+ .fi
523
+ .sp
524
+ where \fB<attribute_name>\fP is something like kernel or platform. (This doesn\(aqt work for nested attributes like \fBnode[kernel][machine]\fP because \fBknife node show\fP doesn\(aqt understand nested attributes.)
525
+ .sp
526
+ To view the FQDN for a node named "i\-12345678", enter:
527
+ .sp
528
+ .nf
529
+ .ft C
530
+ $ knife node show i\-12345678 \-a fqdn
531
+ .ft P
532
+ .fi
533
+ .sp
534
+ to return:
535
+ .sp
536
+ .nf
537
+ .ft C
538
+ fqdn: ip\-10\-251\-75\-20.ec2.internal
539
+ .ft P
540
+ .fi
541
+ .sp
542
+ To view the run list for a node named "dev", enter:
543
+ .sp
544
+ .nf
545
+ .ft C
546
+ $ knife node show dev \-r
547
+ .ft P
548
+ .fi
549
+ .sp
550
+ To view information in JSON format, use the \fB\-F\fP common option as part of the command like this:
551
+ .sp
552
+ .nf
553
+ .ft C
554
+ $ knife role show devops \-F json
555
+ .ft P
556
+ .fi
557
+ .sp
558
+ Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP.
559
+ .sp
560
+ To view node information in raw JSON, use the \fB\-l\fP or \fB\-\-long\fP option:
561
+ .sp
562
+ .nf
563
+ .ft C
564
+ knife node show \-l \-F json <node_name>
565
+ .ft P
566
+ .fi
567
+ .sp
568
+ and/or:
569
+ .sp
570
+ .nf
571
+ .ft C
572
+ knife node show \-l \-\-format=json <node_name>
573
+ .ft P
574
+ .fi
575
+ .SH AUTHOR
576
+ Opscode
577
+ .\" Generated by docutils manpage writer.
132
578
  .
133
- .SH "CHEF"
134
- Knife is distributed with Chef\. \fIhttp://wiki\.opscode\.com/display/chef/Home\fR