chef 11.12.8 → 11.14.0.alpha.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (193) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +4 -2
  3. data/distro/common/html/_sources/index.txt +6 -0
  4. data/distro/common/html/_sources/knife_ssl_check.txt +41 -0
  5. data/distro/common/html/_sources/knife_ssl_fetch.txt +41 -0
  6. data/distro/common/html/_static/basic.css +2 -5
  7. data/distro/common/html/_static/doctools.js +5 -14
  8. data/distro/common/html/_static/jquery.js +2 -154
  9. data/distro/common/html/_static/pygments.css +2 -2
  10. data/distro/common/html/_static/searchtools.js +212 -150
  11. data/distro/common/html/_static/underscore.js +29 -21
  12. data/distro/common/html/_static/websupport.js +1 -1
  13. data/distro/common/html/ctl_chef_client.html +15 -18
  14. data/distro/common/html/ctl_chef_server.html +7 -7
  15. data/distro/common/html/ctl_chef_shell.html +6 -6
  16. data/distro/common/html/ctl_chef_solo.html +7 -8
  17. data/distro/common/html/index.html +34 -24
  18. data/distro/common/html/knife.html +23 -24
  19. data/distro/common/html/knife_bootstrap.html +13 -9
  20. data/distro/common/html/knife_client.html +10 -11
  21. data/distro/common/html/knife_common_options.html +6 -7
  22. data/distro/common/html/knife_configure.html +3 -4
  23. data/distro/common/html/knife_cookbook.html +18 -11
  24. data/distro/common/html/knife_cookbook_site.html +14 -14
  25. data/distro/common/html/knife_data_bag.html +24 -23
  26. data/distro/common/html/knife_delete.html +4 -5
  27. data/distro/common/html/knife_deps.html +4 -5
  28. data/distro/common/html/knife_diff.html +6 -7
  29. data/distro/common/html/knife_download.html +12 -13
  30. data/distro/common/html/knife_edit.html +4 -5
  31. data/distro/common/html/knife_environment.html +8 -9
  32. data/distro/common/html/knife_exec.html +9 -10
  33. data/distro/common/html/knife_index_rebuild.html +4 -5
  34. data/distro/common/html/knife_list.html +8 -9
  35. data/distro/common/html/knife_node.html +34 -33
  36. data/distro/common/html/knife_raw.html +2 -3
  37. data/distro/common/html/knife_recipe_list.html +3 -4
  38. data/distro/common/html/knife_role.html +30 -29
  39. data/distro/common/html/knife_search.html +7 -7
  40. data/distro/common/html/knife_show.html +4 -5
  41. data/distro/common/html/knife_ssh.html +2 -3
  42. data/distro/common/html/knife_ssl_check.html +148 -0
  43. data/distro/common/html/knife_ssl_fetch.html +152 -0
  44. data/distro/common/html/knife_status.html +4 -5
  45. data/distro/common/html/knife_tag.html +2 -3
  46. data/distro/common/html/knife_upload.html +5 -6
  47. data/distro/common/html/knife_user.html +9 -10
  48. data/distro/common/html/knife_using.html +12 -12
  49. data/distro/common/html/knife_xargs.html +11 -12
  50. data/distro/common/html/search.html +1 -2
  51. data/distro/common/html/searchindex.js +1 -1
  52. data/distro/common/man/man1/chef-shell.1 +19 -11
  53. data/distro/common/man/man1/knife-bootstrap.1 +35 -19
  54. data/distro/common/man/man1/knife-client.1 +111 -28
  55. data/distro/common/man/man1/knife-configure.1 +30 -14
  56. data/distro/common/man/man1/knife-cookbook-site.1 +105 -22
  57. data/distro/common/man/man1/knife-cookbook.1 +164 -23
  58. data/distro/common/man/man1/knife-data-bag.1 +157 -33
  59. data/distro/common/man/man1/knife-delete.1 +21 -17
  60. data/distro/common/man/man1/knife-deps.1 +60 -16
  61. data/distro/common/man/man1/knife-diff.1 +37 -17
  62. data/distro/common/man/man1/knife-download.1 +68 -24
  63. data/distro/common/man/man1/knife-edit.1 +19 -15
  64. data/distro/common/man/man1/knife-environment.1 +105 -17
  65. data/distro/common/man/man1/knife-exec.1 +78 -18
  66. data/distro/common/man/man1/knife-index-rebuild.1 +16 -8
  67. data/distro/common/man/man1/knife-list.1 +39 -23
  68. data/distro/common/man/man1/knife-node.1 +170 -22
  69. data/distro/common/man/man1/knife-raw.1 +33 -13
  70. data/distro/common/man/man1/knife-recipe-list.1 +17 -5
  71. data/distro/common/man/man1/knife-role.1 +86 -18
  72. data/distro/common/man/man1/knife-search.1 +80 -16
  73. data/distro/common/man/man1/knife-show.1 +30 -14
  74. data/distro/common/man/man1/knife-ssh.1 +54 -14
  75. data/distro/common/man/man1/knife-ssl-check.1 +207 -0
  76. data/distro/common/man/man1/knife-ssl-fetch.1 +207 -0
  77. data/distro/common/man/man1/knife-status.1 +48 -12
  78. data/distro/common/man/man1/knife-tag.1 +30 -10
  79. data/distro/common/man/man1/knife-upload.1 +72 -20
  80. data/distro/common/man/man1/knife-user.1 +79 -23
  81. data/distro/common/man/man1/knife-xargs.1 +61 -53
  82. data/distro/common/man/man8/chef-client.8 +87 -29
  83. data/distro/common/man/man8/chef-solo.8 +36 -15
  84. data/lib/chef/application.rb +19 -14
  85. data/lib/chef/application/client.rb +5 -0
  86. data/lib/chef/application/solo.rb +5 -0
  87. data/lib/chef/application/windows_service_manager.rb +3 -0
  88. data/lib/chef/chef_fs/chef_fs_data_store.rb +72 -24
  89. data/lib/chef/chef_fs/file_system/chef_repository_file_system_cookbook_dir.rb +20 -4
  90. data/lib/chef/chef_fs/file_system/chef_repository_file_system_cookbooks_dir.rb +20 -1
  91. data/lib/chef/chef_fs/file_system/file_system_entry.rb +10 -2
  92. data/lib/chef/client.rb +2 -3
  93. data/lib/chef/config.rb +34 -8
  94. data/lib/chef/cookbook/cookbook_version_loader.rb +45 -4
  95. data/lib/chef/cookbook_version.rb +38 -30
  96. data/lib/chef/dsl/recipe.rb +4 -1
  97. data/lib/chef/event_dispatch/base.rb +14 -0
  98. data/lib/chef/event_dispatch/events_output_stream.rb +29 -0
  99. data/lib/chef/exceptions.rb +8 -0
  100. data/lib/chef/formatters/base.rb +16 -45
  101. data/lib/chef/formatters/doc.rb +51 -26
  102. data/lib/chef/formatters/indentable_output_stream.rb +165 -0
  103. data/lib/chef/knife/node_environment_set.rb +54 -0
  104. data/lib/chef/knife/user_create.rb +1 -1
  105. data/lib/chef/monkey_patches/pathname.rb +32 -0
  106. data/lib/chef/node.rb +1 -1
  107. data/lib/chef/platform/provider_mapping.rb +345 -338
  108. data/lib/chef/policy_builder/expand_node_object.rb +1 -1
  109. data/lib/chef/policy_builder/policyfile.rb +1 -1
  110. data/lib/chef/provider.rb +1 -0
  111. data/lib/chef/provider/git.rb +1 -1
  112. data/lib/chef/provider/link.rb +2 -2
  113. data/lib/chef/provider/remote_file/content.rb +1 -1
  114. data/lib/chef/provider/remote_file/local_file.rb +8 -2
  115. data/lib/chef/provider/service/arch.rb +0 -1
  116. data/lib/chef/provider/service/debian.rb +0 -2
  117. data/lib/chef/provider/service/freebsd.rb +2 -1
  118. data/lib/chef/provider/service/gentoo.rb +1 -1
  119. data/lib/chef/provider/service/init.rb +0 -1
  120. data/lib/chef/provider/service/insserv.rb +0 -2
  121. data/lib/chef/provider/service/invokercd.rb +0 -2
  122. data/lib/chef/provider/service/macosx.rb +2 -1
  123. data/lib/chef/provider/service/redhat.rb +0 -1
  124. data/lib/chef/provider/service/simple.rb +1 -0
  125. data/lib/chef/provider/service/solaris.rb +1 -0
  126. data/lib/chef/provider/service/systemd.rb +1 -1
  127. data/lib/chef/provider/service/upstart.rb +1 -1
  128. data/lib/chef/provider/user.rb +9 -9
  129. data/lib/chef/provider/user/solaris.rb +2 -0
  130. data/lib/chef/resource.rb +1 -0
  131. data/lib/chef/resource/remote_file.rb +32 -6
  132. data/lib/chef/run_context.rb +22 -0
  133. data/lib/chef/run_lock.rb +43 -4
  134. data/lib/chef/version.rb +2 -2
  135. data/spec/functional/http/simple_spec.rb +84 -0
  136. data/spec/functional/resource/remote_file_spec.rb +107 -43
  137. data/spec/functional/rest_spec.rb +94 -0
  138. data/spec/functional/run_lock_spec.rb +1 -1
  139. data/spec/functional/win32/service_manager_spec.rb +6 -0
  140. data/spec/integration/knife/chef_fs_data_store_spec.rb +2 -0
  141. data/spec/integration/recipes/lwrp_inline_resources_spec.rb +76 -0
  142. data/spec/spec_helper.rb +2 -0
  143. data/spec/support/mock/platform.rb +7 -0
  144. data/spec/support/pedant/pedant_config.rb +121 -0
  145. data/spec/support/pedant/run_pedant.rb +63 -0
  146. data/spec/support/pedant/stickywicket.pem +27 -0
  147. data/spec/support/shared/functional/http.rb +242 -0
  148. data/spec/support/shared/unit/api_error_inspector.rb +2 -2
  149. data/spec/unit/api_client_spec.rb +2 -2
  150. data/spec/unit/application/client_spec.rb +6 -1
  151. data/spec/unit/application/knife_spec.rb +4 -0
  152. data/spec/unit/application/solo_spec.rb +2 -0
  153. data/spec/unit/application_spec.rb +7 -0
  154. data/spec/unit/client_spec.rb +16 -0
  155. data/spec/unit/config_spec.rb +3 -20
  156. data/spec/unit/cookbook_version_spec.rb +224 -122
  157. data/spec/unit/formatters/error_inspectors/compile_error_inspector_spec.rb +2 -2
  158. data/spec/unit/formatters/error_inspectors/cookbook_resolve_error_inspector_spec.rb +2 -2
  159. data/spec/unit/formatters/error_inspectors/cookbook_sync_error_inspector_spec.rb +2 -2
  160. data/spec/unit/formatters/error_inspectors/resource_failure_inspector_spec.rb +2 -2
  161. data/spec/unit/formatters/error_inspectors/run_list_expansion_error_inspector_spec.rb +2 -2
  162. data/spec/unit/handler_spec.rb +0 -1
  163. data/spec/unit/knife/client_bulk_delete_spec.rb +3 -0
  164. data/spec/unit/knife/cookbook_bulk_delete_spec.rb +2 -0
  165. data/spec/unit/knife/cookbook_metadata_spec.rb +2 -2
  166. data/spec/unit/knife/cookbook_site_install_spec.rb +3 -1
  167. data/spec/unit/knife/cookbook_upload_spec.rb +10 -10
  168. data/spec/unit/knife/node_environment_set_spec.rb +80 -0
  169. data/spec/unit/knife/user_create_spec.rb +6 -4
  170. data/spec/unit/knife/user_edit_spec.rb +5 -0
  171. data/spec/unit/knife_spec.rb +3 -0
  172. data/spec/unit/mixin/securable_spec.rb +18 -20
  173. data/spec/unit/node/attribute_spec.rb +15 -2
  174. data/spec/unit/node/immutable_collections_spec.rb +4 -4
  175. data/spec/unit/provider/cron_spec.rb +14 -14
  176. data/spec/unit/provider/git_spec.rb +4 -4
  177. data/spec/unit/provider/group_spec.rb +1 -1
  178. data/spec/unit/provider/ohai_spec.rb +2 -2
  179. data/spec/unit/provider/remote_file/content_spec.rb +58 -35
  180. data/spec/unit/provider/remote_file/local_file_spec.rb +23 -0
  181. data/spec/unit/provider/service/solaris_smf_service_spec.rb +13 -13
  182. data/spec/unit/resource/mount_spec.rb +0 -1
  183. data/spec/unit/resource/remote_file_spec.rb +29 -0
  184. data/spec/unit/resource_spec.rb +1 -1
  185. data/spec/unit/run_context_spec.rb +7 -0
  186. data/spec/unit/run_lock_spec.rb +98 -0
  187. data/spec/unit/version_constraint_spec.rb +1 -1
  188. metadata +164 -151
  189. data/distro/common/html/_static/chef.css +0 -507
  190. data/distro/common/html/_static/chef_logo.png +0 -0
  191. data/lib/chef/checksum/storage.rb +0 -18
  192. data/lib/chef/checksum/storage/filesystem.rb +0 -56
  193. data/spec/unit/checksum/storage/filesystem_spec.rb +0 -70
