chef 13.11.3 → 13.12.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (261) 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 -248
  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/distro/powershell/chef/chef.psm1 +0 -459
  261. data/tasks/cbgb.rb +0 -84
@@ -1,280 +0,0 @@
1
- .\" Man page generated from reStructuredText.
2
- .
3
- .TH "KNIFE-UPLOAD" "1" "Chef 12.0" "" "knife upload"
4
- .SH NAME
5
- knife-upload \- The man page for the knife upload 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 upload\fP subcommand is used to upload roles, cookbooks, environments, and data bags to the Chef server from the current working directory in the chef\-repo\&. This subcommand is often used in conjunction with \fBknife diff\fP, which can be used to see exactly what changes will be uploaded, and then \fBknife download\fP, which does the opposite of \fBknife upload\fP\&.
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 upload [PATTERN...] (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\-repo\-path PATH\fP
59
- 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.
60
- .TP
61
- .B \fB\-\-chef\-zero\-port PORT\fP
62
- The port on which chef\-zero will listen.
63
- .TP
64
- .B \fB\-\-[no\-]color\fP
65
- Use to view colored output.
66
- .TP
67
- .B \fB\-\-concurrency\fP
68
- The number of allowed concurrent connections. Default: \fB10\fP\&.
69
- .TP
70
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
71
- Use to prevent the $EDITOR from being opened and to accept data as\-is.
72
- .TP
73
- .B \fB\-\-defaults\fP
74
- Use to have knife use the default value instead of asking a user to provide one.
75
- .TP
76
- .B \fB\-\-[no\-]diff\fP
77
- Use to upload only new and modified files. Set to \fBfalse\fP to upload all files. Default: \fBtrue\fP\&.
78
- .TP
79
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
80
- The $EDITOR that is used for all interactive commands.
81
- .TP
82
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
83
- The name of the environment. When this option is added to a command, the command will run only against the named environment.
84
- .TP
85
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
86
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
87
- .TP
88
- .B \fB\-\-[no\-]force\fP
89
- Use \fB\-\-force\fP to upload roles, cookbooks, etc. even if the file in the directory is identical (by default, no \fBPOST\fP or \fBPUT\fP is performed unless an actual change would be made). Default: \fB\-\-no\-force\fP\&.
90
- .TP
91
- .B \fB\-\-[no\-]freeze\fP
92
- Use to require changes to a cookbook be included as a new version. Only the \fB\-\-force\fP option can override this setting. Default: \fBfalse\fP\&.
93
- .TP
94
- .B \fB\-h\fP, \fB\-\-help\fP
95
- Shows help for the command.
96
- .TP
97
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
98
- The private key that knife will use to sign requests made by the API client to the Chef server\&.
99
- .TP
100
- .B \fB\-n\fP, \fB\-\-dry\-run\fP
101
- Use to take no action and only print out results. Default: \fBfalse\fP\&.
102
- .TP
103
- .B \fB\-\-print\-after\fP
104
- Use to show data after a destructive operation.
105
- .TP
106
- .B \fB\-\-[no\-]purge\fP
107
- Use \fB\-\-purge\fP to delete roles, cookbooks, etc. from the Chef server if their corresponding files do not exist in the chef\-repo\&. By default, such objects are left alone and NOT purged. Default: \fB\-\-no\-purge\fP\&.
108
- .TP
109
- .B \fB\-\-[no\-]recurse\fP
110
- Use \fB\-\-no\-recurse\fP to disable uploading a directory recursively. Default: \fB\-\-recurse\fP\&.
111
- .TP
112
- .B \fB\-\-repo\-mode MODE\fP
113
- 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\&.
114
- .TP
115
- .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
116
- The URL for the Chef server\&.
117
- .TP
118
- .B \fB\-u USER\fP, \fB\-\-user USER\fP
119
- 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.
120
- .TP
121
- .B \fB\-v\fP, \fB\-\-version\fP
122
- The version of the chef\-client\&.
123
- .TP
124
- .B \fB\-V\fP, \fB\-\-verbose\fP
125
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
126
- .TP
127
- .B \fB\-y\fP, \fB\-\-yes\fP
128
- Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
129
- .TP
130
- .B \fB\-z\fP, \fB\-\-local\-mode\fP
131
- 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\&.
132
- .UNINDENT
133
- .sp
134
- \fBExamples\fP
135
- .sp
136
- Browse to the top level of the chef\-repo and enter:
137
- .INDENT 0.0
138
- .INDENT 3.5
139
- .sp
140
- .nf
141
- .ft C
142
- $ knife upload
143
- .ft P
144
- .fi
145
- .UNINDENT
146
- .UNINDENT
147
- .sp
148
- or from anywhere in the chef\-repo, enter:
149
- .INDENT 0.0
150
- .INDENT 3.5
151
- .sp
152
- .nf
153
- .ft C
154
- $ knife upload /
155
- .ft P
156
- .fi
157
- .UNINDENT
158
- .UNINDENT
159
- .sp
160
- Browse to the top level of the chef\-repo and enter:
161
- .INDENT 0.0
162
- .INDENT 3.5
163
- .sp
164
- .nf
165
- .ft C
166
- $ knife upload cookbooks
167
- .ft P
168
- .fi
169
- .UNINDENT
170
- .UNINDENT
171
- .sp
172
- or from anywhere in the chef\-repo, enter:
173
- .INDENT 0.0
174
- .INDENT 3.5
175
- .sp
176
- .nf
177
- .ft C
178
- $ knife upload /cookbooks
179
- .ft P
180
- .fi
181
- .UNINDENT
182
- .UNINDENT
183
- .sp
184
- Browse to the top level of the chef\-repo and enter:
185
- .INDENT 0.0
186
- .INDENT 3.5
187
- .sp
188
- .nf
189
- .ft C
190
- $ knife upload environments
191
- .ft P
192
- .fi
193
- .UNINDENT
194
- .UNINDENT
195
- .sp
196
- or from anywhere in the chef\-repo, enter:
197
- .INDENT 0.0
198
- .INDENT 3.5
199
- .sp
200
- .nf
201
- .ft C
202
- $ knife upload /environments
203
- .ft P
204
- .fi
205
- .UNINDENT
206
- .UNINDENT
207
- .sp
208
- Browse to the top level of the chef\-repo and enter:
209
- .INDENT 0.0
210
- .INDENT 3.5
211
- .sp
212
- .nf
213
- .ft C
214
- $ knife upload environments/production.json
215
- .ft P
216
- .fi
217
- .UNINDENT
218
- .UNINDENT
219
- .sp
220
- or from the \fBenvironments/\fP directory, enter:
221
- .INDENT 0.0
222
- .INDENT 3.5
223
- .sp
224
- .nf
225
- .ft C
226
- $ knife upload production.json
227
- .ft P
228
- .fi
229
- .UNINDENT
230
- .UNINDENT
231
- .sp
232
- Browse to the top level of the chef\-repo and enter:
233
- .INDENT 0.0
234
- .INDENT 3.5
235
- .sp
236
- .nf
237
- .ft C
238
- $ knife upload roles
239
- .ft P
240
- .fi
241
- .UNINDENT
242
- .UNINDENT
243
- .sp
244
- or from anywhere in the chef\-repo, enter:
245
- .INDENT 0.0
246
- .INDENT 3.5
247
- .sp
248
- .nf
249
- .ft C
250
- $ knife upload /roles
251
- .ft P
252
- .fi
253
- .UNINDENT
254
- .UNINDENT
255
- .sp
256
- Browse to the top level of the chef\-repo and enter:
257
- .INDENT 0.0
258
- .INDENT 3.5
259
- .sp
260
- .nf
261
- .ft C
262
- $ knife upload cookbooks/apache\e* roles/webserver.json
263
- .ft P
264
- .fi
265
- .UNINDENT
266
- .UNINDENT
267
- .INDENT 0.0
268
- .INDENT 3.5
269
- .sp
270
- .nf
271
- .ft C
272
- $ knife upload \(gaknife deps nodes/*.json\(ga
273
- .ft P
274
- .fi
275
- .UNINDENT
276
- .UNINDENT
277
- .SH AUTHOR
278
- Chef
279
- .\" Generated by docutils manpage writer.
280
- .
@@ -1,356 +0,0 @@
1
- .\" Man page generated from reStructuredText.
2
- .
3
- .TH "KNIFE-USER" "1" "Chef 12.0" "" "knife user"
4
- .SH NAME
5
- knife-user \- The man page for the knife user 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 user\fP subcommand is used to manage the list of users and their associated RSA public key\-pairs.
35
- .sp
36
- \fBNOTE:\fP
37
- .INDENT 0.0
38
- .INDENT 3.5
39
- This subcommand ONLY works when run against the open source Chef server version 10.x. This subcommand will NOT run against open source Chef server 11, Enterprise Chef (including hosted Enterprise Chef), or Private Chef\&.
40
- .UNINDENT
41
- .UNINDENT
42
- .SH COMMON OPTIONS
43
- .sp
44
- The following options may be used with any of the arguments available to the \fBknife user\fP subcommand:
45
- .INDENT 0.0
46
- .TP
47
- .B \fB\-\-chef\-zero\-port PORT\fP
48
- The port on which chef\-zero will listen.
49
- .TP
50
- .B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
51
- The configuration file to use.
52
- .TP
53
- .B \fB\-d\fP, \fB\-\-disable\-editing\fP
54
- Use to prevent the $EDITOR from being opened and to accept data as\-is.
55
- .TP
56
- .B \fB\-\-defaults\fP
57
- Use to have knife use the default value instead of asking a user to provide one.
58
- .TP
59
- .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
60
- The $EDITOR that is used for all interactive commands.
61
- .TP
62
- .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
63
- The name of the environment. When this option is added to a command, the command will run only against the named environment.
64
- .TP
65
- .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
66
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
67
- .TP
68
- .B \fB\-h\fP, \fB\-\-help\fP
69
- Shows help for the command.
70
- .TP
71
- .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
72
- The private key that knife will use to sign requests made by the API client to the Chef server\&.
73
- .TP
74
- .B \fB\-\-[no\-]color\fP
75
- Use to view colored output.
76
- .TP
77
- .B \fB\-\-print\-after\fP
78
- Use to show data after a destructive operation.
79
- .TP
80
- .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
81
- The URL for the Chef 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 Chef server\&. Authentication will fail if the user name does not match the private key.
85
- .TP
86
- .B \fB\-V\fP, \fB\-\-verbose\fP
87
- Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
88
- .TP
89
- .B \fB\-v\fP, \fB\-\-version\fP
90
- The version of the chef\-client\&.
91
- .TP
92
- .B \fB\-y\fP, \fB\-\-yes\fP
93
- Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
94
- .TP
95
- .B \fB\-z\fP, \fB\-\-local\-mode\fP
96
- 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\&.
97
- .UNINDENT
98
- .SH CREATE
99
- .sp
100
- The \fBcreate\fP argument is used to create a user. This process will generate an RSA key pair for the named user. The public key will be stored on the Chef server and the private key will be displayed on \fBSTDOUT\fP or written to a named file.
101
- .INDENT 0.0
102
- .IP \(bu 2
103
- For the user, the private key should be copied to the system as \fB/etc/chef/client.pem\fP\&.
104
- .IP \(bu 2
105
- For knife, the private key is typically copied to \fB~/.chef/client_name.pem\fP and referenced in the knife.rb configuration file.
106
- .UNINDENT
107
- .sp
108
- \fBSyntax\fP
109
- .sp
110
- This argument has the following syntax:
111
- .INDENT 0.0
112
- .INDENT 3.5
113
- .sp
114
- .nf
115
- .ft C
116
- $ knife user create USER_NAME (options)
117
- .ft P
118
- .fi
119
- .UNINDENT
120
- .UNINDENT
121
- .sp
122
- \fBOptions\fP
123
- .sp
124
- This argument has the following options:
125
- .INDENT 0.0
126
- .TP
127
- .B \fB\-a\fP, \fB\-\-admin\fP
128
- Use to create a client as an admin client. This is required for any user to access Open Source Chef as an administrator. This option only works when used with the open source Chef server and will have no effect when used with Enterprise Chef\&.
129
- .TP
130
- .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
131
- Use to save a private key to the specified file name.
132
- .TP
133
- .B \fB\-p PASSWORD\fP, \fB\-\-password PASSWORD\fP
134
- The user password.
135
- .TP
136
- .B \fB\-\-user\-key FILE_NAME\fP
137
- All users are assigned a public key. Use to write the public key to a file.
138
- .UNINDENT
139
- .sp
140
- \fBExamples\fP
141
- .INDENT 0.0
142
- .INDENT 3.5
143
- .sp
144
- .nf
145
- .ft C
146
- $ knife user create "Radio Birdman" \-f /keys/user_name
147
- .ft P
148
- .fi
149
- .UNINDENT
150
- .UNINDENT
151
- .SH DELETE
152
- .sp
153
- The \fBdelete\fP argument is used to delete a registered user.
154
- .sp
155
- \fBSyntax\fP
156
- .sp
157
- This argument has the following syntax:
158
- .INDENT 0.0
159
- .INDENT 3.5
160
- .sp
161
- .nf
162
- .ft C
163
- $ knife user delete USER_NAME
164
- .ft P
165
- .fi
166
- .UNINDENT
167
- .UNINDENT
168
- .sp
169
- \fBOptions\fP
170
- .sp
171
- This command does not have any specific options.
172
- .sp
173
- \fBExamples\fP
174
- .INDENT 0.0
175
- .INDENT 3.5
176
- .sp
177
- .nf
178
- .ft C
179
- $ knife user delete "Steve Danno"
180
- .ft P
181
- .fi
182
- .UNINDENT
183
- .UNINDENT
184
- .SH EDIT
185
- .sp
186
- The \fBedit\fP argument is used to edit the details of a user. When this argument is run, knife will open $EDITOR\&. When finished, knife will update the Chef server with those changes.
187
- .sp
188
- \fBSyntax\fP
189
- .sp
190
- This argument has the following syntax:
191
- .INDENT 0.0
192
- .INDENT 3.5
193
- .sp
194
- .nf
195
- .ft C
196
- $ knife user edit USER_NAME
197
- .ft P
198
- .fi
199
- .UNINDENT
200
- .UNINDENT
201
- .sp
202
- \fBOptions\fP
203
- .sp
204
- This command does not have any specific options.
205
- .sp
206
- \fBExamples\fP
207
- .sp
208
- None.
209
- .SH LIST
210
- .sp
211
- The \fBlist\fP argument is used to view a list of registered users.
212
- .sp
213
- \fBSyntax\fP
214
- .sp
215
- This argument has the following syntax:
216
- .INDENT 0.0
217
- .INDENT 3.5
218
- .sp
219
- .nf
220
- .ft C
221
- $ knife user list (options)
222
- .ft P
223
- .fi
224
- .UNINDENT
225
- .UNINDENT
226
- .sp
227
- \fBOptions\fP
228
- .sp
229
- This argument has the following options:
230
- .INDENT 0.0
231
- .TP
232
- .B \fB\-w\fP, \fB\-\-with\-uri\fP
233
- Use to show the corresponding URIs.
234
- .UNINDENT
235
- .sp
236
- \fBExamples\fP
237
- .sp
238
- None.
239
- .SH REREGISTER
240
- .sp
241
- The \fBreregister\fP argument is used to regenerate an RSA key pair for a user. The public key will be stored on the Chef server and the private key will be displayed on \fBSTDOUT\fP or written to a named file.
242
- .sp
243
- \fBNOTE:\fP
244
- .INDENT 0.0
245
- .INDENT 3.5
246
- Running this argument will invalidate the previous RSA key pair, making it unusable during authentication to the Chef server\&.
247
- .UNINDENT
248
- .UNINDENT
249
- .sp
250
- \fBSyntax\fP
251
- .sp
252
- This argument has the following syntax:
253
- .INDENT 0.0
254
- .INDENT 3.5
255
- .sp
256
- .nf
257
- .ft C
258
- $ knife user reregister USER_NAME (options)
259
- .ft P
260
- .fi
261
- .UNINDENT
262
- .UNINDENT
263
- .sp
264
- \fBOptions\fP
265
- .sp
266
- This argument has the following options:
267
- .INDENT 0.0
268
- .TP
269
- .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
270
- Use to save a private key to the specified file name.
271
- .UNINDENT
272
- .sp
273
- \fBExamples\fP
274
- .INDENT 0.0
275
- .INDENT 3.5
276
- .sp
277
- .nf
278
- .ft C
279
- $ knife user reregister "Robert Younger"
280
- .ft P
281
- .fi
282
- .UNINDENT
283
- .UNINDENT
284
- .SH SHOW
285
- .sp
286
- The \fBshow\fP argument is used to show the details of a user.
287
- .sp
288
- \fBSyntax\fP
289
- .sp
290
- This argument has the following syntax:
291
- .INDENT 0.0
292
- .INDENT 3.5
293
- .sp
294
- .nf
295
- .ft C
296
- $ knife user show USER_NAME (options)
297
- .ft P
298
- .fi
299
- .UNINDENT
300
- .UNINDENT
301
- .sp
302
- \fBOptions\fP
303
- .sp
304
- This argument has the following options:
305
- .INDENT 0.0
306
- .TP
307
- .B \fB\-a ATTR\fP, \fB\-\-attribute ATTR\fP
308
- The attribute (or attributes) to show.
309
- .UNINDENT
310
- .sp
311
- \fBExamples\fP
312
- .sp
313
- To view a user named \fBDennis Teck\fP, enter:
314
- .INDENT 0.0
315
- .INDENT 3.5
316
- .sp
317
- .nf
318
- .ft C
319
- $ knife user show "Dennis Teck"
320
- .ft P
321
- .fi
322
- .UNINDENT
323
- .UNINDENT
324
- .sp
325
- to return something like:
326
- .INDENT 0.0
327
- .INDENT 3.5
328
- .sp
329
- .nf
330
- .ft C
331
- chef_type: user
332
- json_class: Chef::User
333
- name: Dennis Teck
334
- public_key:
335
- .ft P
336
- .fi
337
- .UNINDENT
338
- .UNINDENT
339
- .sp
340
- To view information in JSON format, use the \fB\-F\fP common option as part of the command like this:
341
- .INDENT 0.0
342
- .INDENT 3.5
343
- .sp
344
- .nf
345
- .ft C
346
- $ knife user show "Dennis Teck" \-F json
347
- .ft P
348
- .fi
349
- .UNINDENT
350
- .UNINDENT
351
- .sp
352
- (Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP, e.g. \fB\-F yaml\fP for YAML\&.)
353
- .SH AUTHOR
354
- Chef
355
- .\" Generated by docutils manpage writer.
356
- .