RubyGems - chef - Versions diffs - 13.11.3-universal-mingw32 → 13.12.3-universal-mingw32 - Mend

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

Files changed (260) hide show

checksums.yaml +4 -4
data/Gemfile +4 -3
data/README.md +35 -40
data/Rakefile +18 -22
data/chef-universal-mingw32.gemspec +1 -1
data/chef.gemspec +3 -3
data/lib/chef/client.rb +1 -1
data/lib/chef/mixin/params_validate.rb +3 -1
data/lib/chef/provider/script.rb +2 -2
data/lib/chef/version.rb +1 -1
data/spec/functional/http/simple_spec.rb +12 -6
data/spec/functional/resource/remote_file_spec.rb +19 -15
data/spec/support/platform_helpers.rb +2 -1
data/tasks/announce.rb +1 -1
data/tasks/dependencies.rb +5 -39
data/tasks/maintainers.rb +10 -10
data/tasks/rspec.rb +2 -2
data/tasks/templates/prerelease.md.erb +11 -2
data/tasks/templates/release.md.erb +9 -1
metadata +6 -247
data/CONTRIBUTING.md +0 -151
data/VERSION +0 -1
data/acceptance/.gitignore +0 -3
data/acceptance/.shared/kitchen_acceptance/.kitchen.digitalocean.yml +0 -33
data/acceptance/.shared/kitchen_acceptance/.kitchen.ec2.yml +0 -283
data/acceptance/.shared/kitchen_acceptance/.kitchen.vagrant.yml +0 -59
data/acceptance/.shared/kitchen_acceptance/libraries/kitchen.rb +0 -68
data/acceptance/.shared/kitchen_acceptance/metadata.rb +0 -1
data/acceptance/Gemfile +0 -19
data/acceptance/Gemfile.lock +0 -266
data/acceptance/README.md +0 -137
data/acceptance/basics/.acceptance/acceptance-cookbook/.gitignore +0 -2
data/acceptance/basics/.acceptance/acceptance-cookbook/metadata.rb +0 -3
data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
data/acceptance/basics/.kitchen.yml +0 -4
data/acceptance/basics/test/integration/chef-current-install/serverspec/chef_client_spec.rb +0 -19
data/acceptance/basics/test/integration/chef-current-install/serverspec/spec_helper.rb +0 -6
data/acceptance/basics/test/integration/helpers/serverspec/Gemfile +0 -8
data/acceptance/data-collector/.acceptance/acceptance-cookbook/.gitignore +0 -2
data/acceptance/data-collector/.acceptance/acceptance-cookbook/metadata.rb +0 -3
data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -2
data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -2
data/acceptance/data-collector/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -2
data/acceptance/data-collector/.acceptance/data-collector-test/.gitignore +0 -16
data/acceptance/data-collector/.acceptance/data-collector-test/Berksfile +0 -3
data/acceptance/data-collector/.acceptance/data-collector-test/files/default/api.rb +0 -101
data/acceptance/data-collector/.acceptance/data-collector-test/files/default/apigemfile +0 -3
data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-both-mode.rb +0 -4
data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-client-mode.rb +0 -4
data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-no-endpoint.rb +0 -2
data/acceptance/data-collector/.acceptance/data-collector-test/files/default/client-rb-solo-mode.rb +0 -4
data/acceptance/data-collector/.acceptance/data-collector-test/files/default/config.ru +0 -2
data/acceptance/data-collector/.acceptance/data-collector-test/metadata.rb +0 -7
data/acceptance/data-collector/.acceptance/data-collector-test/recipes/default.rb +0 -44
data/acceptance/data-collector/.kitchen.yml +0 -9
data/acceptance/data-collector/Berksfile +0 -3
data/acceptance/data-collector/test/integration/default/serverspec/default_spec.rb +0 -208
data/acceptance/data-collector/test/integration/helpers/serverspec/Gemfile +0 -8
data/acceptance/omnitruck/.acceptance/acceptance-cookbook/.gitignore +0 -2
data/acceptance/omnitruck/.acceptance/acceptance-cookbook/metadata.rb +0 -1
data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -61
data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/.gitignore +0 -2
data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/cookbook_kitchen.rb +0 -43
data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/top_cookbooks.rb +0 -41
data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/metadata.rb +0 -3
data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
data/acceptance/top-cookbooks/.gitignore +0 -1
data/acceptance/top-cookbooks/.kitchen.chocolatey.yml +0 -6
data/acceptance/top-cookbooks/.kitchen.iis.yml +0 -4
data/acceptance/top-cookbooks/.kitchen.learn-the-basics-rhel.yml +0 -7
data/acceptance/top-cookbooks/.kitchen.learn-the-basics-ubuntu.yml +0 -7
data/acceptance/top-cookbooks/.kitchen.learn-the-basics-windows.yml +0 -7
data/acceptance/top-cookbooks/.kitchen.powershell.yml +0 -4
data/acceptance/top-cookbooks/.kitchen.sql_server.yml +0 -5
data/acceptance/top-cookbooks/.kitchen.winbox.yml +0 -8
data/acceptance/top-cookbooks/.kitchen.windows.yml +0 -38
data/acceptance/trivial/.acceptance/acceptance-cookbook/.gitignore +0 -2
data/acceptance/trivial/.acceptance/acceptance-cookbook/metadata.rb +0 -2
data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
data/acceptance/trivial/.kitchen.yml +0 -7
data/acceptance/trivial/test/integration/chef-current-install/inspec/chef_client_spec.rb +0 -5
data/acceptance/windows-service/.acceptance/acceptance-cookbook/.gitignore +0 -2
data/acceptance/windows-service/.acceptance/acceptance-cookbook/metadata.rb +0 -2
data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/destroy.rb +0 -1
data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/provision.rb +0 -1
data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/verify.rb +0 -1
data/acceptance/windows-service/.kitchen.yml +0 -7
data/acceptance/windows-service/test/integration/chef-windows-service/inspec/chef_windows_service_spec.rb +0 -58
data/distro/common/html/_sources/ctl_chef_client.txt +0 -36
data/distro/common/html/_sources/ctl_chef_server.txt +0 -341
data/distro/common/html/_sources/ctl_chef_shell.txt +0 -15
data/distro/common/html/_sources/ctl_chef_solo.txt +0 -25
data/distro/common/html/_sources/index.txt +0 -135
data/distro/common/html/_sources/knife.txt +0 -74
data/distro/common/html/_sources/knife_bootstrap.txt +0 -56
data/distro/common/html/_sources/knife_client.txt +0 -151
data/distro/common/html/_sources/knife_common_options.txt +0 -6
data/distro/common/html/_sources/knife_configure.txt +0 -29
data/distro/common/html/_sources/knife_cookbook.txt +0 -236
data/distro/common/html/_sources/knife_cookbook_site.txt +0 -157
data/distro/common/html/_sources/knife_data_bag.txt +0 -160
data/distro/common/html/_sources/knife_delete.txt +0 -26
data/distro/common/html/_sources/knife_deps.txt +0 -61
data/distro/common/html/_sources/knife_diff.txt +0 -34
data/distro/common/html/_sources/knife_download.txt +0 -44
data/distro/common/html/_sources/knife_edit.txt +0 -26
data/distro/common/html/_sources/knife_environment.txt +0 -158
data/distro/common/html/_sources/knife_exec.txt +0 -47
data/distro/common/html/_sources/knife_index_rebuild.txt +0 -21
data/distro/common/html/_sources/knife_list.txt +0 -33
data/distro/common/html/_sources/knife_node.txt +0 -250
data/distro/common/html/_sources/knife_raw.txt +0 -35
data/distro/common/html/_sources/knife_recipe_list.txt +0 -23
data/distro/common/html/_sources/knife_role.txt +0 -157
data/distro/common/html/_sources/knife_search.txt +0 -53
data/distro/common/html/_sources/knife_serve.txt +0 -19
data/distro/common/html/_sources/knife_show.txt +0 -27
data/distro/common/html/_sources/knife_ssh.txt +0 -43
data/distro/common/html/_sources/knife_ssl_check.txt +0 -41
data/distro/common/html/_sources/knife_ssl_fetch.txt +0 -41
data/distro/common/html/_sources/knife_status.txt +0 -37
data/distro/common/html/_sources/knife_tag.txt +0 -69
data/distro/common/html/_sources/knife_upload.txt +0 -49
data/distro/common/html/_sources/knife_user.txt +0 -127
data/distro/common/html/_sources/knife_using.txt +0 -43
data/distro/common/html/_sources/knife_xargs.txt +0 -30
data/distro/common/html/_static/ajax-loader.gif +0 -0
data/distro/common/html/_static/basic.css +0 -537
data/distro/common/html/_static/chef.ico +0 -0
data/distro/common/html/_static/chef_html_logo.png +0 -0
data/distro/common/html/_static/comment-bright.png +0 -0
data/distro/common/html/_static/comment-close.png +0 -0
data/distro/common/html/_static/comment.png +0 -0
data/distro/common/html/_static/contents.png +0 -0
data/distro/common/html/_static/doctools.js +0 -238
data/distro/common/html/_static/down-pressed.png +0 -0
data/distro/common/html/_static/down.png +0 -0
data/distro/common/html/_static/file.png +0 -0
data/distro/common/html/_static/guide.css +0 -505
data/distro/common/html/_static/jquery.js +0 -2
data/distro/common/html/_static/minus.png +0 -0
data/distro/common/html/_static/navigation.png +0 -0
data/distro/common/html/_static/plus.png +0 -0
data/distro/common/html/_static/pygments.css +0 -62
data/distro/common/html/_static/searchtools.js +0 -622
data/distro/common/html/_static/underscore.js +0 -31
data/distro/common/html/_static/up-pressed.png +0 -0
data/distro/common/html/_static/up.png +0 -0
data/distro/common/html/_static/websupport.js +0 -808
data/distro/common/html/ctl_chef_client.html +0 -270
data/distro/common/html/ctl_chef_server.html +0 -728
data/distro/common/html/ctl_chef_shell.html +0 -163
data/distro/common/html/ctl_chef_solo.html +0 -194
data/distro/common/html/index.html +0 -202
data/distro/common/html/knife.html +0 -170
data/distro/common/html/knife_bootstrap.html +0 -285
data/distro/common/html/knife_client.html +0 -285
data/distro/common/html/knife_common_options.html +0 -96
data/distro/common/html/knife_configure.html +0 -105
data/distro/common/html/knife_cookbook.html +0 -487
data/distro/common/html/knife_cookbook_site.html +0 -375
data/distro/common/html/knife_data_bag.html +0 -374
data/distro/common/html/knife_delete.html +0 -93
data/distro/common/html/knife_deps.html +0 -143
data/distro/common/html/knife_diff.html +0 -123
data/distro/common/html/knife_download.html +0 -145
data/distro/common/html/knife_edit.html +0 -89
data/distro/common/html/knife_environment.html +0 -322
data/distro/common/html/knife_exec.html +0 -220
data/distro/common/html/knife_index_rebuild.html +0 -83
data/distro/common/html/knife_list.html +0 -114
data/distro/common/html/knife_node.html +0 -458
data/distro/common/html/knife_raw.html +0 -110
data/distro/common/html/knife_recipe_list.html +0 -91
data/distro/common/html/knife_role.html +0 -295
data/distro/common/html/knife_search.html +0 -203
data/distro/common/html/knife_serve.html +0 -79
data/distro/common/html/knife_show.html +0 -104
data/distro/common/html/knife_ssh.html +0 -177
data/distro/common/html/knife_ssl_check.html +0 -151
data/distro/common/html/knife_ssl_fetch.html +0 -151
data/distro/common/html/knife_status.html +0 -144
data/distro/common/html/knife_tag.html +0 -138
data/distro/common/html/knife_upload.html +0 -153
data/distro/common/html/knife_user.html +0 -242
data/distro/common/html/knife_using.html +0 -210
data/distro/common/html/knife_xargs.html +0 -122
data/distro/common/html/objects.inv +0 -0
data/distro/common/html/search.html +0 -82
data/distro/common/html/searchindex.js +0 -1
data/distro/common/man/man1/README.md +0 -58
data/distro/common/man/man1/chef-shell.1 +0 -194
data/distro/common/man/man1/knife-bootstrap.1 +0 -215
data/distro/common/man/man1/knife-client.1 +0 -443
data/distro/common/man/man1/knife-configure.1 +0 -161
data/distro/common/man/man1/knife-cookbook-site.1 +0 -552
data/distro/common/man/man1/knife-cookbook.1 +0 -770
data/distro/common/man/man1/knife-data-bag.1 +0 -617
data/distro/common/man/man1/knife-delete.1 +0 -127
data/distro/common/man/man1/knife-deps.1 +0 -246
data/distro/common/man/man1/knife-diff.1 +0 -226
data/distro/common/man/man1/knife-download.1 +0 -258
data/distro/common/man/man1/knife-edit.1 +0 -121
data/distro/common/man/man1/knife-environment.1 +0 -496
data/distro/common/man/man1/knife-exec.1 +0 -362
data/distro/common/man/man1/knife-index-rebuild.1 +0 -63
data/distro/common/man/man1/knife-list.1 +0 -174
data/distro/common/man/man1/knife-node.1 +0 -716
data/distro/common/man/man1/knife-raw.1 +0 -172
data/distro/common/man/man1/knife-recipe-list.1 +0 -85
data/distro/common/man/man1/knife-role.1 +0 -426
data/distro/common/man/man1/knife-search.1 +0 -359
data/distro/common/man/man1/knife-serve.1 +0 -109
data/distro/common/man/man1/knife-show.1 +0 -160
data/distro/common/man/man1/knife-ssh.1 +0 -284
data/distro/common/man/man1/knife-ssl-check.1 +0 -207
data/distro/common/man/man1/knife-ssl-fetch.1 +0 -207
data/distro/common/man/man1/knife-status.1 +0 -234
data/distro/common/man/man1/knife-tag.1 +0 -189
data/distro/common/man/man1/knife-upload.1 +0 -280
data/distro/common/man/man1/knife-user.1 +0 -356
data/distro/common/man/man1/knife-xargs.1 +0 -189
data/distro/common/man/man1/knife.1 +0 -332
data/distro/common/man/man8/chef-apply.8 +0 -86
data/distro/common/man/man8/chef-client.8 +0 -398
data/distro/common/man/man8/chef-solo.8 +0 -260
data/distro/common/markdown/README +0 -3
data/distro/common/markdown/man1/chef-shell.mkd +0 -195
data/distro/common/markdown/man1/knife-bootstrap.mkd +0 -141
data/distro/common/markdown/man1/knife-client.mkd +0 -103
data/distro/common/markdown/man1/knife-configure.mkd +0 -71
data/distro/common/markdown/man1/knife-cookbook-site.mkd +0 -123
data/distro/common/markdown/man1/knife-cookbook.mkd +0 -263
data/distro/common/markdown/man1/knife-data-bag.mkd +0 -121
data/distro/common/markdown/man1/knife-environment.mkd +0 -151
data/distro/common/markdown/man1/knife-exec.mkd +0 -42
data/distro/common/markdown/man1/knife-index.mkd +0 -30
data/distro/common/markdown/man1/knife-node.mkd +0 -130
data/distro/common/markdown/man1/knife-role.mkd +0 -85
data/distro/common/markdown/man1/knife-search.mkd +0 -180
data/distro/common/markdown/man1/knife-ssh.mkd +0 -69
data/distro/common/markdown/man1/knife-status.mkd +0 -36
data/distro/common/markdown/man1/knife-tag.mkd +0 -39
data/distro/common/markdown/man1/knife.mkd +0 -213
data/distro/common/markdown/man8/chef-client.mkd +0 -75
data/distro/common/markdown/man8/chef-expander.mkd +0 -81
data/distro/common/markdown/man8/chef-expanderctl.mkd +0 -57
data/distro/common/markdown/man8/chef-server-webui.mkd +0 -121
data/distro/common/markdown/man8/chef-server.mkd +0 -120
data/distro/common/markdown/man8/chef-solo.mkd +0 -107
data/distro/common/markdown/man8/chef-solr.mkd +0 -89
data/tasks/cbgb.rb +0 -84