@@ -1,4 +1,6 @@
1
- .TH "KNIFE-RAW" "1" "Chef 11.10.0" "" "knife raw"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-RAW" "1" "Chef 11.12.0" "" "knife raw"
2
4
  .SH NAME
3
5
  knife-raw \- The man page for the knife raw subcommand.
4
6
  .
@@ -28,20 +30,22 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
28
30
  .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
31
  .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30
32
  ..
31
- .\" Man page generated from reStructuredText.
32
- .
33
33
  .sp
34
- The \fBknife raw\fP subcommand is used to send a REST request to a specified path using the Chef Server API.
34
+ The \fBknife raw\fP subcommand is used to send a REST request to a specified path using the Chef Server API\&.
35
35
  .sp
36
36
  \fBSyntax\fP
37
37
  .sp
38
- This argument has the following syntax:
38
+ This subcommand has the following syntax:
39
+ .INDENT 0.0
40
+ .INDENT 3.5
39
41
  .sp
40
42
  .nf
41
43
  .ft C
42
44
  $ knife raw REQUEST_PATH (options)
43
45
  .ft P
44
46
  .fi
47
+ .UNINDENT
48
+ .UNINDENT
45
49
  .sp
46
50
  \fBOptions\fP
47
51
  .sp
@@ -70,7 +74,7 @@ The $EDITOR that is used for all interactive commands.
70
74
  The name of the environment. When this option is added to a command, the command will run only against the named environment.
