chef 13.11.3-universal-mingw32 → 13.12.3-universal-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (260) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +4 -3
  3. data/README.md +35 -40
  4. data/Rakefile +18 -22
  5. data/chef-universal-mingw32.gemspec +1 -1
  6. data/chef.gemspec +3 -3
  7. data/lib/chef/client.rb +1 -1
  8. data/lib/chef/mixin/params_validate.rb +3 -1
  9. data/lib/chef/provider/script.rb +2 -2
  10. data/lib/chef/version.rb +1 -1
  11. data/spec/functional/http/simple_spec.rb +12 -6
  12. data/spec/functional/resource/remote_file_spec.rb +19 -15
  13. data/spec/support/platform_helpers.rb +2 -1
  14. data/tasks/announce.rb +1 -1
  15. data/tasks/dependencies.rb +5 -39
  16. data/tasks/maintainers.rb +10 -10
  17. data/tasks/rspec.rb +2 -2
  18. data/tasks/templates/prerelease.md.erb +11 -2
  19. data/tasks/templates/release.md.erb +9 -1
  20. metadata +6 -247
  21. data/CONTRIBUTING.md +0 -151
  22. data/VERSION +0 -1
  23. data/acceptance/.gitignore +0 -3
  24. data/acceptance/.shared/kitchen_acceptance/.kitchen.digitalocean.yml +0 -33
  25. data/acceptance/.shared/kitchen_acceptance/.kitchen.ec2.yml +0 -283
  26. data/acceptance/.shared/kitchen_acceptance/.kitchen.vagrant.yml +0 -59
  27. data/acceptance/.shared/kitchen_acceptance/libraries/kitchen.rb +0 -68
  28. data/acceptance/.shared/kitchen_acceptance/metadata.rb +0 -1
  29. data/acceptance/Gemfile +0 -19
  30. data/acceptance/Gemfile.lock +0 -266
  31. data/acceptance/README.md +0 -137
  32. data/acceptance/basics/.acceptance/acceptance-cookbook/.gitignore +0 -2
  33. data/acceptance/basics/.acceptance/acceptance-cookbook/metadata.rb +0 -3
  34. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  35. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  36. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  37. data/acceptance/basics/.kitchen.yml +0 -4
  38. data/acceptance/basics/test/integration/chef-current-install/serverspec/chef_client_spec.rb +0 -19
  39. data/acceptance/basics/test/integration/chef-current-install/serverspec/spec_helper.rb +0 -6
  40. data/acceptance/basics/test/integration/helpers/serverspec/Gemfile +0 -8
  41. data/acceptance/data-collector/.acceptance/acceptance-cookbook/.gitignore +0 -2
  42. data/acceptance/data-collector/.acceptance/acceptance-cookbook/metadata.rb +0 -3
  43. data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -2
  44. data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -2
  45. data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -2
  46. data/acceptance/data-collector/.acceptance/data-collector-test/.gitignore +0 -16
  47. data/acceptance/data-collector/.acceptance/data-collector-test/Berksfile +0 -3
  48. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/api.rb +0 -101
  49. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/apigemfile +0 -3
  50. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-both-mode.rb +0 -4
  51. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-client-mode.rb +0 -4
  52. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-no-endpoint.rb +0 -2
  53. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-solo-mode.rb +0 -4
  54. data/acceptance/data-collector/.acceptance/data-collector-test/files/default/config.ru +0 -2
  55. data/acceptance/data-collector/.acceptance/data-collector-test/metadata.rb +0 -7
  56. data/acceptance/data-collector/.acceptance/data-collector-test/recipes/default.rb +0 -44
  57. data/acceptance/data-collector/.kitchen.yml +0 -9
  58. data/acceptance/data-collector/Berksfile +0 -3
  59. data/acceptance/data-collector/test/integration/default/serverspec/default_spec.rb +0 -208
  60. data/acceptance/data-collector/test/integration/helpers/serverspec/Gemfile +0 -8
  61. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/.gitignore +0 -2
  62. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/metadata.rb +0 -1
  63. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  64. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  65. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -61
  66. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/.gitignore +0 -2
  67. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/cookbook_kitchen.rb +0 -43
  68. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/top_cookbooks.rb +0 -41
  69. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/metadata.rb +0 -3
  70. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  71. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  72. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  73. data/acceptance/top-cookbooks/.gitignore +0 -1
  74. data/acceptance/top-cookbooks/.kitchen.chocolatey.yml +0 -6
  75. data/acceptance/top-cookbooks/.kitchen.iis.yml +0 -4
  76. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-rhel.yml +0 -7
  77. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-ubuntu.yml +0 -7
  78. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-windows.yml +0 -7
  79. data/acceptance/top-cookbooks/.kitchen.powershell.yml +0 -4
  80. data/acceptance/top-cookbooks/.kitchen.sql_server.yml +0 -5
  81. data/acceptance/top-cookbooks/.kitchen.winbox.yml +0 -8
  82. data/acceptance/top-cookbooks/.kitchen.windows.yml +0 -38
  83. data/acceptance/trivial/.acceptance/acceptance-cookbook/.gitignore +0 -2
  84. data/acceptance/trivial/.acceptance/acceptance-cookbook/metadata.rb +0 -2
  85. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  86. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  87. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  88. data/acceptance/trivial/.kitchen.yml +0 -7
  89. data/acceptance/trivial/test/integration/chef-current-install/inspec/chef_client_spec.rb +0 -5
  90. data/acceptance/windows-service/.acceptance/acceptance-cookbook/.gitignore +0 -2
  91. data/acceptance/windows-service/.acceptance/acceptance-cookbook/metadata.rb +0 -2
  92. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
  93. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
  94. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
  95. data/acceptance/windows-service/.kitchen.yml +0 -7
  96. data/acceptance/windows-service/test/integration/chef-windows-service/inspec/chef_windows_service_spec.rb +0 -58
  97. data/distro/common/html/_sources/ctl_chef_client.txt +0 -36
  98. data/distro/common/html/_sources/ctl_chef_server.txt +0 -341
  99. data/distro/common/html/_sources/ctl_chef_shell.txt +0 -15
  100. data/distro/common/html/_sources/ctl_chef_solo.txt +0 -25
  101. data/distro/common/html/_sources/index.txt +0 -135
  102. data/distro/common/html/_sources/knife.txt +0 -74
  103. data/distro/common/html/_sources/knife_bootstrap.txt +0 -56
  104. data/distro/common/html/_sources/knife_client.txt +0 -151
  105. data/distro/common/html/_sources/knife_common_options.txt +0 -6
  106. data/distro/common/html/_sources/knife_configure.txt +0 -29
  107. data/distro/common/html/_sources/knife_cookbook.txt +0 -236
  108. data/distro/common/html/_sources/knife_cookbook_site.txt +0 -157
  109. data/distro/common/html/_sources/knife_data_bag.txt +0 -160
  110. data/distro/common/html/_sources/knife_delete.txt +0 -26
  111. data/distro/common/html/_sources/knife_deps.txt +0 -61
  112. data/distro/common/html/_sources/knife_diff.txt +0 -34
  113. data/distro/common/html/_sources/knife_download.txt +0 -44
  114. data/distro/common/html/_sources/knife_edit.txt +0 -26
  115. data/distro/common/html/_sources/knife_environment.txt +0 -158
  116. data/distro/common/html/_sources/knife_exec.txt +0 -47
  117. data/distro/common/html/_sources/knife_index_rebuild.txt +0 -21
  118. data/distro/common/html/_sources/knife_list.txt +0 -33
  119. data/distro/common/html/_sources/knife_node.txt +0 -250
  120. data/distro/common/html/_sources/knife_raw.txt +0 -35
  121. data/distro/common/html/_sources/knife_recipe_list.txt +0 -23
  122. data/distro/common/html/_sources/knife_role.txt +0 -157
  123. data/distro/common/html/_sources/knife_search.txt +0 -53
  124. data/distro/common/html/_sources/knife_serve.txt +0 -19
  125. data/distro/common/html/_sources/knife_show.txt +0 -27
  126. data/distro/common/html/_sources/knife_ssh.txt +0 -43
  127. data/distro/common/html/_sources/knife_ssl_check.txt +0 -41
  128. data/distro/common/html/_sources/knife_ssl_fetch.txt +0 -41
  129. data/distro/common/html/_sources/knife_status.txt +0 -37
  130. data/distro/common/html/_sources/knife_tag.txt +0 -69
  131. data/distro/common/html/_sources/knife_upload.txt +0 -49
  132. data/distro/common/html/_sources/knife_user.txt +0 -127
  133. data/distro/common/html/_sources/knife_using.txt +0 -43
  134. data/distro/common/html/_sources/knife_xargs.txt +0 -30
  135. data/distro/common/html/_static/ajax-loader.gif +0 -0
  136. data/distro/common/html/_static/basic.css +0 -537
  137. data/distro/common/html/_static/chef.ico +0 -0
  138. data/distro/common/html/_static/chef_html_logo.png +0 -0
  139. data/distro/common/html/_static/comment-bright.png +0 -0
  140. data/distro/common/html/_static/comment-close.png +0 -0
  141. data/distro/common/html/_static/comment.png +0 -0
  142. data/distro/common/html/_static/contents.png +0 -0
  143. data/distro/common/html/_static/doctools.js +0 -238
  144. data/distro/common/html/_static/down-pressed.png +0 -0
  145. data/distro/common/html/_static/down.png +0 -0
  146. data/distro/common/html/_static/file.png +0 -0
  147. data/distro/common/html/_static/guide.css +0 -505
  148. data/distro/common/html/_static/jquery.js +0 -2
  149. data/distro/common/html/_static/minus.png +0 -0
  150. data/distro/common/html/_static/navigation.png +0 -0
  151. data/distro/common/html/_static/plus.png +0 -0
  152. data/distro/common/html/_static/pygments.css +0 -62
  153. data/distro/common/html/_static/searchtools.js +0 -622
  154. data/distro/common/html/_static/underscore.js +0 -31
  155. data/distro/common/html/_static/up-pressed.png +0 -0
  156. data/distro/common/html/_static/up.png +0 -0
  157. data/distro/common/html/_static/websupport.js +0 -808
  158. data/distro/common/html/ctl_chef_client.html +0 -270
  159. data/distro/common/html/ctl_chef_server.html +0 -728
  160. data/distro/common/html/ctl_chef_shell.html +0 -163
  161. data/distro/common/html/ctl_chef_solo.html +0 -194
  162. data/distro/common/html/index.html +0 -202
  163. data/distro/common/html/knife.html +0 -170
  164. data/distro/common/html/knife_bootstrap.html +0 -285
  165. data/distro/common/html/knife_client.html +0 -285
  166. data/distro/common/html/knife_common_options.html +0 -96
  167. data/distro/common/html/knife_configure.html +0 -105
  168. data/distro/common/html/knife_cookbook.html +0 -487
  169. data/distro/common/html/knife_cookbook_site.html +0 -375
  170. data/distro/common/html/knife_data_bag.html +0 -374
  171. data/distro/common/html/knife_delete.html +0 -93
  172. data/distro/common/html/knife_deps.html +0 -143
  173. data/distro/common/html/knife_diff.html +0 -123
  174. data/distro/common/html/knife_download.html +0 -145
  175. data/distro/common/html/knife_edit.html +0 -89
  176. data/distro/common/html/knife_environment.html +0 -322
  177. data/distro/common/html/knife_exec.html +0 -220
  178. data/distro/common/html/knife_index_rebuild.html +0 -83
  179. data/distro/common/html/knife_list.html +0 -114
  180. data/distro/common/html/knife_node.html +0 -458
  181. data/distro/common/html/knife_raw.html +0 -110
  182. data/distro/common/html/knife_recipe_list.html +0 -91
  183. data/distro/common/html/knife_role.html +0 -295
  184. data/distro/common/html/knife_search.html +0 -203
  185. data/distro/common/html/knife_serve.html +0 -79
  186. data/distro/common/html/knife_show.html +0 -104
  187. data/distro/common/html/knife_ssh.html +0 -177
  188. data/distro/common/html/knife_ssl_check.html +0 -151
  189. data/distro/common/html/knife_ssl_fetch.html +0 -151
  190. data/distro/common/html/knife_status.html +0 -144
  191. data/distro/common/html/knife_tag.html +0 -138
  192. data/distro/common/html/knife_upload.html +0 -153
  193. data/distro/common/html/knife_user.html +0 -242
  194. data/distro/common/html/knife_using.html +0 -210
  195. data/distro/common/html/knife_xargs.html +0 -122
  196. data/distro/common/html/objects.inv +0 -0
  197. data/distro/common/html/search.html +0 -82
  198. data/distro/common/html/searchindex.js +0 -1
  199. data/distro/common/man/man1/README.md +0 -58
  200. data/distro/common/man/man1/chef-shell.1 +0 -194
  201. data/distro/common/man/man1/knife-bootstrap.1 +0 -215
  202. data/distro/common/man/man1/knife-client.1 +0 -443
  203. data/distro/common/man/man1/knife-configure.1 +0 -161
  204. data/distro/common/man/man1/knife-cookbook-site.1 +0 -552
  205. data/distro/common/man/man1/knife-cookbook.1 +0 -770
  206. data/distro/common/man/man1/knife-data-bag.1 +0 -617
  207. data/distro/common/man/man1/knife-delete.1 +0 -127
  208. data/distro/common/man/man1/knife-deps.1 +0 -246
  209. data/distro/common/man/man1/knife-diff.1 +0 -226
  210. data/distro/common/man/man1/knife-download.1 +0 -258
  211. data/distro/common/man/man1/knife-edit.1 +0 -121
  212. data/distro/common/man/man1/knife-environment.1 +0 -496
  213. data/distro/common/man/man1/knife-exec.1 +0 -362
  214. data/distro/common/man/man1/knife-index-rebuild.1 +0 -63
  215. data/distro/common/man/man1/knife-list.1 +0 -174
  216. data/distro/common/man/man1/knife-node.1 +0 -716
  217. data/distro/common/man/man1/knife-raw.1 +0 -172
  218. data/distro/common/man/man1/knife-recipe-list.1 +0 -85
  219. data/distro/common/man/man1/knife-role.1 +0 -426
  220. data/distro/common/man/man1/knife-search.1 +0 -359
  221. data/distro/common/man/man1/knife-serve.1 +0 -109
  222. data/distro/common/man/man1/knife-show.1 +0 -160
  223. data/distro/common/man/man1/knife-ssh.1 +0 -284
  224. data/distro/common/man/man1/knife-ssl-check.1 +0 -207
  225. data/distro/common/man/man1/knife-ssl-fetch.1 +0 -207
  226. data/distro/common/man/man1/knife-status.1 +0 -234
  227. data/distro/common/man/man1/knife-tag.1 +0 -189
  228. data/distro/common/man/man1/knife-upload.1 +0 -280
  229. data/distro/common/man/man1/knife-user.1 +0 -356
  230. data/distro/common/man/man1/knife-xargs.1 +0 -189
  231. data/distro/common/man/man1/knife.1 +0 -332
  232. data/distro/common/man/man8/chef-apply.8 +0 -86
  233. data/distro/common/man/man8/chef-client.8 +0 -398
  234. data/distro/common/man/man8/chef-solo.8 +0 -260
  235. data/distro/common/markdown/README +0 -3
  236. data/distro/common/markdown/man1/chef-shell.mkd +0 -195
  237. data/distro/common/markdown/man1/knife-bootstrap.mkd +0 -141
  238. data/distro/common/markdown/man1/knife-client.mkd +0 -103
  239. data/distro/common/markdown/man1/knife-configure.mkd +0 -71
  240. data/distro/common/markdown/man1/knife-cookbook-site.mkd +0 -123
  241. data/distro/common/markdown/man1/knife-cookbook.mkd +0 -263
  242. data/distro/common/markdown/man1/knife-data-bag.mkd +0 -121
  243. data/distro/common/markdown/man1/knife-environment.mkd +0 -151
  244. data/distro/common/markdown/man1/knife-exec.mkd +0 -42
  245. data/distro/common/markdown/man1/knife-index.mkd +0 -30
  246. data/distro/common/markdown/man1/knife-node.mkd +0 -130
  247. data/distro/common/markdown/man1/knife-role.mkd +0 -85
  248. data/distro/common/markdown/man1/knife-search.mkd +0 -180
  249. data/distro/common/markdown/man1/knife-ssh.mkd +0 -69
  250. data/distro/common/markdown/man1/knife-status.mkd +0 -36
  251. data/distro/common/markdown/man1/knife-tag.mkd +0 -39
  252. data/distro/common/markdown/man1/knife.mkd +0 -213
  253. data/distro/common/markdown/man8/chef-client.mkd +0 -75
  254. data/distro/common/markdown/man8/chef-expander.mkd +0 -81
  255. data/distro/common/markdown/man8/chef-expanderctl.mkd +0 -57
  256. data/distro/common/markdown/man8/chef-server-webui.mkd +0 -121
  257. data/distro/common/markdown/man8/chef-server.mkd +0 -120
  258. data/distro/common/markdown/man8/chef-solo.mkd +0 -107
  259. data/distro/common/markdown/man8/chef-solr.mkd +0 -89
  260. data/tasks/cbgb.rb +0 -84