data/distro/common/html/knife_upload.html DELETED

@@ -1,153 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>knife upload &mdash; chef-client Man Pages</title>
-    <link rel="stylesheet" href="_static/guide.css" type="text/css" />
-    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    './',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="_static/jquery.js"></script>
-    <script type="text/javascript" src="_static/underscore.js"></script>
-    <script type="text/javascript" src="_static/doctools.js"></script>
-  </head>
-  <body>
-<div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
-<a href="http://docs.getchef.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
-</div>
-    <div class="document">
-      <div class="documentwrapper">
-          <div class="body">
-  <div class="section" id="knife-upload">
-<h1>knife upload<a class="headerlink" href="#knife-upload" title="Permalink to this headline">¶</a></h1>
-<p>The <strong>knife upload</strong> subcommand is used to upload roles, cookbooks, environments, and data bags to the Chef server from the current working directory in the chef-repo. This subcommand is often used in conjunction with <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">diff</span></tt>, which can be used to see exactly what changes will be uploaded, and then <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">download</span></tt>, which does the opposite of <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">upload</span></tt>.</p>
-<div class="section" id="syntax">
-<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
-<p>This subcommand has the following syntax:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload <span class="o">[</span>PATTERN...<span class="o">]</span> <span class="o">(</span>options<span class="o">)</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="options">
-<h2>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
-<div class="admonition note">
-<p class="first admonition-title">Note</p>
-<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>
-</div>
-<p>This subcommand has the following options:</p>
-<dl class="docutils">
-<dt><tt class="docutils literal"><span class="pre">--chef-repo-path</span> <span class="pre">PATH</span></tt></dt>
-<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>
-<dt><tt class="docutils literal"><span class="pre">--concurrency</span></tt></dt>
-<dd>The number of allowed concurrent connections. Default: <tt class="docutils literal"><span class="pre">10</span></tt>.</dd>
-<dt><tt class="docutils literal"><span class="pre">--[no-]diff</span></tt></dt>
-<dd>Use to upload only new and modified files. Set to <tt class="docutils literal"><span class="pre">false</span></tt> to upload all files. Default: <tt class="docutils literal"><span class="pre">true</span></tt>.</dd>
-<dt><tt class="docutils literal"><span class="pre">--[no-]force</span></tt></dt>
-<dd>Use <tt class="docutils literal"><span class="pre">--force</span></tt> to upload roles, cookbooks, etc. even if the file in the directory is identical (by default, no <tt class="docutils literal"><span class="pre">POST</span></tt> or <tt class="docutils literal"><span class="pre">PUT</span></tt> is performed unless an actual change would be made). Default: <tt class="docutils literal"><span class="pre">--no-force</span></tt>.</dd>
-<dt><tt class="docutils literal"><span class="pre">--[no-]freeze</span></tt></dt>
-<dd>Use to require changes to a cookbook be included as a new version. Only the <tt class="docutils literal"><span class="pre">--force</span></tt> option can override this setting. Default: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
-<dt><tt class="docutils literal"><span class="pre">-n</span></tt>, <tt class="docutils literal"><span class="pre">--dry-run</span></tt></dt>
-<dd>Use to take no action and only print out results. Default: <tt class="docutils literal"><span class="pre">false</span></tt>.</dd>
-<dt><tt class="docutils literal"><span class="pre">--[no-]purge</span></tt></dt>
-<dd>Use <tt class="docutils literal"><span class="pre">--purge</span></tt> to delete roles, cookbooks, etc. from the Chef server if their corresponding files do not exist in the chef-repo. By default, such objects are left alone and NOT purged. Default: <tt class="docutils literal"><span class="pre">--no-purge</span></tt>.</dd>
-<dt><tt class="docutils literal"><span class="pre">--[no-]recurse</span></tt></dt>
-<dd>Use <tt class="docutils literal"><span class="pre">--no-recurse</span></tt> to disable uploading a directory recursively. Default: <tt class="docutils literal"><span class="pre">--recurse</span></tt>.</dd>
-<dt><tt class="docutils literal"><span class="pre">--repo-mode</span> <span class="pre">MODE</span></tt></dt>
-<dd>The layout of the local chef-repo. Possible values: <tt class="docutils literal"><span class="pre">static</span></tt>, <tt class="docutils literal"><span class="pre">everything</span></tt>, or <tt class="docutils literal"><span class="pre">hosted_everything</span></tt>. Use <tt class="docutils literal"><span class="pre">static</span></tt> for just roles, environments, cookbooks, and data bags. By default, <tt class="docutils literal"><span class="pre">everything</span></tt> and <tt class="docutils literal"><span class="pre">hosted_everything</span></tt> are dynamically selected depending on the server type. Default: <tt class="docutils literal"><span class="pre">everything</span></tt> / <tt class="docutils literal"><span class="pre">hosted_everything</span></tt>.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>The following examples show how to use this knife subcommand:</p>
-<p><strong>Upload the entire chef-repo</strong></p>
-<p>Browse to the top level of the chef-repo and enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload
-</pre></div>
-</div>
-<p>or from anywhere in the chef-repo, enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /
-</pre></div>
-</div>
-<p><strong>Upload the /cookbooks directory</strong></p>
-<p>Browse to the top level of the chef-repo and enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload cookbooks
-</pre></div>
-</div>
-<p>or from anywhere in the chef-repo, enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /cookbooks
-</pre></div>
-</div>
-<p><strong>Upload the /environments directory</strong></p>
-<p>Browse to the top level of the chef-repo and enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload environments
-</pre></div>
-</div>
-<p>or from anywhere in the chef-repo, enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /environments
-</pre></div>
-</div>
-<p><strong>Upload a single environment</strong></p>
-<p>Browse to the top level of the chef-repo and enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload environments/production.json
-</pre></div>
-</div>
-<p>or from the <tt class="docutils literal"><span class="pre">environments/</span></tt> directory, enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload production.json
-</pre></div>
-</div>
-<p><strong>Upload the /roles directory</strong></p>
-<p>Browse to the top level of the chef-repo and enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload roles
-</pre></div>
-</div>
-<p>or from anywhere in the chef-repo, enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload /roles
-</pre></div>
-</div>
-<p><strong>Upload cookbooks and roles</strong></p>
-<p>Browse to the top level of the chef-repo and enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload cookbooks/apache<span class="se">\*</span> roles/webserver.json
-</pre></div>
-</div>
-<p><strong>Use output of knife deps to pass command to knife upload</strong></p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife upload <span class="sb">`</span>knife deps nodes/*.json<span class="sb">`</span>
-</pre></div>
-</div>
-</div>
-</div>
-          </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-  </body>
-</html>

