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,3 @@
1
-
2
1
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
2
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
3
 
@@ -14,7 +13,7 @@
14
13
 
15
14
  <script type="text/javascript">
16
15
  var DOCUMENTATION_OPTIONS = {
17
- URL_ROOT: '',
16
+ URL_ROOT: './',
18
17
  VERSION: '',
19
18
  COLLAPSE_INDEX: false,
20
19
  FILE_SUFFIX: '.html',
@@ -43,8 +42,8 @@
43
42
 
44
43
  <div class="section" id="knife-environment">
45
44
  <h1>knife environment<a class="headerlink" href="#knife-environment" title="Permalink to this headline">¶</a></h1>
46
- <p>An environment is a way to map an organization&#8217;s real-life workflow to what can be configured and managed when using server. Every organization begins with a single environment called the <tt class="docutils literal"><span class="pre">_default</span></tt> environment, which cannot be modified (or deleted). Additional environments can be created to reflect each organization&#8217;s patterns and workflow. For example, creating <tt class="docutils literal"><span class="pre">production</span></tt>, <tt class="docutils literal"><span class="pre">staging</span></tt>, <tt class="docutils literal"><span class="pre">testing</span></tt>, and <tt class="docutils literal"><span class="pre">development</span></tt> environments. Generally, an environment is also associated with one (or more) cookbook versions.</p>
47
- <p>The <strong>knife environment</strong> subcommand is used to manage environments within a single organization on the server.</p>
45
+ <p>An environment is a way to map an organization&#8217;s real-life workflow to what can be configured and managed when using Chef server. Every organization begins with a single environment called the <tt class="docutils literal"><span class="pre">_default</span></tt> environment, which cannot be modified (or deleted). Additional environments can be created to reflect each organization&#8217;s patterns and workflow. For example, creating <tt class="docutils literal"><span class="pre">production</span></tt>, <tt class="docutils literal"><span class="pre">staging</span></tt>, <tt class="docutils literal"><span class="pre">testing</span></tt>, and <tt class="docutils literal"><span class="pre">development</span></tt> environments. Generally, an environment is also associated with one (or more) cookbook versions.</p>
46
+ <p>The <strong>knife environment</strong> subcommand is used to manage environments within a single organization on the Chef server.</p>
48
47
  <div class="admonition note">
49
48
  <p class="first admonition-title">Note</p>
50
49
  <p class="last">Review the list of <a class="reference internal" href="knife_common_options.html"><em>common options</em></a> available to this (and all) Knife subcommands and plugins.</p>
@@ -125,7 +124,7 @@ windows 1.0.0 4.1.2
125
124
  </div>
126
125
  <div class="section" id="create">
127
126
  <h2>create<a class="headerlink" href="#create" title="Permalink to this headline">¶</a></h2>
128
- <p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to add an environment object to the server. When this argument is run, Knife will open $EDITOR to enable editing of the <tt class="docutils literal"><span class="pre">ENVIRONMENT</span></tt> description field (unless a description is specified as part of the command). When finished, Knife will add the environment to the server.</p>
127
+ <p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to add an environment object to the Chef server. When this argument is run, Knife will open $EDITOR to enable editing of the <tt class="docutils literal"><span class="pre">ENVIRONMENT</span></tt> description field (unless a description is specified as part of the command). When finished, Knife will add the environment to the Chef server.</p>
129
128
  <div class="section" id="syntax">
130
129
  <h3>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h3>
131
130
  <p>This argument has the following syntax:</p>
@@ -138,7 +137,7 @@ windows 1.0.0 4.1.2
138
137
  <p>This argument has the following options:</p>
139
138
  <dl class="docutils">
140
139
  <dt><tt class="docutils literal"><span class="pre">-d</span> <span class="pre">DESCRIPTION</span></tt>, <tt class="docutils literal"><span class="pre">--description</span> <span class="pre">DESCRIPTION</span></tt></dt>
141
- <dd>The description of the environment. This value will populate the description field for the environment on the server.</dd>
140
+ <dd>The description of the environment. This value will populate the description field for the environment on the Chef server.</dd>
142
141
  </dl>
143
142
  </div>
144
143
  <div class="section" id="examples">
@@ -153,7 +152,7 @@ windows 1.0.0 4.1.2
153
152
  </div>
154
153
  <div class="section" id="delete">
155
154
  <h2>delete<a class="headerlink" href="#delete" title="Permalink to this headline">¶</a></h2>
156
- <p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete an environment from a server.</p>
155
+ <p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete an environment from a Chef server.</p>
157
156
  <div class="section" id="id1">
158
157
  <h3>Syntax<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
159
158
  <p>This argument has the following syntax:</p>
@@ -178,7 +177,7 @@ windows 1.0.0 4.1.2
178
177
  </div>
179
178
  <div class="section" id="edit">
180
179
  <h2>edit<a class="headerlink" href="#edit" title="Permalink to this headline">¶</a></h2>
181
- <p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit the attributes of an environment. When this argument is run, Knife will open $EDITOR to enable editing of <tt class="docutils literal"><span class="pre">ENVIRONMENT</span></tt> attributes. When finished, Knife will update the server with those changes.</p>
180
+ <p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit the attributes of an environment. When this argument is run, Knife will open $EDITOR to enable editing of <tt class="docutils literal"><span class="pre">ENVIRONMENT</span></tt> attributes. When finished, Knife will update the Chef server with those changes.</p>
182
181
  <div class="section" id="id4">
183
182
  <h3>Syntax<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
184
183
  <p>This argument has the following syntax:</p>
@@ -234,7 +233,7 @@ windows 1.0.0 4.1.2
234
233
  </div>
235
234
  <div class="section" id="list">
236
235
  <h2>list<a class="headerlink" href="#list" title="Permalink to this headline">¶</a></h2>
237
- <p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to list all of the environments that are currently available on the server.</p>
236
+ <p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to list all of the environments that are currently available on the Chef server.</p>
238
237
  <div class="section" id="id10">
239
238
  <h3>Syntax<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h3>
240
239
  <p>This argument has the following syntax:</p>
@@ -1,4 +1,3 @@
1
-
2
1
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
2
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
3
 
@@ -14,7 +13,7 @@
14
13
 
15
14
  <script type="text/javascript">
16
15
  var DOCUMENTATION_OPTIONS = {
17
- URL_ROOT: '',
16
+ URL_ROOT: './',
18
17
  VERSION: '',
19
18
  COLLAPSE_INDEX: false,
20
19
  FILE_SUFFIX: '.html',
@@ -43,10 +42,10 @@
43
42
 
44
43
  <div class="section" id="knife-exec">
45
44
  <h1>knife exec<a class="headerlink" href="#knife-exec" title="Permalink to this headline">¶</a></h1>
46
- <p>The <strong>knife exec</strong> subcommand uses the Knife configuration file to execute Ruby scripts in the context of a fully configured chef-client. This subcommand is most often used to run scripts that will only access server one time (or otherwise very infrequently). Use this subcommand any time that an operation does not warrant full usage of the Knife subcommand library.</p>
45
+ <p>The <strong>knife exec</strong> subcommand uses the Knife configuration file to execute Ruby scripts in the context of a fully configured chef-client. This subcommand is most often used to run scripts that will only access Chef server one time (or otherwise very infrequently). Use this subcommand any time that an operation does not warrant full usage of the Knife subcommand library.</p>
47
46
  <div class="section" id="authenticated-api-requests">
48
47
  <h2>Authenticated API Requests<a class="headerlink" href="#authenticated-api-requests" title="Permalink to this headline">¶</a></h2>
49
- <p>The <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">exec</span></tt> subcommand can be used to make authenticated API requests to the server using the following methods:</p>
48
+ <p>The <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">exec</span></tt> subcommand can be used to make authenticated API requests to the Chef server using the following methods:</p>
50
49
  <table border="1" class="docutils">
51
50
  <colgroup>
52
51
  <col width="13%" />
@@ -59,16 +58,16 @@
59
58
  </thead>
60
59
  <tbody valign="top">
61
60
  <tr class="row-even"><td><tt class="docutils literal"><span class="pre">api.delete</span></tt></td>
62
- <td>Use to delete an object from the server.</td>
61
+ <td>Use to delete an object from the Chef server.</td>
63
62
  </tr>
64
63
  <tr class="row-odd"><td><tt class="docutils literal"><span class="pre">api.get</span></tt></td>
65
- <td>Use to get the details of an object on the server.</td>
64
+ <td>Use to get the details of an object on the Chef server.</td>
66
65
  </tr>
67
66
  <tr class="row-even"><td><tt class="docutils literal"><span class="pre">api.post</span></tt></td>
68
- <td>Use to add an object to the server.</td>
67
+ <td>Use to add an object to the Chef server.</td>
69
68
  </tr>
70
69
  <tr class="row-odd"><td><tt class="docutils literal"><span class="pre">api.put</span></tt></td>
71
- <td>Use to update an object on the server.</td>
70
+ <td>Use to update an object on the Chef server.</td>
72
71
  </tr>
73
72
  </tbody>
74
73
  </table>
@@ -114,7 +113,7 @@
114
113
  </div>
115
114
  <div class="section" id="syntax">
116
115
  <h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
117
- <p>This argument has the following syntax:</p>
116
+ <p>This subcommand has the following syntax:</p>
118
117
  <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife <span class="nb">exec </span>SCRIPT <span class="o">(</span>options<span class="o">)</span>
119
118
  </pre></div>
120
119
  </div>
@@ -130,7 +129,7 @@
130
129
  <dt><tt class="docutils literal"><span class="pre">-E</span> <span class="pre">CODE</span></tt>, <tt class="docutils literal"><span class="pre">--exec</span> <span class="pre">CODE</span></tt></dt>
131
130
  <dd>A string of code that will be executed.</dd>
132
131
  <dt><tt class="docutils literal"><span class="pre">-p</span> <span class="pre">PATH:PATH</span></tt>, <tt class="docutils literal"><span class="pre">--script-path</span> <span class="pre">PATH:PATH</span></tt></dt>
133
- <dd>A colon-separated path at which Ruby scripts are located.</dd>
132
+ <dd>A colon-separated path at which Ruby scripts are located. Use to override the default location for scripts. When this option is not specified, Knife will look for scripts located in <tt class="docutils literal"><span class="pre">chef-repo/.chef/scripts</span></tt> directory.</dd>
134
133
  </dl>
135
134
  </div>
136
135
  <div class="section" id="examples">
@@ -1,4 +1,3 @@
1
-
2
1
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
2
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
3
 
@@ -14,7 +13,7 @@
14
13
 
15
14
  <script type="text/javascript">
16
15
  var DOCUMENTATION_OPTIONS = {
17
- URL_ROOT: '',
16
+ URL_ROOT: './',
18
17
  VERSION: '',
19
18
  COLLAPSE_INDEX: false,
20
19
  FILE_SUFFIX: '.html',
@@ -43,14 +42,14 @@
43
42
 
44
43
  <div class="section" id="knife-index-rebuild">
45
44
  <h1>knife index rebuild<a class="headerlink" href="#knife-index-rebuild" title="Permalink to this headline">¶</a></h1>
46
- <p>The <strong>knife index rebuild</strong> subcommand is used to rebuild the search indexes for the open source server. This operation is destructive and may take some time.</p>
45
+ <p>The <strong>knife index rebuild</strong> subcommand is used to rebuild the search indexes for the open source Chef server. This operation is destructive and may take some time.</p>
47
46
  <div class="admonition note">
48
47
  <p class="first admonition-title">Note</p>
49
- <p class="last">This subcommand ONLY works when run against the open source server version 10.x. This subcommand will NOT run against open source server 11, Enterprise Chef (including hosted Enterprise Chef), or Private Chef.</p>
48
+ <p class="last">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.</p>
50
49
  </div>
51
50
  <div class="section" id="syntax">
52
51
  <h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
53
- <p>This argument has the following syntax:</p>
52
+ <p>This subcommand has the following syntax:</p>
54
53
  <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife index rebuild
55
54
  </pre></div>
56
55
  </div>
@@ -1,4 +1,3 @@
1
-
2
1
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
2
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
3
 
@@ -14,7 +13,7 @@
14
13
 
15
14
  <script type="text/javascript">
16
15
  var DOCUMENTATION_OPTIONS = {
17
- URL_ROOT: '',
16
+ URL_ROOT: './',
18
17
  VERSION: '',
19
18
  COLLAPSE_INDEX: false,
20
19
  FILE_SUFFIX: '.html',
@@ -43,10 +42,10 @@
43
42
 
44
43
  <div class="section" id="knife-list">
45
44
  <h1>knife list<a class="headerlink" href="#knife-list" title="Permalink to this headline">¶</a></h1>
46
- <p>The <strong>knife list</strong> subcommand is used to view a list of objects on the server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">list</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">list</span></tt>, but with a single verb (and a single action).</p>
45
+ <p>The <strong>knife list</strong> subcommand is used to view a list of objects on the Chef server. This subcommand works similar to <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">cookbook</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">environment</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">node</span> <span class="pre">list</span></tt>, and <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">role</span> <span class="pre">list</span></tt>, but with a single verb (and a single action).</p>
47
46
  <div class="section" id="syntax">
48
47
  <h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
49
- <p>This argument has the following syntax:</p>
48
+ <p>This subcommand has the following syntax:</p>
50
49
  <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife list <span class="o">[</span>PATTERN...<span class="o">]</span> <span class="o">(</span>options<span class="o">)</span>
51
50
  </pre></div>
52
51
  </div>
@@ -62,13 +61,13 @@
62
61
  <dt><tt class="docutils literal"><span class="pre">-1</span></tt></dt>
63
62
  <dd>Indicates that only one column of results will be shown. Default: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
64
63
  <dt><tt class="docutils literal"><span class="pre">--chef-repo-path</span> <span class="pre">PATH</span></tt></dt>
65
- <dd>The path to the chef-repo. This setting will override the default path to the chef-repo. Default: same as specified by <tt class="docutils literal"><span class="pre">chef_repo_path</span></tt> in config.rb.</dd>
64
+ <dd>The path to the chef-repo. This setting will override the default path to the chef-repo. Default: same value as specified by <tt class="docutils literal"><span class="pre">chef_repo_path</span></tt> in client.rb.</dd>
66
65
  <dt><tt class="docutils literal"><span class="pre">--concurrency</span></tt></dt>
67
66
  <dd>The number of allowed concurrent connections. Default: <tt class="docutils literal"><span class="pre">10</span></tt>.</dd>
68
67
  <dt><tt class="docutils literal"><span class="pre">-d</span></tt></dt>
69
68
  <dd>Indicates that a directory&#8217;s children will not be shown when a directory matches a pattern. Default value: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
70
69
  <dt><tt class="docutils literal"><span class="pre">-f</span></tt>, <tt class="docutils literal"><span class="pre">--flat</span></tt></dt>
71
- <dd>Indicates that a list of file names will be shown. Set to <tt class="docutils literal"><span class="pre">false</span></tt> to view ls-like output. Default: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
70
+ <dd>Use to show a list of file names. Set to <tt class="docutils literal"><span class="pre">false</span></tt> to view ls-like output. Default: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
72
71
  <dt><tt class="docutils literal"><span class="pre">--local</span></tt></dt>
73
72
  <dd>Indicates that only contents of the local directory will be returned. Default: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
74
73
  <dt><tt class="docutils literal"><span class="pre">-p</span></tt></dt>
@@ -83,17 +82,17 @@
83
82
  <h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
84
83
  <p>The following examples show how to use this Knife subcommand:</p>
85
84
  <p><strong>List roles</strong></p>
86
- <p>For example, to view a list of roles on the server:</p>
85
+ <p>For example, to view a list of roles on the Chef server:</p>
87
86
  <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife list roles/
88
87
  </pre></div>
89
88
  </div>
90
89
  <p><strong>List roles and environments</strong></p>
91
- <p>To view a list of roles and environments on the server:</p>
90
+ <p>To view a list of roles and environments on the Chef server:</p>
92
91
  <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife list roles/ environments/
93
92
  </pre></div>
94
93
  </div>
95
94
  <p><strong>List everything</strong></p>
96
- <p>To view a list of absolutely everything on the server:</p>
95
+ <p>To view a list of absolutely everything on the Chef server:</p>
97
96
  <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife list -R /
98
97
  </pre></div>
99
98
  </div>
@@ -1,4 +1,3 @@
1
-
2
1
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
2
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
3
 
@@ -14,7 +13,7 @@
14
13
 
15
14
  <script type="text/javascript">
16
15
  var DOCUMENTATION_OPTIONS = {
17
- URL_ROOT: '',
16
+ URL_ROOT: './',
18
17
  VERSION: '',
19
18
  COLLAPSE_INDEX: false,
20
19
  FILE_SUFFIX: '.html',
@@ -44,7 +43,7 @@
44
43
  <div class="section" id="knife-node">
45
44
  <h1>knife node<a class="headerlink" href="#knife-node" title="Permalink to this headline">¶</a></h1>
46
45
  <p>A node is any physical, virtual, or cloud machine that is configured to be maintained by a chef-client.</p>
47
- <p>The <strong>knife node</strong> subcommand is used to manage the nodes that exist on a server.</p>
46
+ <p>The <strong>knife node</strong> subcommand is used to manage the nodes that exist on a Chef server.</p>
48
47
  <div class="admonition note">
49
48
  <p class="first admonition-title">Note</p>
50
49
  <p class="last">Review the list of <a class="reference internal" href="knife_common_options.html"><em>common options</em></a> available to this (and all) Knife subcommands and plugins.</p>
@@ -76,7 +75,7 @@
76
75
  </div>
77
76
  <div class="section" id="create">
78
77
  <h2>create<a class="headerlink" href="#create" title="Permalink to this headline">¶</a></h2>
79
- <p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to add a node to the server. Node data is stored as JSON on the server.</p>
78
+ <p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to add a node to the Chef server. Node data is stored as JSON on the Chef server.</p>
80
79
  <div class="section" id="id1">
81
80
  <h3>Syntax<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
82
81
  <p>This argument has the following syntax:</p>
@@ -97,31 +96,32 @@
97
96
  </pre></div>
98
97
  </div>
99
98
  <p>In the $EDITOR enter the node data in JSON:</p>
100
- <div class="highlight-javascript"><pre>## sample:
99
+ <div class="highlight-javascript"><div class="highlight"><pre>## sample:
101
100
  {
102
- "normal": {
101
+ &quot;normal&quot;: {
103
102
  },
104
- "name": "foobar",
105
- "override": {
103
+ &quot;name&quot;: &quot;foobar&quot;,
104
+ &quot;override&quot;: {
106
105
  },
107
- "default": {
106
+ &quot;default&quot;: {
108
107
  },
109
- "json_class": "Chef::Node",
110
- "automatic": {
108
+ &quot;json_class&quot;: &quot;Chef::Node&quot;,
109
+ &quot;automatic&quot;: {
111
110
  },
112
- "run_list": [
113
- "recipe[zsh]",
114
- "role[webserver]"
111
+ &quot;run_list&quot;: [
112
+ &quot;recipe[zsh]&quot;,
113
+ &quot;role[webserver]&quot;
115
114
  ],
116
- "chef_type": "node"
117
- }</pre>
115
+ &quot;chef_type&quot;: &quot;node&quot;
116
+ }
117
+ </pre></div>
118
118
  </div>
119
119
  <p>When finished, save it.</p>
120
120
  </div>
121
121
  </div>
122
122
  <div class="section" id="delete">
123
123
  <h2>delete<a class="headerlink" href="#delete" title="Permalink to this headline">¶</a></h2>
124
- <p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete a node from the server.</p>
124
+ <p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete a node from the Chef server.</p>
125
125
  <div class="admonition note">
126
126
  <p class="first admonition-title">Note</p>
127
127
  <p class="last">Deleting a node will not delete any corresponding API clients.</p>
@@ -148,7 +148,7 @@
148
148
  </div>
149
149
  <div class="section" id="edit">
150
150
  <h2>edit<a class="headerlink" href="#edit" title="Permalink to this headline">¶</a></h2>
151
- <p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit the details of a node on a server. Node data is stored as JSON on the server.</p>
151
+ <p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit the details of a node on a Chef server. Node data is stored as JSON on the Chef server.</p>
152
152
  <div class="section" id="id7">
153
153
  <h3>Syntax<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h3>
154
154
  <p>This argument has the following syntax:</p>
@@ -173,24 +173,25 @@
173
173
  </pre></div>
174
174
  </div>
175
175
  <p>Update the role data in JSON:</p>
176
- <div class="highlight-javascript"><pre>## sample:
176
+ <div class="highlight-javascript"><div class="highlight"><pre>## sample:
177
177
  {
178
- "normal": {
178
+ &quot;normal&quot;: {
179
179
  },
180
- "name": "node1",
181
- "override": {
180
+ &quot;name&quot;: &quot;node1&quot;,
181
+ &quot;override&quot;: {
182
182
  },
183
- "default": {
183
+ &quot;default&quot;: {
184
184
  },
185
- "json_class": "Chef::Node",
186
- "automatic": {
185
+ &quot;json_class&quot;: &quot;Chef::Node&quot;,
186
+ &quot;automatic&quot;: {
187
187
  },
188
- "run_list": [
189
- "recipe[devops]",
190
- "role[webserver]"
188
+ &quot;run_list&quot;: [
189
+ &quot;recipe[devops]&quot;,
190
+ &quot;role[webserver]&quot;
191
191
  ],
192
- "chef_type": "node"
193
- }</pre>
192
+ &quot;chef_type&quot;: &quot;node&quot;
193
+ }
194
+ </pre></div>
194
195
  </div>
195
196
  <p>When finished, save it.</p>
196
197
  </div>
@@ -221,7 +222,7 @@
221
222
  </div>
222
223
  <div class="section" id="list">
223
224
  <h2>list<a class="headerlink" href="#list" title="Permalink to this headline">¶</a></h2>
224
- <p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to view all of the nodes that exist on a server.</p>
225
+ <p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to view all of the nodes that exist on a Chef server.</p>
225
226
  <div class="section" id="id13">
226
227
  <h3>Syntax<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h3>
227
228
  <p>This argument has the following syntax:</p>
@@ -241,7 +242,7 @@
241
242
  <h3>Examples<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h3>
242
243
  <p>The following examples show how to use this Knife subcommand:</p>
243
244
  <p><strong>View a list of nodes</strong></p>
244
- <p>To verify the list of nodes that are registered with the server, enter:</p>
245
+ <p>To verify the list of nodes that are registered with the Chef server, enter:</p>
245
246
  <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife node list
246
247
  </pre></div>
247
248
  </div>
@@ -254,7 +255,7 @@ rs-123456
254
255
  </div>
255
256
  <div class="section" id="run-list-add">
256
257
  <h2>run_list add<a class="headerlink" href="#run-list-add" title="Permalink to this headline">¶</a></h2>
257
- <p>A run-list is an ordered list of roles and/or recipes that are run in an exact order. A run-list is always specific to the node on which it runs, though it is possible for many nodes to have run-lists that are similar or even identical. The items within a run-list are maintained using Knife and are uploaded to the server and stored as part of the node object for each node. The chef-client always configures a node in the exact order specified by its run-list and will never run the same recipe twice.</p>
258
+ <p>A run-list is an ordered list of roles and/or recipes that are run in an exact order. A run-list is always specific to the node on which it runs, though it is possible for many nodes to have run-lists that are similar or even identical. The items within a run-list are maintained using Knife and are uploaded to the Chef server and stored as part of the node object for each node. The chef-client always configures a node in the exact order specified by its run-list and will never run the same recipe twice.</p>
258
259
  <p>The <tt class="docutils literal"><span class="pre">run_list</span> <span class="pre">add</span></tt> argument is used to add run list items (roles or recipes) to a node.</p>
259
260
  <p>A run-list must be in one of the following formats: fully qualified, cookbook, or default. Both roles and recipes must be in quotes, for example:</p>
260
261
  <div class="highlight-ruby"><div class="highlight"><pre><span class="s1">&#39;role[ROLE_NAME]&#39;</span>
@@ -1,4 +1,3 @@
1
-
2
1
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
2
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
3
 
@@ -14,7 +13,7 @@
14
13
 
15
14
  <script type="text/javascript">
16
15
  var DOCUMENTATION_OPTIONS = {
17
- URL_ROOT: '',
16
+ URL_ROOT: './',
18
17
  VERSION: '',
19
18
  COLLAPSE_INDEX: false,
20
19
  FILE_SUFFIX: '.html',
@@ -46,7 +45,7 @@
46
45
  <p>The <strong>knife raw</strong> subcommand is used to send a REST request to a specified path using the Chef Server API.</p>
47
46
  <div class="section" id="syntax">
48
47
  <h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
49
- <p>This argument has the following syntax:</p>
48
+ <p>This subcommand has the following syntax:</p>
50
49
  <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife raw REQUEST_PATH <span class="o">(</span>options<span class="o">)</span>
51
50
  </pre></div>
52
51
  </div>
@@ -1,4 +1,3 @@
1
-
2
1
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
2
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
3
 
@@ -14,7 +13,7 @@
14
13
 
15
14
  <script type="text/javascript">
16
15
  var DOCUMENTATION_OPTIONS = {
17
- URL_ROOT: '',
16
+ URL_ROOT: './',
18
17
  VERSION: '',
19
18
  COLLAPSE_INDEX: false,
20
19
  FILE_SUFFIX: '.html',
@@ -43,10 +42,10 @@
43
42
 
44
43
  <div class="section" id="knife-recipe-list">
45
44
  <h1>knife recipe list<a class="headerlink" href="#knife-recipe-list" title="Permalink to this headline">¶</a></h1>
46
- <p>The <strong>knife recipe list</strong> 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 (/).</p>
45
+ <p>The <strong>knife recipe list</strong> 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 (/).</p>
47
46
  <div class="section" id="syntax">
48
47
  <h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
49
- <p>This argument has the following syntax:</p>
48
+ <p>This subcommand has the following syntax:</p>
50
49
  <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife recipe list REGEX
51
50
  </pre></div>
52
51
  </div>
@@ -1,4 +1,3 @@
1
-
2
1
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
2
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
3
 
@@ -14,7 +13,7 @@
14
13
 
15
14
  <script type="text/javascript">
16
15
  var DOCUMENTATION_OPTIONS = {
17
- URL_ROOT: '',
16
+ URL_ROOT: './',
18
17
  VERSION: '',
19
18
  COLLAPSE_INDEX: false,
20
19
  FILE_SUFFIX: '.html',
@@ -44,7 +43,7 @@
44
43
  <div class="section" id="knife-role">
45
44
  <h1>knife role<a class="headerlink" href="#knife-role" title="Permalink to this headline">¶</a></h1>
46
45
  <p>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&#8217;s run list are applied to the node&#8217;s configuration details. When a chef-client runs, it merges its own attributes and run lists with those contained within each assigned role.</p>
47
- <p>The <strong>knife role</strong> subcommand is used to manage the roles that are associated with one or more nodes on a server.</p>
46
+ <p>The <strong>knife role</strong> subcommand is used to manage the roles that are associated with one or more nodes on a Chef server.</p>
48
47
  <div class="admonition note">
49
48
  <p class="first admonition-title">Note</p>
50
49
  <p class="last">To add a role to a node and then build out the run-list for that node, use the <a class="reference internal" href="knife_node.html"><em>knife node</em></a> sub-command and its <tt class="docutils literal"><span class="pre">run_list</span> <span class="pre">add</span></tt> argument.</p>
@@ -79,7 +78,7 @@
79
78
  </div>
80
79
  <div class="section" id="create">
81
80
  <h2>create<a class="headerlink" href="#create" title="Permalink to this headline">¶</a></h2>
82
- <p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to add a role to the server. Role data is saved as JSON on the server.</p>
81
+ <p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to add a role to the Chef server. Role data is saved as JSON on the Chef server.</p>
83
82
  <div class="section" id="id1">
84
83
  <h3>Syntax<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
85
84
  <p>This argument has the following syntax:</p>
@@ -92,7 +91,7 @@
92
91
  <p>This argument has the following options:</p>
93
92
  <dl class="docutils">
94
93
  <dt><tt class="docutils literal"><span class="pre">-d</span> <span class="pre">DESCRIPTION</span></tt>, <tt class="docutils literal"><span class="pre">--description</span> <span class="pre">DESCRIPTION</span></tt></dt>
95
- <dd>The description of the role. This value will populate the description field for the role on the server.</dd>
94
+ <dd>The description of the role. This value will populate the description field for the role on the Chef server.</dd>
96
95
  </dl>
97
96
  </div>
98
97
  <div class="section" id="id3">
@@ -104,27 +103,28 @@
104
103
  </pre></div>
105
104
  </div>
106
105
  <p>In the $EDITOR enter the role data in JSON:</p>
107
- <div class="highlight-javascript"><pre>## sample:
106
+ <div class="highlight-javascript"><div class="highlight"><pre>## sample:
108
107
  {
109
- "name": "role1",
110
- "default_attributes": {
108
+ &quot;name&quot;: &quot;role1&quot;,
109
+ &quot;default_attributes&quot;: {
111
110
  },
112
- "json_class": "Chef::Role",
113
- "run_list": ['recipe[cookbook_name::recipe_name],
114
- role[role_name]'
111
+ &quot;json_class&quot;: &quot;Chef::Role&quot;,
112
+ &quot;run_list&quot;: [&#39;recipe[cookbook_name::recipe_name],
113
+ role[role_name]&#39;
115
114
  ],
116
- "description": "",
117
- "chef_type": "role",
118
- "override_attributes": {
115
+ &quot;description&quot;: &quot;&quot;,
116
+ &quot;chef_type&quot;: &quot;role&quot;,
117
+ &quot;override_attributes&quot;: {
119
118
  }
120
- }</pre>
119
+ }
120
+ </pre></div>
121
121
  </div>
122
122
  <p>When finished, save it.</p>
123
123
  </div>
124
124
  </div>
125
125
  <div class="section" id="delete">
126
126
  <h2>delete<a class="headerlink" href="#delete" title="Permalink to this headline">¶</a></h2>
127
- <p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete a role from the server.</p>
127
+ <p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete a role from the Chef server.</p>
128
128
  <div class="section" id="id4">
129
129
  <h3>Syntax<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
130
130
  <p>This argument has the following syntax:</p>
@@ -148,7 +148,7 @@
148
148
  </div>
149
149
  <div class="section" id="edit">
150
150
  <h2>edit<a class="headerlink" href="#edit" title="Permalink to this headline">¶</a></h2>
151
- <p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit role details on the server.</p>
151
+ <p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit role details on the Chef server.</p>
152
152
  <div class="section" id="id7">
153
153
  <h3>Syntax<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h3>
154
154
  <p>This argument has the following syntax:</p>
@@ -169,20 +169,21 @@
169
169
  </pre></div>
170
170
  </div>
171
171
  <p>Update the role data in JSON:</p>
172
- <div class="highlight-javascript"><pre>## sample:
172
+ <div class="highlight-javascript"><div class="highlight"><pre>## sample:
173
173
  {
174
- "name": "role1",
175
- "default_attributes": {
174
+ &quot;name&quot;: &quot;role1&quot;,
175
+ &quot;default_attributes&quot;: {
176
176
  },
177
- "json_class": "Chef::Role",
178
- "run_list": ['recipe[cookbook_name::recipe_name],
179
- role[role_name]'
177
+ &quot;json_class&quot;: &quot;Chef::Role&quot;,
178
+ &quot;run_list&quot;: [&#39;recipe[cookbook_name::recipe_name],
179
+ role[role_name]&#39;
180
180
  ],
181
- "description": "This is the description for the role1 role.",
182
- "chef_type": "role",
183
- "override_attributes": {
181
+ &quot;description&quot;: &quot;This is the description for the role1 role.&quot;,
182
+ &quot;chef_type&quot;: &quot;role&quot;,
183
+ &quot;override_attributes&quot;: {
184
184
  }
185
- }</pre>
185
+ }
186
+ </pre></div>
186
187
  </div>
187
188
  <p>When finished, save it.</p>
188
189
  </div>
@@ -213,7 +214,7 @@
213
214
  </div>
214
215
  <div class="section" id="list">
215
216
  <h2>list<a class="headerlink" href="#list" title="Permalink to this headline">¶</a></h2>
216
- <p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to view a list of roles that are currently available on the server.</p>
217
+ <p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to view a list of roles that are currently available on the Chef server.</p>
217
218
  <div class="section" id="id13">
218
219
  <h3>Syntax<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h3>
219
220
  <p>This argument has the following syntax:</p>
@@ -233,7 +234,7 @@
233
234
  <h3>Examples<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h3>
234
235
  <p>The following examples show how to use this Knife subcommand:</p>
235
236
  <p><strong>View a list of roles</strong></p>
236
- <p>To view a list of roles on the server and display the URI for each role returned, enter:</p>
237
+ <p>To view a list of roles on the Chef server and display the URI for each role returned, enter:</p>
237
238
  <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife role list -w
238
239
  </pre></div>
239
240
  </div>