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-NODE" "1" "Chef 11.10.0" "" "knife node"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "KNIFE-NODE" "1" "Chef 11.12.0" "" "knife node"
2
4
  .SH NAME
3
5
  knife-node \- The man page for the knife node 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
- A node is any physical, virtual, or cloud machine that is configured to be maintained by a chef\-client.
34
+ A node is any physical, virtual, or cloud machine that is configured to be maintained by a chef\-client\&.
35
35
  .sp
36
- The \fBknife node\fP subcommand is used to manage the nodes that exist on a server.
36
+ The \fBknife node\fP subcommand is used to manage the nodes that exist 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 node\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 nodes 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 node 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,27 +115,35 @@ 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 nodes:
118
+ .INDENT 0.0
119
+ .INDENT 3.5
114
120
  .sp
115
121
  .nf
116
122
  .ft C
117
123
  $ knife node bulk delete "^[0\-9]{3}$"
118
124
  .ft P
119
125
  .fi
126
+ .UNINDENT
127
+ .UNINDENT
120
128
  .sp
121
129
  Type \fBY\fP to confirm a deletion.
122
130
  .SH CREATE
123
131
  .sp
124
- The \fBcreate\fP argument is used to add a node to the server. Node data is stored as JSON on the server.
132
+ The \fBcreate\fP argument is used to add a node to the Chef server\&. Node data is stored as JSON on the Chef server\&.
125
133
  .sp
126
134
  \fBSyntax\fP
127
135
  .sp
128
136
  This argument has the following syntax:
137
+ .INDENT 0.0
138
+ .INDENT 3.5
129
139
  .sp
130
140
  .nf
131
141
  .ft C
132
142
  $ knife node create NODE_NAME
133
143
  .ft P
134
144
  .fi
145
+ .UNINDENT
146
+ .UNINDENT
135
147
  .sp
136
148
  \fBOptions\fP
137
149
  .sp
@@ -140,14 +152,20 @@ This command does not have any specific options.
140
152
  \fBExamples\fP
141
153
  .sp
142
154
  To add a node, enter:
155
+ .INDENT 0.0
156
+ .INDENT 3.5
143
157
  .sp
144
158
  .nf
145
159
  .ft C
146
160
  $ knife node create node1
147
161
  .ft P
148
162
  .fi
163
+ .UNINDENT
164
+ .UNINDENT
149
165
  .sp
150
166
  In the $EDITOR enter the node data in JSON:
167
+ .INDENT 0.0
168
+ .INDENT 3.5
151
169
  .sp
152
170
  .nf
153
171
  .ft C
@@ -171,49 +189,67 @@ In the $EDITOR enter the node data in JSON:
171
189
  }
172
190
  .ft P
173
191
  .fi
192
+ .UNINDENT
193
+ .UNINDENT
174
194
  .sp
175
195
  When finished, save it.
176
196
  .SH DELETE
177
197
  .sp
178
- The \fBdelete\fP argument is used to delete a node from the server.
179
- .IP Note
198
+ The \fBdelete\fP argument is used to delete a node from the Chef server\&.
199
+ .sp
200
+ \fBNOTE:\fP
201
+ .INDENT 0.0
202
+ .INDENT 3.5
180
203
  Deleting a node will not delete any corresponding API clients.
181
- .RE
204
+ .UNINDENT
205
+ .UNINDENT
182
206
  .sp
183
207
  \fBSyntax\fP
184
208
  .sp
185
209
  This argument has the following syntax:
210
+ .INDENT 0.0
211
+ .INDENT 3.5
186
212
  .sp
187
213
  .nf
188
214
  .ft C
189
215
  $ knife node delete NODE_NAME
190
216
  .ft P
191
217
  .fi
218
+ .UNINDENT
219
+ .UNINDENT
192
220
  .sp
193
221
  \fBOptions\fP
194
222
  .sp
195
223
  This command does not have any specific options.
196
224
  .sp
197
225
  \fBExamples\fP
226
+ .INDENT 0.0
227
+ .INDENT 3.5
198
228
  .sp
199
229
  .nf
200
230
  .ft C
201
231
  $ knife node delete node_name