data/distro/common/html/knife_user.html DELETED

@@ -1,242 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>knife user &mdash; chef-client Man Pages</title>
-    <link rel="stylesheet" href="_static/guide.css" type="text/css" />
-    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    './',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="_static/jquery.js"></script>
-    <script type="text/javascript" src="_static/underscore.js"></script>
-    <script type="text/javascript" src="_static/doctools.js"></script>
-  </head>
-  <body>
-<div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
-<a href="http://docs.getchef.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
-</div>
-    <div class="document">
-      <div class="documentwrapper">
-          <div class="body">
-  <div class="section" id="knife-user">
-<h1>knife user<a class="headerlink" href="#knife-user" title="Permalink to this headline">¶</a></h1>
-<p>The <strong>knife user</strong> subcommand is used to manage the list of users and their associated RSA public key-pairs.</p>
-<div class="admonition note">
-<p class="first admonition-title">Note</p>
-<p class="last">This subcommand ONLY works when run against the open source Chef server and will not run against Enterprise Chef (including hosted Enterprise Chef), or Private Chef.</p>
-</div>
-<div class="admonition note">
-<p class="first admonition-title">Note</p>
-<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>
-</div>
-<div class="section" id="create">
-<h2>create<a class="headerlink" href="#create" title="Permalink to this headline">¶</a></h2>
-<p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to create a user. This process will generate an RSA key pair for the named user. The public key will be stored on the Chef server and the private key will be displayed on <tt class="docutils literal"><span class="pre">STDOUT</span></tt> or written to a named file.</p>
-<ul class="simple">
-<li>For the user, the private key should be copied to the system as <tt class="docutils literal"><span class="pre">/etc/chef/client.pem</span></tt>.</li>
-<li>For knife, the private key is typically copied to <tt class="docutils literal"><span class="pre">~/.chef/client_name.pem</span></tt> and referenced in the knife.rb configuration file.</li>
-</ul>
-<div class="section" id="syntax">
-<h3>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h3>
-<p>This argument has the following syntax:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user create USER_NAME <span class="o">(</span>options<span class="o">)</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="options">
-<h3>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h3>
-<p>This argument has the following options:</p>
-<dl class="docutils">
-<dt><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--admin</span></tt></dt>
-<dd>Use to create a client as an admin client. This is required for any user to access Open Source Chef as an administrator. This option only works when used with the open source Chef server and will have no effect when used with Enterprise Chef.</dd>
-<dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--file</span> <span class="pre">FILE_NAME</span></tt></dt>
-<dd>Use to save a private key to the specified file name.</dd>
-<dt><tt class="docutils literal"><span class="pre">-p</span> <span class="pre">PASSWORD</span></tt>, <tt class="docutils literal"><span class="pre">--password</span> <span class="pre">PASSWORD</span></tt></dt>
-<dd>The user password.</dd>
-<dt><tt class="docutils literal"><span class="pre">--user-key</span> <span class="pre">FILE_NAME</span></tt></dt>
-<dd>All users are assigned a public key. Use to write the public key to a file.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h3>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h3>
-<p>The following examples show how to use this knife subcommand:</p>
-<p><strong>Create a user</strong></p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user create <span class="s2">&quot;Radio Birdman&quot;</span> -f /keys/user_name
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="delete">
-<h2>delete<a class="headerlink" href="#delete" title="Permalink to this headline">¶</a></h2>
-<p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete a registered user.</p>
-<div class="section" id="id1">
-<h3>Syntax<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
-<p>This argument has the following syntax:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user delete USER_NAME
-</pre></div>
-</div>
-</div>
-<div class="section" id="id2">
-<h3>Options<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
-<p>This command does not have any specific options.</p>
-</div>
-<div class="section" id="id3">
-<h3>Examples<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
-<p>The following examples show how to use this knife subcommand:</p>
-<p><strong>Delete a user</strong></p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user delete <span class="s2">&quot;Steve Danno&quot;</span>
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="edit">
-<h2>edit<a class="headerlink" href="#edit" title="Permalink to this headline">¶</a></h2>
-<p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit the details of a user. When this argument is run, knife will open $EDITOR. When finished, knife will update the Chef server with those changes.</p>
-<div class="section" id="id4">
-<h3>Syntax<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
-<p>This argument has the following syntax:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user edit USER_NAME
-</pre></div>
-</div>
-</div>
-<div class="section" id="id5">
-<h3>Options<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h3>
-<p>This command does not have any specific options.</p>
-</div>
-<div class="section" id="id6">
-<h3>Examples<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h3>
-<p>None.</p>
-</div>
-</div>
-<div class="section" id="list">
-<h2>list<a class="headerlink" href="#list" title="Permalink to this headline">¶</a></h2>
-<p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to view a list of registered users.</p>
-<div class="section" id="id7">
-<h3>Syntax<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h3>
-<p>This argument has the following syntax:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user list <span class="o">(</span>options<span class="o">)</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="id8">
-<h3>Options<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h3>
-<p>This argument has the following options:</p>
-<dl class="docutils">
-<dt><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--with-uri</span></tt></dt>
-<dd>Use to show the corresponding URIs.</dd>
-</dl>
-</div>
-<div class="section" id="id9">
-<h3>Examples<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h3>
-<p>None.</p>
-</div>
-</div>
-<div class="section" id="reregister">
-<h2>reregister<a class="headerlink" href="#reregister" title="Permalink to this headline">¶</a></h2>
-<p>The <tt class="docutils literal"><span class="pre">reregister</span></tt> argument is used to regenerate an RSA key pair for a user. The public key will be stored on the Chef server and the private key will be displayed on <tt class="docutils literal"><span class="pre">STDOUT</span></tt> or written to a named file.</p>
-<div class="admonition note">
-<p class="first admonition-title">Note</p>
-<p class="last">Running this argument will invalidate the previous RSA key pair, making it unusable during authentication to the Chef server.</p>
-</div>
-<div class="section" id="id10">
-<h3>Syntax<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h3>
-<p>This argument has the following syntax:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user reregister USER_NAME <span class="o">(</span>options<span class="o">)</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="id11">
-<h3>Options<a class="headerlink" href="#id11" title="Permalink to this headline">¶</a></h3>
-<p>This argument has the following options:</p>
-<dl class="docutils">
-<dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--file</span> <span class="pre">FILE_NAME</span></tt></dt>
-<dd>Use to save a private key to the specified file name.</dd>
-</dl>
-</div>
-<div class="section" id="id12">
-<h3>Examples<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h3>
-<p>The following examples show how to use this knife subcommand:</p>
-<p><strong>Regenerate the RSA key-pair</strong></p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user reregister <span class="s2">&quot;Robert Younger&quot;</span>
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="show">
-<h2>show<a class="headerlink" href="#show" title="Permalink to this headline">¶</a></h2>
-<p>The <tt class="docutils literal"><span class="pre">show</span></tt> argument is used to show the details of a user.</p>
-<div class="section" id="id13">
-<h3>Syntax<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h3>
-<p>This argument has the following syntax:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user show USER_NAME <span class="o">(</span>options<span class="o">)</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="id14">
-<h3>Options<a class="headerlink" href="#id14" title="Permalink to this headline">¶</a></h3>
-<p>This argument has the following options:</p>
-<dl class="docutils">
-<dt><tt class="docutils literal"><span class="pre">-a</span> <span class="pre">ATTR</span></tt>, <tt class="docutils literal"><span class="pre">--attribute</span> <span class="pre">ATTR</span></tt></dt>
-<dd>The attribute (or attributes) to show.</dd>
-</dl>
-</div>
-<div class="section" id="id15">
-<h3>Examples<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h3>
-<p>The following examples show how to use this knife subcommand:</p>
-<p><strong>Show user data</strong></p>
-<p>To view a user named <tt class="docutils literal"><span class="pre">Dennis</span> <span class="pre">Teck</span></tt>, enter:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user show <span class="s2">&quot;Dennis Teck&quot;</span>
-</pre></div>
-</div>
-<p>to return something like:</p>
-<div class="highlight-bash"><div class="highlight"><pre>chef_type:   user
-json_class:  Chef::User
-name:        Dennis Teck
-public_key:
-</pre></div>
-</div>
-<p><strong>Show user data as JSON</strong></p>
-<p>To view information in JSON format, use the <tt class="docutils literal"><span class="pre">-F</span></tt> common option as part of the command like this:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife user show <span class="s2">&quot;Dennis Teck&quot;</span> -F json
-</pre></div>
-</div>
-<p>(Other formats available include <tt class="docutils literal"><span class="pre">text</span></tt>, <tt class="docutils literal"><span class="pre">yaml</span></tt>, and <tt class="docutils literal"><span class="pre">pp</span></tt>, e.g. <tt class="docutils literal"><span class="pre">-F</span> <span class="pre">yaml</span></tt> for YAML.)</p>
-</div>
-</div>
-</div>
-          </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-  </body>
-</html>