71
75
  .TP
72
76
  .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
73
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
77
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
74
78
  .TP
75
79
  .B \fB\-h\fP, \fB\-\-help\fP
76
80
  Shows help for the command.
@@ -79,25 +83,25 @@ Shows help for the command.
79
83
  The name of a file to be used with the \fBPUT\fP or a \fBPOST\fP request.
80
84
  .TP
81
85
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
82
- The private key that Knife will use to sign requests made by the API client to the server.
86
+ The private key that Knife will use to sign requests made by the API client to the Chef server\&.
83
87
  .TP
84
88
  .B \fB\-m METHOD\fP, \fB\-\-method METHOD\fP
85
- The request method: \fBDELETE\fP, \fBGET\fP, \fBPOST\fP, or \fBPUT\fP. Default value: \fBGET\fP.
89
+ The request method: \fBDELETE\fP, \fBGET\fP, \fBPOST\fP, or \fBPUT\fP\&. Default value: \fBGET\fP\&.
86
90
  .TP
87
91
  .B \fB\-\-[no\-]pretty\fP
88
- Use \fB\-\-no\-pretty\fP to disable pretty\-print output for JSON. Default: \fB\-\-pretty\fP.
92
+ Use \fB\-\-no\-pretty\fP to disable pretty\-print output for JSON\&. Default: \fB\-\-pretty\fP\&.
89
93
  .TP