202
232
  .ft P
203
233
  .fi
234
+ .UNINDENT
235
+ .UNINDENT
204
236
  .SH EDIT
205
237
  .sp
206
- The \fBedit\fP argument is used to edit the details of a node on a server. Node data is stored as JSON on the server.
238
+ The \fBedit\fP argument is used to edit the details of a node on a Chef server\&. Node data is stored as JSON on the Chef server\&.
207
239
  .sp
208
240
  \fBSyntax\fP
209
241
  .sp
210
242
  This argument has the following syntax:
243
+ .INDENT 0.0
244
+ .INDENT 3.5
211
245
  .sp
212
246
  .nf
213
247
  .ft C
214
248
  $ knife node edit NODE_NAME (options)
215
249
  .ft P
216
250
  .fi
251
+ .UNINDENT
252
+ .UNINDENT
217
253
  .sp
218
254
  \fBOptions\fP
219
255
  .sp
@@ -221,20 +257,26 @@ This argument has the following options:
221
257
  .INDENT 0.0
222
258
  .TP
223
259
  .B \fB\-a\fP, \fB\-\-all\fP
224
- Displays a node in the $EDITOR. By default, attributes that are default, override, or automatic are not shown.
260
+ Displays a node in the $EDITOR\&. By default, attributes that are default, override, or automatic are not shown.
225
261
  .UNINDENT
226
262
  .sp
227
263
  \fBExamples\fP
228
264
  .sp
229
265
  To edit the data for a node named "node1", enter:
266
+ .INDENT 0.0
267
+ .INDENT 3.5
230
268
  .sp
231
269
  .nf
232
270
  .ft C
233
271
  $ knife node edit node1 \-a
234
272
  .ft P
235
273
  .fi
274
+ .UNINDENT
275
+ .UNINDENT
236
276
  .sp
237
277
  Update the role data in JSON:
278
+ .INDENT 0.0
279
+ .INDENT 3.5
238
280
  .sp
239
281
  .nf
240
282
  .ft C
@@ -258,6 +300,8 @@ Update the role data in JSON:
258
300
  }
259
301
  .ft P
260
302
  .fi
303
+ .UNINDENT
304
+ .UNINDENT
261
305
  .sp
262
306
  When finished, save it.
263
307
  .SH FROM FILE
@@ -267,12 +311,16 @@ The \fBfrom file\fP argument is used to create a node using existing node data a
267
311
  \fBSyntax\fP
268
312
  .sp
269
313
  This argument has the following syntax:
314
+ .INDENT 0.0
315
+ .INDENT 3.5
270
316
  .sp
271
317
  .nf
272
318
  .ft C
273
319
  $ knife node from file FILE
274
320
  .ft P
275
321
  .fi
322
+ .UNINDENT
323
+ .UNINDENT
276
324
  .sp
277
325
  \fBOptions\fP
278
326
  .sp
@@ -281,25 +329,33 @@ This command does not have any specific options.
281
329
  \fBExamples\fP
282
330
  .sp
283
331
  To add a node using data contained in a JSON file:
332
+ .INDENT 0.0
333
+ .INDENT 3.5
284
334
  .sp
285
335
  .nf
286
336
  .ft C
287
337
  $ knife node from file "path to JSON file"
288
338
  .ft P
289
339
  .fi
340
+ .UNINDENT
341
+ .UNINDENT
290
342
  .SH LIST
291
343
  .sp
292
- The \fBlist\fP argument is used to view all of the nodes that exist on a server.
344
+ The \fBlist\fP argument is used to view all of the nodes that exist on a Chef server\&.
293
345
  .sp
294
346
  \fBSyntax\fP
295
347
  .sp
296
348
  This argument has the following syntax:
349
+ .INDENT 0.0
350
+ .INDENT 3.5
297
351
  .sp
298
352
  .nf
299
353
  .ft C
300
354
  $ knife node list (options)
301
355
  .ft P
302
356
  .fi
357
+ .UNINDENT
358
+ .UNINDENT
303
359
  .sp
304
360
  \fBOptions\fP
305
361
  .sp
@@ -312,15 +368,21 @@ Indicates that the corresponding URIs will be shown.
312
368
  .sp