data/distro/common/html/knife_using.html DELETED

@@ -1,210 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>Working with Knife &mdash; chef-client Man Pages</title>
-    <link rel="stylesheet" href="_static/guide.css" type="text/css" />
-    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    './',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="_static/jquery.js"></script>
-    <script type="text/javascript" src="_static/underscore.js"></script>
-    <script type="text/javascript" src="_static/doctools.js"></script>
-  </head>
-  <body>
-<div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
-<a href="http://docs.getchef.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
-</div>
-    <div class="document">
-      <div class="documentwrapper">
-          <div class="body">
-  <div class="section" id="working-with-knife">
-<h1>Working with Knife<a class="headerlink" href="#working-with-knife" title="Permalink to this headline">¶</a></h1>
-<p>knife runs from a management workstation and sits in-between a Chef server and an organization&#8217;s infrastructure. knife interacts with a Chef server by using the same REST API that is used by a chef-client. Role-based authentication controls (RBAC) can be used to authorize changes when knife is run with Enterprise Chef. knife is configured during workstation setup, but subsequent modifications can be made using the knife.rb configuration file.</p>
-<div class="section" id="json-data-format">
-<h2>JSON Data Format<a class="headerlink" href="#json-data-format" title="Permalink to this headline">¶</a></h2>
-<p>Most data is entered using a text editor in JSON format, unless the <tt class="docutils literal"><span class="pre">--disable-editing</span></tt> option is entered as part of a command. (Encrypted data bags use YAML, which is a superset of JSON.) JSON is a common, language-independent data format that provides a simple text representation of arbitrary data structures. For more information about JSON, see <a class="reference external" href="http://www.json.org/">http://www.json.org/</a> or <a class="reference external" href="http://en.wikipedia.org/wiki/JSON">http://en.wikipedia.org/wiki/JSON</a>.</p>
-<div class="section" id="set-the-text-editor">
-<h3>Set the Text Editor<a class="headerlink" href="#set-the-text-editor" title="Permalink to this headline">¶</a></h3>
-<p>Some knife commands, such as <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">data</span> <span class="pre">bag</span> <span class="pre">edit</span></tt>, require that information be edited as JSON data using a text editor. For example, the following command:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife data bag edit admins admin_name
-</pre></div>
-</div>
-<p>will open up the text editor with data similar to:</p>
-<div class="highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
-  <span class="s2">&quot;id&quot;</span><span class="o">:</span> <span class="s2">&quot;admin_name&quot;</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-<p>Changes to that file can then be made:</p>
-<div class="highlight-javascript"><div class="highlight"><pre><span class="p">{</span>
-  <span class="s2">&quot;id&quot;</span><span class="o">:</span> <span class="s2">&quot;Justin C.&quot;</span>
-  <span class="s2">&quot;description&quot;</span><span class="o">:</span> <span class="s2">&quot;I am passing the time by letting time pass over me ...&quot;</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-<p>The type of text editor that is used by knife can be configured by adding an entry to the knife.rb file or by setting an <tt class="docutils literal"><span class="pre">EDITOR</span></tt> environment variable. For example, to configure the text editor to always open with vim, add the following to the knife.rb file:</p>
-<div class="highlight-ruby"><div class="highlight"><pre><span class="n">knife</span><span class="o">[</span><span class="ss">:editor</span><span class="o">]</span> <span class="o">=</span> <span class="s2">&quot;/usr/bin/vim&quot;</span>
-</pre></div>
-</div>
-<p>When a Microsoft Windows file path is enclosed in a double-quoted string (&#8221; &#8221;), the same backslash character (<tt class="docutils literal"><span class="pre">\</span></tt>) that is used to define the file path separator is also used in Ruby to define an escape character. The knife.rb file is a Ruby file; therefore, file path separators must be escaped. In addition, spaces in the file path must be replaced with <tt class="docutils literal"><span class="pre">~1</span></tt> so that the length of each section within the file path is not more than 8 characters. For example, if EditPad Pro is the text editor of choice and is located at the following path:</p>
-<div class="highlight-python"><div class="highlight"><pre>C:\\Program Files (x86)\EditPad Pro\EditPad.exe
-</pre></div>
-</div>
-<p>the setting in the knife.rb file would be similar to:</p>
-<div class="highlight-ruby"><div class="highlight"><pre><span class="n">knife</span><span class="o">[</span><span class="ss">:editor</span><span class="o">]</span> <span class="o">=</span> <span class="s2">&quot;C:</span><span class="se">\\</span><span class="s2">Progra~1</span><span class="se">\\</span><span class="s2">EditPa~1</span><span class="se">\\</span><span class="s2">EditPad.exe&quot;</span>
-</pre></div>
-</div>
-<p>One approach to working around the double- vs. single-quote issue is to put the single-quotes outside of the double-quotes. For example, for Notepad++:</p>
-<div class="highlight-ruby"><div class="highlight"><pre><span class="n">knife</span><span class="o">[</span><span class="ss">:editor</span><span class="o">]</span> <span class="o">=</span> <span class="s1">&#39;&quot;C:\Program Files (x86)\Notepad++\notepad++.exe -nosession -multiInst&quot;&#39;</span>
-</pre></div>
-</div>
-<p>for Sublime Text:</p>
-<div class="highlight-ruby"><div class="highlight"><pre><span class="n">knife</span><span class="o">[</span><span class="ss">:editor</span><span class="o">]</span> <span class="o">=</span> <span class="s1">&#39;&quot;C:\Program Files\Sublime Text 2\sublime_text.exe --wait&quot;&#39;</span>
-</pre></div>
-</div>
-<p>for TextPad:</p>
-<div class="highlight-ruby"><div class="highlight"><pre><span class="n">knife</span><span class="o">[</span><span class="ss">:editor</span><span class="o">]</span> <span class="o">=</span> <span class="s1">&#39;&quot;C:\Program Files (x86)\TextPad 7\TextPad.exe&quot;&#39;</span>
-</pre></div>
-</div>
-<p>and for vim:</p>
-<div class="highlight-ruby"><div class="highlight"><pre><span class="n">knife</span><span class="o">[</span><span class="ss">:editor</span><span class="o">]</span> <span class="o">=</span> <span class="s1">&#39;&quot;C:\Program Files (x86)\vim\vim74\gvim.exe&quot;&#39;</span>
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="using-quotes">
-<h2>Using Quotes<a class="headerlink" href="#using-quotes" title="Permalink to this headline">¶</a></h2>
-<p>Values can be entered with double quotes (&#8221; &#8221;) or single quotes (&#8216; &#8216;), but this should be done consistently.</p>
-</div>
-<div class="section" id="sub-commands">
-<h2>Sub-commands<a class="headerlink" href="#sub-commands" title="Permalink to this headline">¶</a></h2>
-<p>knife comes with a collection of built in subcommands that work together to provide all of the functionality required to take specific actions against any object in an organization, including cookbooks, nodes, roles, data bags, environments, and users. A knife plugin extends the functionality beyond built-in subcommands.</p>
-<p>knife has the following subcommands: <tt class="docutils literal"><span class="pre">bootstrap</span></tt>, <tt class="docutils literal"><span class="pre">client</span></tt>, <tt class="docutils literal"><span class="pre">configure</span></tt>, <tt class="docutils literal"><span class="pre">cookbook</span></tt>, <tt class="docutils literal"><span class="pre">cookbook</span> <span class="pre">site</span></tt>, <tt class="docutils literal"><span class="pre">data</span> <span class="pre">bag</span></tt>, <tt class="docutils literal"><span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">deps</span></tt>, <tt class="docutils literal"><span class="pre">diff</span></tt>, <tt class="docutils literal"><span class="pre">download</span></tt>, <tt class="docutils literal"><span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">environment</span></tt>, <tt class="docutils literal"><span class="pre">exec</span></tt>, <tt class="docutils literal"><span class="pre">index</span> <span class="pre">rebuild</span></tt>, <tt class="docutils literal"><span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">node</span></tt>, <tt class="docutils literal"><span class="pre">recipe</span> <span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">role</span></tt>, <tt class="docutils literal"><span class="pre">search</span></tt>, <tt class="docutils literal"><span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">ssh</span></tt>, <tt class="docutils literal"><span class="pre">status</span></tt>, <tt class="docutils literal"><span class="pre">tag</span></tt>, <tt class="docutils literal"><span class="pre">upload</span></tt>, <tt class="docutils literal"><span class="pre">user</span></tt>, and <tt class="docutils literal"><span class="pre">xargs</span></tt>.</p>
-<div class="admonition note">
-<p class="first admonition-title">Note</p>
-<p class="last">The following subcommands run only against the open source Chef server: <tt class="docutils literal"><span class="pre">index</span> <span class="pre">rebuild</span></tt> and <tt class="docutils literal"><span class="pre">user</span></tt>.</p>
-</div>
-</div>
-<div class="section" id="verb-sub-commands">
-<h2>Verb Sub-commands<a class="headerlink" href="#verb-sub-commands" title="Permalink to this headline">¶</a></h2>
-<p>knife includes a set of subcommands that are built around common verbs: <tt class="docutils literal"><span class="pre">delete</span></tt>, <tt class="docutils literal"><span class="pre">deps</span></tt>, <tt class="docutils literal"><span class="pre">diff</span></tt>, <tt class="docutils literal"><span class="pre">download</span></tt>, <tt class="docutils literal"><span class="pre">edit</span></tt>, <tt class="docutils literal"><span class="pre">list</span></tt>, <tt class="docutils literal"><span class="pre">show</span></tt>, <tt class="docutils literal"><span class="pre">upload</span></tt>, <tt class="docutils literal"><span class="pre">xargs</span></tt>. These subcommands allow knife to issue commands that interact with any object stored in the chef-repo or stored on the Chef server. Some important principles behind this group of subcommands includes:</p>
-<ul class="simple">
-<li>A command that works with each object in the chef-repo. The subcommands specify the desired action (the &#8220;verb&#8221;), and then directory in which that object resides (<tt class="docutils literal"><span class="pre">clients</span></tt>, <tt class="docutils literal"><span class="pre">cookbooks/</span></tt>, <tt class="docutils literal"><span class="pre">data_bags/</span></tt>, <tt class="docutils literal"><span class="pre">environments/</span></tt>, <tt class="docutils literal"><span class="pre">nodes</span></tt>, <tt class="docutils literal"><span class="pre">roles/</span></tt>, and <tt class="docutils literal"><span class="pre">users</span></tt>). For example: <tt class="docutils literal"><span class="pre">download</span> <span class="pre">cookbooks/</span></tt></li>
-<li>A command that works with certain objects in Enterprise Chef, including <tt class="docutils literal"><span class="pre">acls</span></tt>, <tt class="docutils literal"><span class="pre">groups</span></tt>, and <tt class="docutils literal"><span class="pre">containers</span></tt></li>
-<li>Uses the Chef server as if it were a file system, allowing the chef-repo on the Chef server to behave like a mirror of the chef-repo on the workstation. The Chef server will have the same objects as the local chef-repo. To make changes to the files on the Chef server, just download files from the Chef server or upload files from the chef-repo</li>
-<li>The context from which a command is run matters. For example, when working in the <tt class="docutils literal"><span class="pre">roles/</span></tt> directory, knife will know what is being worked with. Enter <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">show</span> <span class="pre">base.json</span></tt> and knife will return the base role from the Chef server. From the chef-repo root, enter <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">show</span> <span class="pre">roles/base.json</span></tt> to get the same result</li>
-<li>Parallel requests can be made to the Chef server and are configurable on a per-command basis</li>
-</ul>
-<div class="section" id="wildcard-search">
-<h3>Wildcard Search<a class="headerlink" href="#wildcard-search" title="Permalink to this headline">¶</a></h3>
-<p>A wildcard matching pattern can be used for substring matches that replace zero (or more) characters. There are two types of wildcard patterns:</p>
-<ul class="simple">
-<li>A question mark (”?”) can be used to replace exactly one character (as long as that character is not the first character)</li>
-<li>An asterisk (“*”) can be used to replace any number of characters (including zero)</li>
-</ul>
-<p>Wildcard patterns must be escaped (using a backslash) so that the wildcard itself can reach the Chef server. If they are not escaped, the wildcard is expanded into the actual filenames and knife will not know the wildcard was intended to be used. For example, if the Chef server has data bags named <tt class="docutils literal"><span class="pre">aardvarks</span></tt>, <tt class="docutils literal"><span class="pre">anagrams</span></tt>, and <tt class="docutils literal"><span class="pre">arp_tables</span></tt>, but the local file system only has <tt class="docutils literal"><span class="pre">aardvarks</span></tt> and <tt class="docutils literal"><span class="pre">anagrams</span></tt>, escaping vs. not escaping the wildcard pattern will yield different results:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife list data_bags/a<span class="se">\*</span>
-</pre></div>
-</div>
-<p>asks the Chef server for everything starting with the letter &#8220;a&#8221; and will return:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>aardvarks/ anagrams/ arp_tables/
-</pre></div>
-</div>
-<p>But, the following:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife list data_bags/a*
-</pre></div>
-</div>
-<p>will return:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>aardvarks/ anagrams/
-</pre></div>
-</div>
-<p>Which is the same as entering:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife list data_bags/aardvarks data_bags/anagrams
-</pre></div>
-</div>
-<p>to return:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>aardvarks/ anagrams/
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="plug-ins">
-<h2>Plug-ins<a class="headerlink" href="#plug-ins" title="Permalink to this headline">¶</a></h2>
-<p>Chef provides the following plugins, which work the same as built-in subcommands (including common options), but must be installed separately (using RubyGems): <strong>knife azure</strong>, <strong>knife bluebox</strong>, <strong>knife ec2</strong>, <strong>knife eucalyptus</strong>, <strong>knife google</strong>, <strong>knife hp</strong>, <strong>knife linode</strong>, <strong>knife openstack</strong>, <strong>knife rackspace</strong>, <strong>knife terremark</strong>, <strong>knife vcloud</strong>, and <strong>knife windows</strong>.</p>
-<p>The community provides many other plugins for knife: <a class="reference external" href="http://community.opscode.com/">http://community.opscode.com/</a>.</p>
-</div>
-<div class="section" id="syntax">
-<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
-<p>All knife subcommands have the following syntax:</p>
-<blockquote>
-<div>knife subcommand [ARGUMENT] (options)</div></blockquote>
-<p>Each subcommand has its own set of arguments and options.</p>
-<div class="admonition note">
-<p class="first admonition-title">Note</p>
-<p class="last">All syntax examples in this document show variables in ALL_CAPS. For example <tt class="docutils literal"><span class="pre">-u</span> <span class="pre">PORT_LIST</span></tt> (where PORT_LIST is a comma-separated list of local and public UDP ports) or <tt class="docutils literal"><span class="pre">-F</span> <span class="pre">FORMAT</span></tt> (where FORMAT determines the output format, either <tt class="docutils literal"><span class="pre">summary</span></tt>, <tt class="docutils literal"><span class="pre">text</span></tt>, <tt class="docutils literal"><span class="pre">json</span></tt>, <tt class="docutils literal"><span class="pre">yaml</span></tt>, or <tt class="docutils literal"><span class="pre">pp</span></tt>). These variables often require specific values that are unique to each organization.</p>
-</div>
-</div>
-<div class="section" id="many-users-same-repo">
-<h2>Many Users, Same Repo<a class="headerlink" href="#many-users-same-repo" title="Permalink to this headline">¶</a></h2>
-<p>It is possible for multiple users to access the Chef server using the same knife.rb file. (A user can even access multiple organizations if, for example, each instance of the chef-repo contained the same copy of the knife.rb file.) This can be done by adding the knife.rb file to the chef-repo, and then using environment variables to handle the user-specific credential details and/or sensitive values. For example:</p>
-<div class="highlight-ruby"><div class="highlight"><pre><span class="n">current_dir</span> <span class="o">=</span> <span class="no">File</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="bp">__FILE__</span><span class="p">)</span>
-  <span class="n">user</span> <span class="o">=</span> <span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;OPSCODE_USER&#39;</span><span class="o">]</span> <span class="o">||</span> <span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;USER&#39;</span><span class="o">]</span>
-  <span class="n">node_name</span>                <span class="n">user</span>
-  <span class="n">client_key</span>               <span class="s2">&quot;</span><span class="si">#{</span><span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;HOME&#39;</span><span class="o">]</span><span class="si">}</span><span class="s2">/.chef/</span><span class="si">#{</span><span class="n">user</span><span class="si">}</span><span class="s2">.pem&quot;</span>
-  <span class="n">validation_client_name</span>   <span class="s2">&quot;</span><span class="si">#{</span><span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;ORGNAME&#39;</span><span class="o">]</span><span class="si">}</span><span class="s2">-validator&quot;</span>
-  <span class="n">validation_key</span>           <span class="s2">&quot;</span><span class="si">#{</span><span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;HOME&#39;</span><span class="o">]</span><span class="si">}</span><span class="s2">/.chef/</span><span class="si">#{</span><span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;ORGNAME&#39;</span><span class="o">]</span><span class="si">}</span><span class="s2">-validator.pem&quot;</span>
-  <span class="n">chef_server_url</span>          <span class="s2">&quot;https://api.opscode.com/organizations/</span><span class="si">#{</span><span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;ORGNAME&#39;</span><span class="o">]</span><span class="si">}</span><span class="s2">&quot;</span>
-  <span class="n">syntax_check_cache_path</span>  <span class="s2">&quot;</span><span class="si">#{</span><span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;HOME&#39;</span><span class="o">]</span><span class="si">}</span><span class="s2">/.chef/syntax_check_cache&quot;</span>
-  <span class="n">cookbook_path</span>            <span class="o">[</span><span class="s2">&quot;</span><span class="si">#{</span><span class="n">current_dir</span><span class="si">}</span><span class="s2">/../cookbooks&quot;</span><span class="o">]</span>
-  <span class="n">cookbook_copyright</span> <span class="s2">&quot;Your Company, Inc.&quot;</span>
-  <span class="n">cookbook_license</span> <span class="s2">&quot;apachev2&quot;</span>
-  <span class="n">cookbook_email</span> <span class="s2">&quot;cookbooks@yourcompany.com&quot;</span>
-  <span class="c1"># Amazon AWS</span>
-  <span class="n">knife</span><span class="o">[</span><span class="ss">:aws_access_key_id</span><span class="o">]</span> <span class="o">=</span> <span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;AWS_ACCESS_KEY_ID&#39;</span><span class="o">]</span>
-  <span class="n">knife</span><span class="o">[</span><span class="ss">:aws_secret_access_key</span><span class="o">]</span> <span class="o">=</span> <span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;AWS_SECRET_ACCESS_KEY&#39;</span><span class="o">]</span>
-  <span class="c1"># Rackspace Cloud</span>
-  <span class="n">knife</span><span class="o">[</span><span class="ss">:rackspace_api_username</span><span class="o">]</span> <span class="o">=</span> <span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;RACKSPACE_USERNAME&#39;</span><span class="o">]</span>
-  <span class="n">knife</span><span class="o">[</span><span class="ss">:rackspace_api_key</span><span class="o">]</span> <span class="o">=</span> <span class="no">ENV</span><span class="o">[</span><span class="s1">&#39;RACKSPACE_API_KEY&#39;</span><span class="o">]</span>
-</pre></div>
-</div>
-</div>
-</div>
-          </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-  </body>
-</html>