90
94
  .B \fB\-\-print\-after\fP
91
95
  Indicates that data will be shown after a destructive operation.
92
96
  .TP
93
97
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
94
- The URL for the server.
98
+ The URL for the Chef server\&.
95
99
  .TP
96
100
  .B \fB\-u USER\fP, \fB\-\-user USER\fP
97
- 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.
101
+ 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.
98
102
  .TP
99
103
  .B \fB\-v\fP, \fB\-\-version\fP
100
- The version of the chef\-client.
104
+ The version of the chef\-client\&.
101
105
  .TP
102
106
  .B \fB\-V\fP, \fB\-\-verbose\fP
103
107
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
@@ -106,36 +110,50 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
106
110
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
107
111
  .TP
108
112
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
109
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the server to also work against the local chef\-repo.
113
+ Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
110
114
  .UNINDENT
111
115
  .sp
112
116
  \fBExamples\fP
113
117
  .sp
114
118
  To view information about a client:
119
+ .INDENT 0.0
120
+ .INDENT 3.5
115
121
  .sp
116
122
  .nf
117
123
  .ft C
118
124
  knife raw /clients/<client_name>
119
125
  .ft P
120
126
  .fi
127
+ .UNINDENT
128
+ .UNINDENT
121
129
  .sp
122
130
  To view information about a node:
131
+ .INDENT 0.0
132
+ .INDENT 3.5
123
133
  .sp
124
134
  .nf
125
135
  .ft C
126
136
  knife raw /nodes/<node_name>
127
137
  .ft P
128
138
  .fi
139
+ .UNINDENT
140
+ .UNINDENT
129
141
  .sp
130
142
  To delete a data bag, enter a command similar to:
143
+ .INDENT 0.0
144
+ .INDENT 3.5
131
145
  .sp
132
146
  .nf
133
147
  .ft C
134
148
  $ knife raw \-m DELETE /data/foo
135
149
  .ft P
136
150
  .fi
151
+ .UNINDENT
152
+ .UNINDENT
137
153
  .sp
138
154
  to return something similar to:
155
+ .INDENT 0.0
156
+ .INDENT 3.5
139
157
  .sp
140
158
  .nf
141
159
  .ft C
@@ -146,6 +164,8 @@ to return something similar to:
146
164
  }
147
165
  .ft P
148
166
  .fi
167
+ .UNINDENT
168
+ .UNINDENT
149
169
  .SH AUTHOR
150
170
  Chef
151
171
  .\" Generated by docutils manpage writer.
@@ -1,4 +1,6 @@
1
- .TH "KNIFE-RECIPE-LIST" "1" "Chef 11.10.0" "" "knife recipe list"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-RECIPE-LIST" "1" "Chef 11.12.0" "" "knife recipe list"
2
4
  .SH NAME
3
5
  knife-recipe-list \- The man page for the knife recipe list subcommand.
4
6
  .
@@ -28,20 +30,22 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
28
30
  .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
31
  .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30
32
  ..
31
- .\" Man page generated from reStructuredText.
32
- .
33
33
  .sp
34
- The \fBknife recipe list\fP subcommand is used to view all of the recipes that are on a server. A regular expression can be used to limit the results to recipes that match a specific pattern. The regular expression must be within quotes and not be surrounded by forward slashes (/).
34
+ The \fBknife recipe list\fP subcommand is used to view all of the recipes that are on a Chef server\&. A regular expression can be used to limit the results to recipes that match a specific pattern. The regular expression must be within quotes and not be surrounded by forward slashes (/).
35
35
  .sp
36
36
  \fBSyntax\fP
37
37
  .sp
38
- This argument has the following syntax:
38
+ This subcommand has the following syntax:
39
+ .INDENT 0.0
40
+ .INDENT 3.5
39
41
  .sp
40
42
  .nf
41
43
  .ft C
42
44
  $ knife recipe list REGEX
43
45
  .ft P
44
46
  .fi
47
+ .UNINDENT
48
+ .UNINDENT
45
49
  .sp
46
50
  \fBOptions\fP
47
51
  .sp
@@ -50,14 +54,20 @@ This command does not have any specific options.
50
54
  \fBExamples\fP
51
55
  .sp
52
56
  To view a list of recipes:
57
+ .INDENT 0.0
58
+ .INDENT 3.5
53
59
  .sp
54
60
  .nf
55
61
  .ft C