313
369
  \fBExamples\fP
314
370
  .sp
315
- To verify the list of nodes that are registered with the server, enter:
371
+ To verify the list of nodes that are registered with the Chef server, enter:
372
+ .INDENT 0.0
373
+ .INDENT 3.5
316
374
  .sp
317
375
  .nf
318
376
  .ft C
319
377
  $ knife node list
320
378
  .ft P
321
379
  .fi
380
+ .UNINDENT
381
+ .UNINDENT
322
382
  .sp
323
383
  to return something similar to:
384
+ .INDENT 0.0
385
+ .INDENT 3.5
324
386
  .sp
325
387
  .nf
326
388
  .ft C
@@ -328,19 +390,25 @@ i\-12345678
328
390
  rs\-123456
329
391
  .ft P
330
392
  .fi
393
+ .UNINDENT
394
+ .UNINDENT
331
395
  .SH RUN_LIST ADD
332
396
  .sp
333
- The \fBrun_list add\fP argument is used to add run list items (roles or recipes) to a node.
397
+ The \fBrun_list add\fP argument is used to add run\-list items (roles or recipes) to a node.
334
398
  .sp
335
399
  \fBSyntax\fP
336
400
  .sp
337
401
  This argument has the following syntax:
402
+ .INDENT 0.0
403
+ .INDENT 3.5
338
404
  .sp
339
405
  .nf
340
406
  .ft C
341
407
  $ knife node run_list add NODE_NAME RUN_LIST_ITEM (options)
342
408
  .ft P
343
409
  .fi
410
+ .UNINDENT
411
+ .UNINDENT
344
412
  .sp
345
413
  \fBOptions\fP
346
414
  .sp
@@ -354,57 +422,81 @@ Use this to add the run list item after the specified run list item.
354
422
  \fBExamples\fP
355
423
  .sp
356
424
  To add a role to a run list, enter:
425
+ .INDENT 0.0
426
+ .INDENT 3.5
357
427
  .sp
358
428
  .nf
359
429
  .ft C