@@ -1,359 +0,0 @@
1
- .\" Man page generated from reStructuredText.
2
- .
3
- .TH "KNIFE-SEARCH" "1" "Chef 12.0" "" "knife search"
4
- .SH NAME
5
- knife-search \- The man page for the knife search subcommand.
6
- .
7
- .nr rst2man-indent-level 0
8
- .
9
- .de1 rstReportMargin
10
- \\$1 \\n[an-margin]
11
- level \\n[rst2man-indent-level]
12
- level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
13
- -
14
- \\n[rst2man-indent0]
15
- \\n[rst2man-indent1]
16
- \\n[rst2man-indent2]
17
- ..
18
- .de1 INDENT
19
- .\" .rstReportMargin pre:
20
- . RS \\$1
21
- . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22
- . nr rst2man-indent-level +1
23
- .\" .rstReportMargin post:
24
- ..
25
- .de UNINDENT
26
- . RE
27
- .\" indent \\n[an-margin]
28
- .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
- .nr rst2man-indent-level -1
30
- .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31
- .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
32
- ..
33
- .sp
34
- Search indexes allow queries to be made for any type of data that is indexed by the Chef server, including data bags (and data bag items), environments, nodes, and roles. A defined query syntax is used to support search patterns like exact, wildcard, range, and fuzzy. A search is a full\-text query that can be done from several locations, including from within a recipe, by using the \fBsearch\fP subcommand in knife, the \fBsearch\fP method in the Recipe DSL, and by using the \fB/search\fP or \fB/search/INDEX\fP endpoints in the Chef server API\&. The search engine is based on Apache Solr and is run from the Chef server\&.
35
- .sp
36
- The \fBknife search\fP subcommand is used run a search query for information that is indexed on a Chef server\&.
37
- .sp
38
- \fBSyntax\fP
39
- .sp
40
- This subcommand has the following syntax:
41
- .INDENT 0.0
42
- .INDENT 3.5
43
- .sp
44
- .nf
45
- .ft C
46
- $ knife search INDEX SEARCH_QUERY
47
- .ft P
48
- .fi
49
- .UNINDENT
50
- .UNINDENT
51
- .sp
52
- where \fBINDEX\fP is one of \fBclient\fP, \fBenvironment\fP, \fBnode\fP, \fBrole\fP, or the name of a data bag and \fBSEARCH_QUERY\fP is the search query syntax for the query that will be executed.
53
- .sp
54
- \fBINDEX\fP is implied if omitted, and will default to \fBnode\fP\&. For example:
55
- .INDENT 0.0
56
- .INDENT 3.5
57
- .sp
58
- .nf
59
- .ft C
60
- $ knife search \(aq*:*\(aq \-i
61
- .ft P
62
- .fi
63
- .UNINDENT
64
- .UNINDENT
65
- .sp
66
- will return something similar to:
67
- .INDENT 0.0
68
- .INDENT 3.5
69
- .sp
70
- .nf
71
- .ft C
72
- 8 items found
73
-
74
- centos\-62\-dev
75
- opensuse\-1203
76
- ubuntu\-1304\-dev
77
- ubuntu\-1304\-orgtest
78
- ubuntu\-1204\-ohai\-test
79
- ubuntu\-1304\-ifcfg\-test
80
- ohai\-test
81
- win2k8\-dev
82
- .ft P
83
- .fi
84
- .UNINDENT
85
- .UNINDENT
86
- .sp
87
- and is the same search as:
88
- .INDENT 0.0
89
- .INDENT 3.5
90
- .sp
91
- .nf
92
- .ft C
93
- $ knife search node \(aq*:*" \-i
94
- .ft P
95
- .fi
96
- .UNINDENT
97
- .UNINDENT
98
- .sp
99
- If the \fBSEARCH_QUERY\fP does not contain a colon character (\fB:\fP), then the default query pattern is \fBtags:*#{@query}* OR roles:*#{@query}* OR fqdn:*#{@query}* OR addresses:*#{@query}*\fP, which means the following two search queries are effectively the same:
100
- .INDENT 0.0
101
- .INDENT 3.5
102
- .sp
103
- .nf
104
- .ft C
105
- $ knife search ubuntu
106
- .ft P
107
- .fi
108
- .UNINDENT
109
- .UNINDENT
110
- .sp
111
- or:
112
- .INDENT 0.0
113
- .INDENT 3.5
114
- .sp
115
- .nf
116
- .ft C
117
- $ knife search node "tags:*ubuntu* OR roles:*ubuntu* OR fqdn:*ubuntu* (etc.)"
118
- .ft P
119
- .fi
120
- .UNINDENT
121
- .UNINDENT
122
- .sp
123
- \fBOptions\fP
124
- .sp
125
- This sub\-command has the following options:
126
- .INDENT 0.0
127
- .TP
128
- .B \fB\-a ATTR\fP, \fB\-\-attribute ATTR\fP
129
- The attribute (or attributes) to show.
130
- .TP
131
- .B \fB\-b ROW\fP, \fB\-\-start ROW\fP
132
- The row at which return results will begin.
133
- .TP
134
- .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
135
- The configuration file to use.
136
- .TP
137
- .B \fB\-\-chef\-zero\-port PORT\fP
138
- The port on which chef\-zero will listen.
139
- .TP
140
- .B \fB\-\-[no\-]color\fP
141
- Use to view colored output.
142
- .TP
143
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
144
- Use to prevent the $EDITOR from being opened and to accept data as\-is.
145
- .TP
146
- .B \fB\-\-defaults\fP
147
- Use to have knife use the default value instead of asking a user to provide one.
148
- .TP
149
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
150
- The $EDITOR that is used for all interactive commands.
151
- .TP
152
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
153
- The name of the environment. When this option is added to a command, the command will run only against the named environment.
154
- .TP
155
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
156
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
157
- .TP
158
- .B \fB\-h\fP, \fB\-\-help\fP
159
- Shows help for the command.
160
- .TP
161
- .B \fB\-i\fP, \fB\-\-id\-only\fP
162
- Use to show only matching object IDs.
163
- .TP
164
- .B \fBINDEX\fP
165
- The name of the index to be queried: \fBclient\fP, \fBenvironment\fP, \fBnode\fP, \fBrole\fP, or \fBDATA_BAG_NAME\fP\&. Default index: \fBnode\fP\&.
166
- .TP
167
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
168
- The private key that knife will use to sign requests made by the API client to the Chef server\&.
169
- .TP
170
- .B \fB\-l\fP, \fB\-\-long\fP
171
- Use to display all attributes in the output and to show the output as JSON\&.
172
- .TP
173
- .B \fB\-m\fP, \fB\-\-medium\fP
174
- Use to display normal attributes in the output and to show the output as JSON\&.
175
- .TP
176
- .B \fB\-o SORT\fP, \fB\-\-sort SORT\fP
177
- The order in which search results will be sorted.
178
- .TP
179
- .B \fB\-\-print\-after\fP
180
- Use to show data after a destructive operation.
181
- .TP
182
- .B \fB\-q SEARCH_QUERY\fP, \fB\-\-query SEARCH_QUERY\fP
183
- Use to protect search queries that start with a hyphen (\-). A \fB\-q\fP query may be specified as an argument or an option, but not both.
184
- .TP
185
- .B \fB\-r\fP, \fB\-\-run\-list\fP
186
- Use to show only the run\-list.
187
- .TP
188
- .B \fB\-R INT\fP, \fB\-\-rows INT\fP
189
- The number of rows to be returned.
190
- .TP
191
- .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
192
- The URL for the Chef server\&.
193
- .TP
194
- .B \fBSEARCH_QUERY\fP
195
- The search query used to identify a a list of items on a Chef server\&. This option uses the same syntax as the \fBsearch\fP sub\-command.
196
- .TP
197
- .B \fB\-u USER\fP, \fB\-\-user USER\fP
198
- The user name used by knife to sign requests made by the API client to the Chef server\&. Authentication will fail if the user name does not match the private key.
199
- .TP
200
- .B \fB\-v\fP, \fB\-\-version\fP
201
- The version of the chef\-client\&.
202
- .TP
203
- .B \fB\-V\fP, \fB\-\-verbose\fP
204
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
205
- .TP
206
- .B \fB\-y\fP, \fB\-\-yes\fP
207
- Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
208
- .TP
209
- .B \fB\-z\fP, \fB\-\-local\-mode\fP
210
- Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
211
- .UNINDENT
212
- .sp
213
- \fBExamples\fP
214
- .sp
215
- To search for the IDs of all nodes running on the Amazon EC2 platform, enter:
216
- .INDENT 0.0
217
- .INDENT 3.5
218
- .sp
219
- .nf
220
- .ft C
221
- $ knife search node \(aqec2:*\(aq \-i
222
- .ft P
223
- .fi
224
- .UNINDENT
225
- .UNINDENT
226
- .sp
227
- to return something like:
228
- .INDENT 0.0
229
- .INDENT 3.5
230
- .sp
231
- .nf
232
- .ft C
233
- 4 items found
234
-
235
- ip\-0A7CA19F.ec2.internal
236
-
237
- ip\-0A58CF8E.ec2.internal
238
-
239
- ip\-0A58E134.ec2.internal
240
-
241
- ip\-0A7CFFD5.ec2.internal
242
- .ft P
243
- .fi
244
- .UNINDENT
245
- .UNINDENT
246
- .sp
247
- To search for the instance type (flavor) of all nodes running on the Amazon EC2 platform, enter:
248
- .INDENT 0.0
249
- .INDENT 3.5
250
- .sp
251
- .nf
252
- .ft C
253
- $ knife search node \(aqec2:*\(aq \-a ec2.instance_type
254
- .ft P
255
- .fi
256
- .UNINDENT
257
- .UNINDENT
258
- .sp
259
- to return something like:
260
- .INDENT 0.0
261
- .INDENT 3.5
262
- .sp
263
- .nf
264
- .ft C
265
- 4 items found
266
-
267
- ec2.instance_type: m1.large
268
- id: ip\-0A7CA19F.ec2.internal
269
-
270
- ec2.instance_type: m1.large
271
- id: ip\-0A58CF8E.ec2.internal
272
-
273
- ec2.instance_type: m1.large
274
- id: ip\-0A58E134.ec2.internal
275
-
276
- ec2.instance_type: m1.large
277
- id: ip\-0A7CFFD5.ec2.internal
278
- .ft P
279
- .fi
280
- .UNINDENT
281
- .UNINDENT
282
- .sp
283
- To search for all nodes running Ubuntu, enter:
284
- .INDENT 0.0
285
- .INDENT 3.5
286
- .sp
287
- .nf
288
- .ft C
289
- $ knife search node \(aqplatform:ubuntu\(aq
290
- .ft P
291
- .fi
292
- .UNINDENT
293
- .UNINDENT
294
- .sp
295
- To search for all nodes running CentOS in the production environment, enter:
296
- .INDENT 0.0
297
- .INDENT 3.5
298
- .sp
299
- .nf
300
- .ft C
301
- $ knife search node \(aqchef_environment:production AND platform:centos\(aq
302
- .ft P
303
- .fi
304
- .UNINDENT
305
- .UNINDENT
306
- .sp
307
- To find a nested attribute, use a pattern similar to the following:
308
- .INDENT 0.0
309
- .INDENT 3.5
310
- .sp
311
- .nf
312
- .ft C
313
- $ knife search node <query_to_run> \-a <main_attribute>.<nested_attribute>
314
- .ft P
315
- .fi
316
- .UNINDENT
317
- .UNINDENT
318
- .sp
319
- To build a search query to use more than one attribute, use an underscore (\fB_\fP) to separate each attribute. For example, the following query will search for all nodes running a specific version of Ruby:
320
- .INDENT 0.0
321
- .INDENT 3.5
322
- .sp
323
- .nf
324
- .ft C
325
- $ knife search node "languages_ruby_version:1.9.3"
326
- .ft P
327
- .fi
328
- .UNINDENT
329
- .UNINDENT
330
- .sp
331
- To build a search query that can find a nested attribute:
332
- .INDENT 0.0
333
- .INDENT 3.5
334
- .sp
335
- .nf
336
- .ft C
337
- $ knife search node name:<node_name> \-a kernel.machine
338
- .ft P
339
- .fi
340
- .UNINDENT
341
- .UNINDENT
342
- .sp
343
- To test a search query that will be used in a \fBknife ssh\fP command:
344
- .INDENT 0.0
345
- .INDENT 3.5
346
- .sp
347
- .nf
348
- .ft C
349
- $ knife search node "role:web NOT name:web03"
350
- .ft P
351
- .fi
352
- .UNINDENT
353
- .UNINDENT
354
- .sp
355
- where the query in the previous example will search all servers that have the \fBweb\fP role, but not on the server named \fBweb03\fP\&.
356
- .SH AUTHOR
357
- Chef
358
- .\" Generated by docutils manpage writer.
359
- .
@@ -1,109 +0,0 @@
1
- .\" Man page generated from reStructuredText.
2
- .
3
- .TH "KNIFE-SERVE" "1" "Chef 12.0" "" "knife serve"
4
- .SH NAME
5
- knife-serve \- The man page for the knife serve subcommand.
6
- .
7
- .nr rst2man-indent-level 0
8
- .
9
- .de1 rstReportMargin
10
- \\$1 \\n[an-margin]
11
- level \\n[rst2man-indent-level]
12
- level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
13
- -
14
- \\n[rst2man-indent0]
15
- \\n[rst2man-indent1]
16
- \\n[rst2man-indent2]
17
- ..
18
- .de1 INDENT
19
- .\" .rstReportMargin pre:
20
- . RS \\$1
21
- . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22
- . nr rst2man-indent-level +1
23
- .\" .rstReportMargin post:
24
- ..
25
- .de UNINDENT
26
- . RE
27
- .\" indent \\n[an-margin]
28
- .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
- .nr rst2man-indent-level -1
30
- .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31
- .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
32
- ..
33
- .sp
34
- The \fBknife serve\fP subcommand is used to run a persistent chef\-zero against the local chef\-repo\&. (chef\-zero is a lightweight Chef server that runs in\-memory on the local machine.) This is the same as running the chef\-client executable with the \fB\-\-local\-mode\fP option. The \fBchef_repo_path\fP is located automatically and the Chef server will bind to the first available port between \fB8889\fP and \fB9999\fP\&. \fBknife serve\fP will print the URL for the local Chef server, so that it may be added to the knife.rb file.
35
- .sp
36
- \fBSyntax\fP
37
- .sp
38
- This subcommand has the following syntax:
39
- .INDENT 0.0
40
- .INDENT 3.5
41
- .sp
42
- .nf
43
- .ft C
44
- $ knife serve (options)
45
- .ft P
46
- .fi
47
- .UNINDENT
48
- .UNINDENT
49
- .sp
50
- \fBOptions\fP
51
- .sp
52
- This subcommand has the following options:
53
- .INDENT 0.0
54
- .TP
55
- .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
56
- The configuration file to use.
57
- .TP
58
- .B \fB\-\-chef\-zero\-port PORT\fP
59
- The port on which chef\-zero will listen.
60
- .TP
61
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
62
- Use to prevent the $EDITOR from being opened and to accept data as\-is.
63
- .TP
64
- .B \fB\-\-defaults\fP
65
- Use to have knife use the default value instead of asking a user to provide one.
66
- .TP
67
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
68
- The $EDITOR that is used for all interactive commands.
69
- .TP
70
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
71
- The name of the environment. When this option is added to a command, the command will run only against the named environment.
72
- .TP
73
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
74
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
75
- .TP
76
- .B \fB\-h\fP, \fB\-\-help\fP
77
- Shows help for the command.
78
- .TP
79
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
80
- The private key that knife will use to sign requests made by the API client to the Chef server\&.
81
- .TP
82
- .B \fB\-\-[no\-]color\fP
83
- Use to view colored output.
84
- .TP
85
- .B \fB\-\-print\-after\fP
86
- Use to show data after a destructive operation.
87
- .TP
88
- .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
89
- The URL for the Chef server\&.
90
- .TP
91
- .B \fB\-u USER\fP, \fB\-\-user USER\fP
92
- The user name used by knife to sign requests made by the API client to the Chef server\&. Authentication will fail if the user name does not match the private key.
93
- .TP
94
- .B \fB\-v\fP, \fB\-\-version\fP
95
- The version of the chef\-client\&.
96
- .TP
97
- .B \fB\-V\fP, \fB\-\-verbose\fP
98
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
99
- .TP
100
- .B \fB\-y\fP, \fB\-\-yes\fP
101
- Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
102
- .TP
103
- .B \fB\-z\fP, \fB\-\-local\-mode\fP
104
- Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
105
- .UNINDENT
106
- .SH AUTHOR
107
- Chef
108
- .\" Generated by docutils manpage writer.
109
- .