56
62
  $ knife recipe list \(aqcouchdb::*\(aq
57
63
  .ft P
58
64
  .fi
65
+ .UNINDENT
66
+ .UNINDENT
59
67
  .sp
60
68
  to return:
69
+ .INDENT 0.0
70
+ .INDENT 3.5
61
71
  .sp
62
72
  .nf
63
73
  .ft C
@@ -67,6 +77,8 @@ couchdb::default
67
77
  couchdb::org_cleanu
68
78
  .ft P
69
79
  .fi
80
+ .UNINDENT
81
+ .UNINDENT
70
82
  .SH AUTHOR
71
83
  Chef
72
84
  .\" Generated by docutils manpage writer.
@@ -1,4 +1,6 @@
1
- .TH "KNIFE-ROLE" "1" "Chef 11.10.0" "" "knife role"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-ROLE" "1" "Chef 11.12.0" "" "knife role"
2
4
  .SH NAME
3
5
  knife-role \- The man page for the knife role subcommand.
4
6
  .
@@ -28,12 +30,10 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
28
30
  .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
31
  .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30
32
  ..
31
- .\" Man page generated from reStructuredText.
32
- .
33
33
  .sp
34
34
  A role is a way to define certain patterns and processes that exist across nodes in an organization as belonging to a single job function. Each role consists of zero (or more) attributes and a run list. Each node can have zero (or more) roles assigned to it. When a role is run against a node, the configuration details of that node are compared against the attributes of the role, and then the contents of that role\(aqs run list are applied to the node\(aqs configuration details. When a chef\-client runs, it merges its own attributes and run lists with those contained within each assigned role.
35
35
  .sp
36
- The \fBknife role\fP subcommand is used to manage the roles that are associated with one or more nodes on a server.
36
+ The \fBknife role\fP subcommand is used to manage the roles that are associated with one or more nodes on a Chef server\&.
37
37
  .SH COMMON OPTIONS
38
38
  .sp
39
39
  The following options may be used with any of the arguments available to the \fBknife role\fP subcommand:
@@ -58,13 +58,13 @@ The $EDITOR that is used for all interactive commands.
58
58
  The name of the environment. When this option is added to a command, the command will run only against the named environment.
59
59
  .TP
60
60
  .B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
61
- The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP.
61
+ The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
62
62
  .TP
63
63
  .B \fB\-h\fP, \fB\-\-help\fP
64
64
  Shows help for the command.
65
65
  .TP
66
66
  .B \fB\-k KEY\fP, \fB\-\-key KEY\fP
67
- The private key that Knife will use to sign requests made by the API client to the server.
67
+ The private key that Knife will use to sign requests made by the API client to the Chef server\&.
68
68
  .TP
69
69
  .B \fB\-\-[no\-]color\fP
70
70
  Indicates whether colored output will be used.
@@ -73,22 +73,22 @@ Indicates whether colored output will be used.
73
73
  Indicates that data will be shown after a destructive operation.
74
74
  .TP
75
75
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
76
- The URL for the server.
76
+ The URL for the Chef server\&.
77
77
  .TP
78
78
  .B \fB\-u USER\fP, \fB\-\-user USER\fP
79
- 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.
79
+ 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.
80
80
  .TP
81
81
  .B \fB\-V\fP, \fB\-\-verbose\fP
82
82
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
83
83
  .TP
84
84
  .B \fB\-v\fP, \fB\-\-version\fP
85
- The version of the chef\-client.
85
+ The version of the chef\-client\&.
86
86
  .TP
87
87
  .B \fB\-y\fP, \fB\-\-yes\fP
88
88
  Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
89
89
  .TP
90
90
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
91
- Indicates that the chef\-client will be run in local mode, which allows all commands that work against the server to also work against the local chef\-repo.
91
+ Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
92
92
  .UNINDENT
93
93
  .SH BULK DELETE
94
94
  .sp
@@ -97,12 +97,16 @@ The \fBbulk delete\fP argument is used to delete one or more roles that match a
97
97
  \fBSyntax\fP
98
98
  .sp
99
99
  This argument has the following syntax:
100
+ .INDENT 0.0
101
+ .INDENT 3.5
100
102
  .sp
101
103
  .nf
102
104
  .ft C
103
105
  $ knife role bulk delete REGEX
104
106
  .ft P
105
107
  .fi
108
+ .UNINDENT
109
+ .UNINDENT
106
110
  .sp
107
111
  \fBOptions\fP
108
112
  .sp
@@ -111,25 +115,33 @@ This command does not have any specific options.
111
115
  \fBExamples\fP
112
116
  .sp
113
117
  Use a regular expression to define the pattern used to bulk delete roles:
118
+ .INDENT 0.0
119
+ .INDENT 3.5
114
120
  .sp
115
121
  .nf
116
122
  .ft C
117
123
  $ knife role bulk delete "^[0\-9]{3}$"
118
124
  .ft P
119
125
  .fi
126
+ .UNINDENT
127
+ .UNINDENT
120
128
  .SH CREATE
121
129
  .sp
122
- The \fBcreate\fP argument is used to add a role to the server. Role data is saved as JSON on the server.
130
+ The \fBcreate\fP argument is used to add a role to the Chef server\&. Role data is saved as JSON on the Chef server\&.
123
131
  .sp
124
132
  \fBSyntax\fP
125
133
  .sp
126
134
  This argument has the following syntax:
135
+ .INDENT 0.0
136
+ .INDENT 3.5
127
137
  .sp
128
138
  .nf
129
139
  .ft C
130
140
  $ knife role create ROLE_NAME (options)
131
141
  .ft P
132
142
  .fi
143
+ .UNINDENT
144
+ .UNINDENT
133
145
  .sp
134
146
  \fBOptions\fP
135
147
  .sp
@@ -137,20 +149,26 @@ This argument has the following options:
137
149
  .INDENT 0.0
138
150
  .TP
139
151
  .B \fB\-d DESCRIPTION\fP, \fB\-\-description DESCRIPTION\fP
140
- The description of the role. This value will populate the description field for the role on the server.
152
+ The description of the role. This value will populate the description field for the role on the Chef server\&.
141
153
  .UNINDENT
142
154
  .sp
143
155
  \fBExamples\fP
144
156
  .sp
145
157
  To add a role named "role1", enter:
158
+ .INDENT 0.0
159
+ .INDENT 3.5
146
160
  .sp
147
161
  .nf
148
162
  .ft C
149
163
  $ knife role create role1
150
164
  .ft P
151
165
  .fi
166
+ .UNINDENT
167
+ .UNINDENT
152
168
  .sp
153
169
  In the $EDITOR enter the role data in JSON:
170
+ .INDENT 0.0
171
+ .INDENT 3.5
154
172
  .sp
155
173
  .nf
156
174
  .ft C
@@ -170,48 +188,62 @@ In the $EDITOR enter the role data in JSON:
170
188
  }
171
189
  .ft P
172
190
  .fi
191
+ .UNINDENT
192
+ .UNINDENT
173
193
  .sp
174
194
  When finished, save it.
175
195
  .SH DELETE
176
196
  .sp
177
- The \fBdelete\fP argument is used to delete a role from the server.
197
+ The \fBdelete\fP argument is used to delete a role from the Chef server\&.
178
198
  .sp
179
199
  \fBSyntax\fP
180
200
  .sp
181
201
  This argument has the following syntax:
202
+ .INDENT 0.0
203
+ .INDENT 3.5
182
204
  .sp
183
205
  .nf
184
206
  .ft C
185
207
  $ knife role delete ROLE_NAME
186
208
  .ft P
187
209
  .fi
210
+ .UNINDENT
211
+ .UNINDENT
188
212
  .sp
189
213
  \fBOptions\fP
190
214
  .sp
191
215
  This command does not have any specific options.
192
216
  .sp
193
217
  \fBExamples\fP
218
+ .INDENT 0.0
219
+ .INDENT 3.5
194
220
  .sp
195
221
  .nf
196
222
  .ft C
197
223
  $ knife role delete devops
198
224
  .ft P
199
225
  .fi
226
+ .UNINDENT
227
+ .UNINDENT
200
228
  .sp
201
229
  Type \fBY\fP to confirm a deletion.
202
230
  .SH EDIT
203
231
  .sp
204
- The \fBedit\fP argument is used to edit role details on the server.
232
+ The \fBedit\fP argument is used to edit role details on the Chef server\&.
205
233
  .sp
206
234
  \fBSyntax\fP
207
235
  .sp
208
236
  This argument has the following syntax:
237
+ .INDENT 0.0
238
+ .INDENT 3.5
209
239
  .sp
210
240
  .nf
211
241
  .ft C
212
242
  $ knife role edit ROLE_NAME
213
243
  .ft P
214
244
  .fi
245
+ .UNINDENT
246
+ .UNINDENT
215
247
  .sp
216
248
  \fBOptions\fP
217
249
  .sp
@@ -220,14 +252,20 @@ This command does not have any specific options.
220
252
  \fBExamples\fP
221
253
  .sp
222
254
  To edit the data for a role named "role1", enter:
255
+ .INDENT 0.0
256
+ .INDENT 3.5
223
257
  .sp
224
258
  .nf
225
259
  .ft C
226
260
  $ knife role edit role1
227
261
  .ft P
228
262
  .fi
263
+ .UNINDENT
264
+ .UNINDENT
229
265
  .sp
230
266
  Update the role data in JSON:
267
+ .INDENT 0.0
268
+ .INDENT 3.5
231
269
  .sp
232
270
  .nf
233
271
  .ft C
@@ -247,6 +285,8 @@ Update the role data in JSON:
247
285
  }
248
286
  .ft P
249
287
  .fi
288
+ .UNINDENT
289
+ .UNINDENT
250
290
  .sp
251
291
  When finished, save it.
252
292
  .SH FROM FILE
@@ -256,12 +296,16 @@ The \fBfrom file\fP argument is used to create a role using existing JSON data a
256
296
  \fBSyntax\fP
257
297
  .sp
258
298
  This argument has the following syntax:
299
+ .INDENT 0.0
300
+ .INDENT 3.5
259
301
  .sp
260
302
  .nf
261
303
  .ft C
262
304
  $ knife role from file FILE
263
305
  .ft P
264
306
  .fi
307
+ .UNINDENT
308
+ .UNINDENT
265
309
  .sp
266
310
  \fBOptions\fP
267
311
  .sp
@@ -270,25 +314,33 @@ This command does not have any specific options.
270
314
  \fBExamples\fP
271
315
  .sp
272
316
  To view role details based on the values contained in a JSON file:
317
+ .INDENT 0.0
318
+ .INDENT 3.5
273
319
  .sp
274
320
  .nf
275
321
  .ft C
276
322
  $ knife role from file "path to JSON file"
277
323
  .ft P
278
324
  .fi
325
+ .UNINDENT
326
+ .UNINDENT
279
327
  .SH LIST
280
328
  .sp
281
- The \fBlist\fP argument is used to view a list of roles that are currently available on the server.
329
+ The \fBlist\fP argument is used to view a list of roles that are currently available on the Chef server\&.
282
330
  .sp
283
331
  \fBSyntax\fP
284
332
  .sp
285
333
  This argument has the following syntax:
334
+ .INDENT 0.0
335
+ .INDENT 3.5
286
336
  .sp
287
337
  .nf
288
338
  .ft C
289
339
  $ knife role list
290
340
  .ft P
291
341
  .fi
342
+ .UNINDENT
343
+ .UNINDENT
292
344
  .sp
293
345
  \fBOptions\fP
294
346
  .sp
@@ -301,13 +353,17 @@ Indicates that the corresponding URIs will be shown.
301
353
  .sp
302
354
  \fBExamples\fP
303
355
  .sp
304
- To view a list of roles on the server and display the URI for each role returned, enter:
356
+ To view a list of roles on the Chef server and display the URI for each role returned, enter:
357
+ .INDENT 0.0
358
+ .INDENT 3.5
305
359
  .sp
306
360
  .nf
307
361
  .ft C
308
362
  $ knife role list \-w
309
363
  .ft P
310
364
  .fi
365
+ .UNINDENT
366
+ .UNINDENT
311
367
  .SH SHOW
312
368
  .sp
313
369
  The \fBshow\fP argument is used to view the details of a role.
@@ -315,12 +371,16 @@ The \fBshow\fP argument is used to view the details of a role.
315
371
  \fBSyntax\fP
316
372
  .sp
317
373
  This argument has the following syntax:
374
+ .INDENT 0.0
375
+ .INDENT 3.5
318
376
  .sp
319
377
  .nf
320
378
  .ft C
321
379
  $ knife role show ROLE_NAME
322
380
  .ft P
323
381
  .fi
382
+ .UNINDENT
383
+ .UNINDENT
324
384
  .sp
325
385
  \fBOptions\fP
326
386
  .sp
@@ -334,24 +394,32 @@ The attribute (or attributes) to show.
334
394
  \fBExamples\fP
335
395
  .sp
336
396
  To view information in JSON format, use the \fB\-F\fP common option as part of the command like this:
397
+ .INDENT 0.0
398
+ .INDENT 3.5
337
399
  .sp
338
400
  .nf
339
401
  .ft C
340
402
  $ knife role show devops \-F json
341
403
  .ft P
342
404
  .fi
405
+ .UNINDENT
406
+ .UNINDENT
343
407
  .sp
344
- Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP.
408
+ Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP\&.
345
409
  .sp
346
410
  To view information in JSON format, use the \fB\-F\fP common option as part of the command like this:
411
+ .INDENT 0.0
412
+ .INDENT 3.5
347
413
  .sp
348
414
  .nf
349
415
  .ft C
350
416
  $ knife role show devops \-F json
351
417
  .ft P
352
418
  .fi
419
+ .UNINDENT
420
+ .UNINDENT
353
421
  .sp
354
- Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP.
422
+ Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP\&.
355
423
  .SH AUTHOR
356
424
  Chef
357
425
  .\" Generated by docutils manpage writer.