360
430
  $ knife node run_list add node \(aqrole[ROLE_NAME]\(aq
361
431
  .ft P
362
432
  .fi
433
+ .UNINDENT
434
+ .UNINDENT
363
435
  .sp
364
436
  To add roles and recipes to a run list, enter:
437
+ .INDENT 0.0
438
+ .INDENT 3.5
365
439
  .sp
366
440
  .nf
367
441
  .ft C
368
442
  $ knife node run_list add node \(aqrecipe[COOKBOOK::RECIPE_NAME],recipe[COOKBOOK::RECIPE_NAME],role[ROLE_NAME]\(aq
369
443
  .ft P
370
444
  .fi
445
+ .UNINDENT
446
+ .UNINDENT
371
447
  .sp
372
448
  To add a recipe to a run list using the fully qualified format, enter:
449
+ .INDENT 0.0
450
+ .INDENT 3.5
373
451
  .sp
374
452
  .nf
375
453
  .ft C
376
454
  $ knife node run_list add node \(aqrecipe[COOKBOOK::RECIPE_NAME]\(aq
377
455
  .ft P
378
456
  .fi
457
+ .UNINDENT
458
+ .UNINDENT
379
459
  .sp
380
460
  To add a recipe to a run list using the cookbook format, enter:
461
+ .INDENT 0.0
462
+ .INDENT 3.5
381
463
  .sp
382
464
  .nf
383
465
  .ft C
384
466
  $ knife node run_list add node \(aqCOOKBOOK::RECIPE_NAME\(aq
385
467
  .ft P
386
468
  .fi
469
+ .UNINDENT
470
+ .UNINDENT
387
471
  .sp
388
472
  To add the default recipe of a cookbook to a run list, enter:
473
+ .INDENT 0.0
474
+ .INDENT 3.5
389
475
  .sp
390
476
  .nf
391
477
  .ft C
392
478
  $ knife node run_list add node \(aqCOOKBOOK\(aq
393
479
  .ft P
394
480
  .fi
481
+ .UNINDENT
482
+ .UNINDENT
395
483
  .SH RUN_LIST REMOVE
396
484
  .sp
397
- The \fBrun_list remove\fP argument is used to remove run list items (roles or recipes) from a node. A recipe must be in one of the following formats: fully qualified, cookbook, or default. Both roles and recipes must be in quotes, for example: \fB\(aqrole[ROLE_NAME]\(aq\fP or \fB\(aqrecipe[COOKBOOK::RECIPE_NAME]\(aq\fP. Use a comma to separate roles and recipes when removing more than one, like this: \fB\(aqrecipe[COOKBOOK::RECIPE_NAME],COOKBOOK::RECIPE_NAME,role[ROLE_NAME]\(aq\fP.
485
+ The \fBrun_list remove\fP argument is used to remove run\-list items (roles or recipes) from a node. A recipe must be in one of the following formats: fully qualified, cookbook, or default. Both roles and recipes must be in quotes, for example: \fB\(aqrole[ROLE_NAME]\(aq\fP or \fB\(aqrecipe[COOKBOOK::RECIPE_NAME]\(aq\fP\&. Use a comma to separate roles and recipes when removing more than one, like this: \fB\(aqrecipe[COOKBOOK::RECIPE_NAME],COOKBOOK::RECIPE_NAME,role[ROLE_NAME]\(aq\fP\&.
398
486
  .sp
399
487
  \fBSyntax\fP
400
488
  .sp
401
489
  This argument has the following syntax:
490
+ .INDENT 0.0
491
+ .INDENT 3.5
402
492
  .sp
403
493
  .nf
404
494
  .ft C
405
495
  $ knife node run_list remove NODE_NAME RUN_LIST_ITEM
406
496
  .ft P
407
497
  .fi
498
+ .UNINDENT
499
+ .UNINDENT
408
500
  .sp
409
501
  \fBOptions\fP
410
502
  .sp
@@ -413,20 +505,28 @@ This command does not have any specific options.
413
505
  \fBExamples\fP
414
506
  .sp
415
507
  To remove a role from a run list, enter:
508
+ .INDENT 0.0
509
+ .INDENT 3.5
416
510
  .sp
417
511
  .nf
418
512
  .ft C
419
513
  $ knife node run_list remove node \(aqrole[ROLE_NAME]\(aq
420
514
  .ft P
421
515
  .fi
516
+ .UNINDENT
517
+ .UNINDENT
422
518
  .sp
423
519
  To remove a recipe from a run list using the fully qualified format, enter:
520
+ .INDENT 0.0
521
+ .INDENT 3.5
424
522
  .sp
425
523
  .nf
426
524
  .ft C
427
525
  $ knife node run_list remove node \(aqrecipe[COOKBOOK::RECIPE_NAME]\(aq
428
526
  .ft P
429
527
  .fi
528
+ .UNINDENT
529
+ .UNINDENT
430
530
  .SH SHOW
431
531
  .sp
432
532
  The \fBshow\fP argument is used to display information about a node.
@@ -434,12 +534,16 @@ The \fBshow\fP argument is used to display information about a node.
434
534
  \fBSyntax\fP
435
535
  .sp
436
536
  This argument has the following syntax:
537
+ .INDENT 0.0
538
+ .INDENT 3.5
437
539
  .sp
438
540
  .nf
439
541
  .ft C
440
542
  $ knife node show NODE_NAME (options)
441
543
  .ft P
442
544
  .fi
545
+ .UNINDENT
546
+ .UNINDENT
443
547
  .sp
444
548
  \fBOptions\fP
445
549
  .sp
@@ -462,14 +566,20 @@ Indicates that only the run\-list will be shown.
462
566
  \fBExamples\fP
463
567
  .sp
464
568
  To view all data for a node named "build", enter:
569
+ .INDENT 0.0
570
+ .INDENT 3.5
465
571
  .sp
466
572
  .nf
467
573
  .ft C
468
574
  $ knife node show build
469
575
  .ft P
470
576
  .fi
577
+ .UNINDENT
578
+ .UNINDENT
471
579
  .sp
472
580
  to return:
581
+ .INDENT 0.0
582
+ .INDENT 3.5
473
583
  .sp
474
584
  .nf
475
585
  .ft C
@@ -483,82 +593,120 @@ Recipes:
483
593
  Platform:
484
594
  .ft P
485
595
  .fi
596
+ .UNINDENT
597
+ .UNINDENT
486
598
  .sp
487
599
  To show basic information about a node, truncated and nicely formatted:
600
+ .INDENT 0.0
601
+ .INDENT 3.5
488
602
  .sp
489
603
  .nf
490
604
  .ft C
491
605
  knife node show <node_name>
492
606
  .ft P
493
607
  .fi
608
+ .UNINDENT
609
+ .UNINDENT
494
610
  .sp
495
611
  To show all information about a node, nicely formatted:
612
+ .INDENT 0.0
613
+ .INDENT 3.5
496
614
  .sp
497
615
  .nf
498
616
  .ft C
499
617
  knife node show \-l <node_name>
500
618
  .ft P
501
619
  .fi
620
+ .UNINDENT
621
+ .UNINDENT
502
622
  .sp
503
623
  To list a single node attribute:
624
+ .INDENT 0.0
625
+ .INDENT 3.5
504
626
  .sp
505
627
  .nf
506
628
  .ft C
507
629
  knife node show <node_name> \-a <attribute_name>
508
630
  .ft P
509
631
  .fi
632
+ .UNINDENT
633
+ .UNINDENT
510
634
  .sp
511
635
  where \fB<attribute_name>\fP is something like kernel or platform. (This doesn\(aqt work for nested attributes like \fBnode[kernel][machine]\fP because \fBknife node show\fP doesn\(aqt understand nested attributes.)
512
636
  .sp
513
637
  To view the FQDN for a node named "i\-12345678", enter:
638
+ .INDENT 0.0
639
+ .INDENT 3.5
514
640
  .sp
515
641
  .nf
516
642
  .ft C
517
643
  $ knife node show i\-12345678 \-a fqdn
518
644
  .ft P
519
645
  .fi
646
+ .UNINDENT
647
+ .UNINDENT
520
648
  .sp
521
649
  to return:
650
+ .INDENT 0.0
651
+ .INDENT 3.5
522
652
  .sp
523
653
  .nf
524
654
  .ft C
525
655
  fqdn: ip\-10\-251\-75\-20.ec2.internal
526
656
  .ft P
527
657
  .fi
658
+ .UNINDENT
659
+ .UNINDENT
528
660
  .sp
529
661
  To view the run list for a node named "dev", enter:
662
+ .INDENT 0.0
663
+ .INDENT 3.5
530
664
  .sp
531
665
  .nf
532
666
  .ft C
533
667
  $ knife node show dev \-r
534
668
  .ft P
535
669
  .fi
670
+ .UNINDENT
671
+ .UNINDENT
536
672
  .sp
537
673
  To view information in JSON format, use the \fB\-F\fP common option as part of the command like this:
674
+ .INDENT 0.0
675
+ .INDENT 3.5
538
676
  .sp
539
677
  .nf
540
678
  .ft C
541
679
  $ knife role show devops \-F json
542
680
  .ft P
543
681
  .fi
682
+ .UNINDENT
683
+ .UNINDENT
544
684
  .sp
545
- Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP.
685
+ Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP\&.
546
686
  .sp
547
687
  To view node information in raw JSON, use the \fB\-l\fP or \fB\-\-long\fP option:
688
+ .INDENT 0.0
689
+ .INDENT 3.5
548
690
  .sp
549
691
  .nf
550
692
  .ft C
551
693
  knife node show \-l \-F json <node_name>
552
694
  .ft P
553
695
  .fi
696
+ .UNINDENT
697
+ .UNINDENT
554
698
  .sp
555
699
  and/or:
700
+ .INDENT 0.0
701
+ .INDENT 3.5
556
702
  .sp
557
703
  .nf
558
704
  .ft C
559
705
  knife node show \-l \-\-format=json <node_name>
560
706
  .ft P
561
707
  .fi
708
+ .UNINDENT
709
+ .UNINDENT
562
710
  .SH AUTHOR
563
711
  Chef
564
712
  .\" Generated by docutils manpage writer.