chef 13.11.3 → 13.12.3
Sign up to get free protection for your applications and to get access to all the features.
- 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 -248
- 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/distro/powershell/chef/chef.psm1 +0 -459
- data/tasks/cbgb.rb +0 -84
@@ -1,74 +0,0 @@
|
|
1
|
-
=====================================================
|
2
|
-
knife
|
3
|
-
=====================================================
|
4
|
-
|
5
|
-
.. include:: ../../includes_knife/includes_knife.rst
|
6
|
-
|
7
|
-
The following sections describe functionality common to all |knife| subcommands:
|
8
|
-
|
9
|
-
* :doc:`knife_using`
|
10
|
-
* :doc:`knife_common_options`
|
11
|
-
|
12
|
-
|knife| includes the following sub-commands:
|
13
|
-
|
14
|
-
.. list-table::
|
15
|
-
:widths: 150 450
|
16
|
-
:header-rows: 1
|
17
|
-
|
18
|
-
* - Sub-command
|
19
|
-
- Description
|
20
|
-
* - :doc:`knife_bootstrap`
|
21
|
-
- .. include:: ../../includes_knife/includes_knife_bootstrap.rst
|
22
|
-
* - :doc:`knife_client`
|
23
|
-
- .. include:: ../../includes_knife/includes_knife_client.rst
|
24
|
-
* - :doc:`knife_configure`
|
25
|
-
- .. include:: ../../includes_knife/includes_knife_configure.rst
|
26
|
-
* - :doc:`knife_cookbook`
|
27
|
-
- .. include:: ../../includes_knife/includes_knife_cookbook.rst
|
28
|
-
* - :doc:`knife_cookbook_site`
|
29
|
-
- .. include:: ../../includes_knife/includes_knife_site_cookbook.rst
|
30
|
-
* - :doc:`knife_data_bag`
|
31
|
-
- .. include:: ../../includes_knife/includes_knife_data_bag.rst
|
32
|
-
* - :doc:`knife_delete`
|
33
|
-
- .. include:: ../../includes_knife/includes_knife_delete.rst
|
34
|
-
* - :doc:`knife_deps`
|
35
|
-
- .. include:: ../../includes_knife/includes_knife_deps.rst
|
36
|
-
* - :doc:`knife_diff`
|
37
|
-
- .. include:: ../../includes_knife/includes_knife_diff.rst
|
38
|
-
* - :doc:`knife_download`
|
39
|
-
- .. include:: ../../includes_knife/includes_knife_download.rst
|
40
|
-
* - :doc:`knife_edit`
|
41
|
-
- .. include:: ../../includes_knife/includes_knife_edit.rst
|
42
|
-
* - :doc:`knife_environment`
|
43
|
-
- .. include:: ../../includes_knife/includes_knife_environment.rst
|
44
|
-
* - :doc:`knife_exec`
|
45
|
-
- .. include:: ../../includes_knife/includes_knife_exec.rst
|
46
|
-
* - :doc:`knife_index_rebuild`
|
47
|
-
- .. include:: ../../includes_knife/includes_knife_index_rebuild.rst
|
48
|
-
* - :doc:`knife_list`
|
49
|
-
- .. include:: ../../includes_knife/includes_knife_list.rst
|
50
|
-
* - :doc:`knife_node`
|
51
|
-
- .. include:: ../../includes_knife/includes_knife_node.rst
|
52
|
-
* - :doc:`knife_raw`
|
53
|
-
- .. include:: ../../includes_knife/includes_knife_raw.rst
|
54
|
-
* - :doc:`knife_recipe_list`
|
55
|
-
- .. include:: ../../includes_knife/includes_knife_recipe_list.rst
|
56
|
-
* - :doc:`knife_role`
|
57
|
-
- .. include:: ../../includes_knife/includes_knife_role.rst
|
58
|
-
* - :doc:`knife_search`
|
59
|
-
- .. include:: ../../includes_knife/includes_knife_search.rst
|
60
|
-
* - :doc:`knife_show`
|
61
|
-
- .. include:: ../../includes_knife/includes_knife_show.rst
|
62
|
-
* - :doc:`knife_ssh`
|
63
|
-
- .. include:: ../../includes_knife/includes_knife_ssh.rst
|
64
|
-
* - :doc:`knife_status`
|
65
|
-
- .. include:: ../../includes_knife/includes_knife_status.rst
|
66
|
-
* - :doc:`knife_tag`
|
67
|
-
- .. include:: ../../includes_knife/includes_knife_tag.rst
|
68
|
-
* - :doc:`knife_upload`
|
69
|
-
- .. include:: ../../includes_knife/includes_knife_upload.rst
|
70
|
-
* - :doc:`knife_user`
|
71
|
-
- .. include:: ../../includes_knife/includes_knife_user.rst
|
72
|
-
* - :doc:`knife_xargs`
|
73
|
-
- .. include:: ../../includes_knife/includes_knife_xargs.rst
|
74
|
-
|
@@ -1,56 +0,0 @@
|
|
1
|
-
=====================================================
|
2
|
-
knife bootstrap
|
3
|
-
=====================================================
|
4
|
-
|
5
|
-
.. include:: ../../includes_chef/includes_chef_bootstrap.rst
|
6
|
-
|
7
|
-
.. include:: ../../includes_knife/includes_knife_bootstrap.rst
|
8
|
-
|
9
|
-
.. note:: To bootstrap the |chef client| on |windows| machines, the `knife-windows <http://docs.opscode.com/plugin_knife_windows.html>`_ plugins is required, which includes the necessary bootstrap scripts that are used to do the actual installation.
|
10
|
-
|
11
|
-
Syntax
|
12
|
-
=====================================================
|
13
|
-
.. include:: ../../includes_knife/includes_knife_bootstrap_syntax.rst
|
14
|
-
|
15
|
-
Options
|
16
|
-
=====================================================
|
17
|
-
.. note:: Review the list of :doc:`common options </knife_common_options>` available to this (and all) |knife| subcommands and plugins.
|
18
|
-
|
19
|
-
.. include:: ../../release_chef_12-0/includes_knife_bootstrap_options.rst
|
20
|
-
|
21
|
-
Custom Templates
|
22
|
-
=====================================================
|
23
|
-
The ``chef-full`` distribution uses the |omnibus installer|. For most bootstrap operations, regardless of the platform on which the target node is running, using the ``chef-full`` distribution is the best approach for installing the |chef client| on a target node. In some situations, using another supported distribution is necessary. And in some situations, a custom template may be required. For example, the default bootstrap operation relies on an Internet connection to get the distribution to the target node. If a target node cannot access the Internet, then a custom template can be used to define a specific location for the distribution so that the target node may access it during the bootstrap operation.
|
24
|
-
|
25
|
-
A custom bootstrap template file (``template_filename.erb``) must be located in a ``bootstrap/`` directory. Use the ``--distro`` option with the ``knife bootstrap`` subcommand to specify the bootstrap template file. For example, a bootstrap template file named "british_sea_power.erb":
|
26
|
-
|
27
|
-
.. code-block:: bash
|
28
|
-
|
29
|
-
$ knife bootstrap 123.456.7.8 -x username -P password --sudo --distro "british_sea_power.erb"
|
30
|
-
|
31
|
-
The following examples show how a bootstrap template file can be customized for various platforms.
|
32
|
-
|
33
|
-
Ubuntu 12.04
|
34
|
-
-----------------------------------------------------
|
35
|
-
.. include:: ../../includes_knife/includes_knife_bootstrap_example_ubuntu.rst
|
36
|
-
|
37
|
-
Debian and Apt
|
38
|
-
-----------------------------------------------------
|
39
|
-
.. include:: ../../includes_knife/includes_knife_bootstrap_example_debian.rst
|
40
|
-
|
41
|
-
Microsoft Windows
|
42
|
-
-----------------------------------------------------
|
43
|
-
.. include:: ../../includes_knife/includes_knife_bootstrap_example_windows.rst
|
44
|
-
|
45
|
-
Examples
|
46
|
-
=====================================================
|
47
|
-
The following examples show how to use this |knife| subcommand:
|
48
|
-
|
49
|
-
**Use an SSH password**
|
50
|
-
|
51
|
-
.. include:: ../../step_knife/step_knife_bootstrap_use_ssh_password.rst
|
52
|
-
|
53
|
-
**Use a file that contains a private key**
|
54
|
-
|
55
|
-
.. include:: ../../step_knife/step_knife_bootstrap_use_file_with_private_key.rst
|
56
|
-
|
@@ -1,151 +0,0 @@
|
|
1
|
-
=====================================================
|
2
|
-
knife client
|
3
|
-
=====================================================
|
4
|
-
|
5
|
-
.. include:: ../../includes_knife/includes_knife_client.rst
|
6
|
-
|
7
|
-
.. note:: Review the list of :doc:`common options </knife_common_options>` available to this (and all) |knife| subcommands and plugins.
|
8
|
-
|
9
|
-
bulk delete
|
10
|
-
=====================================================
|
11
|
-
.. include:: ../../includes_knife/includes_knife_client_bulk_delete.rst
|
12
|
-
|
13
|
-
Syntax
|
14
|
-
-----------------------------------------------------
|
15
|
-
.. include:: ../../includes_knife/includes_knife_client_bulk_delete_syntax.rst
|
16
|
-
|
17
|
-
Options
|
18
|
-
-----------------------------------------------------
|
19
|
-
|no_options|
|
20
|
-
|
21
|
-
Examples
|
22
|
-
-----------------------------------------------------
|
23
|
-
None.
|
24
|
-
|
25
|
-
create
|
26
|
-
=====================================================
|
27
|
-
.. include:: ../../includes_knife/includes_knife_client_create.rst
|
28
|
-
|
29
|
-
Syntax
|
30
|
-
-----------------------------------------------------
|
31
|
-
.. include:: ../../includes_knife/includes_knife_client_create_syntax.rst
|
32
|
-
|
33
|
-
Options
|
34
|
-
-----------------------------------------------------
|
35
|
-
.. include:: ../../includes_knife/includes_knife_client_create_options.rst
|
36
|
-
|
37
|
-
Examples
|
38
|
-
-----------------------------------------------------
|
39
|
-
The following examples show how to use this |knife| subcommand:
|
40
|
-
|
41
|
-
**Create an admin client**
|
42
|
-
|
43
|
-
.. include:: ../../step_knife/step_knife_client_create_admin.rst
|
44
|
-
|
45
|
-
**Create an admin client for Enterprise Chef**
|
46
|
-
|
47
|
-
.. include:: ../../step_knife/step_knife_client_create_hosted_and_private.rst
|
48
|
-
|
49
|
-
delete
|
50
|
-
=====================================================
|
51
|
-
.. include:: ../../includes_knife/includes_knife_client_delete.rst
|
52
|
-
|
53
|
-
Syntax
|
54
|
-
-----------------------------------------------------
|
55
|
-
.. include:: ../../includes_knife/includes_knife_client_delete_syntax.rst
|
56
|
-
|
57
|
-
Options
|
58
|
-
-----------------------------------------------------
|
59
|
-
|no_options|
|
60
|
-
|
61
|
-
Examples
|
62
|
-
-----------------------------------------------------
|
63
|
-
The following examples show how to use this |knife| subcommand:
|
64
|
-
|
65
|
-
**Delete a client**
|
66
|
-
|
67
|
-
.. include:: ../../step_knife/step_knife_client_delete.rst
|
68
|
-
|
69
|
-
edit
|
70
|
-
=====================================================
|
71
|
-
.. include:: ../../includes_knife/includes_knife_client_edit.rst
|
72
|
-
|
73
|
-
Syntax
|
74
|
-
-----------------------------------------------------
|
75
|
-
.. include:: ../../includes_knife/includes_knife_client_edit_syntax.rst
|
76
|
-
|
77
|
-
Options
|
78
|
-
-----------------------------------------------------
|
79
|
-
|no_options|
|
80
|
-
|
81
|
-
Examples
|
82
|
-
-----------------------------------------------------
|
83
|
-
The following examples show how to use this |knife| subcommand:
|
84
|
-
|
85
|
-
**Edit a client**
|
86
|
-
|
87
|
-
.. include:: ../../step_knife/step_knife_client_edit.rst
|
88
|
-
|
89
|
-
list
|
90
|
-
=====================================================
|
91
|
-
.. include:: ../../includes_knife/includes_knife_client_list.rst
|
92
|
-
|
93
|
-
Syntax
|
94
|
-
-----------------------------------------------------
|
95
|
-
.. include:: ../../includes_knife/includes_knife_client_list_syntax.rst
|
96
|
-
|
97
|
-
Options
|
98
|
-
-----------------------------------------------------
|
99
|
-
.. include:: ../../includes_knife/includes_knife_client_list_options.rst
|
100
|
-
|
101
|
-
Examples
|
102
|
-
-----------------------------------------------------
|
103
|
-
The following examples show how to use this |knife| subcommand:
|
104
|
-
|
105
|
-
**View a list of clients**
|
106
|
-
|
107
|
-
.. include:: ../../step_knife/step_knife_client_list_all.rst
|
108
|
-
|
109
|
-
.. include:: ../../step_knife/step_knife_client_list_authenticate.rst
|
110
|
-
|
111
|
-
reregister
|
112
|
-
=====================================================
|
113
|
-
.. include:: ../../includes_knife/includes_knife_client_reregister.rst
|
114
|
-
|
115
|
-
Syntax
|
116
|
-
-----------------------------------------------------
|
117
|
-
.. include:: ../../includes_knife/includes_knife_client_reregister_syntax.rst
|
118
|
-
|
119
|
-
Options
|
120
|
-
-----------------------------------------------------
|
121
|
-
.. include:: ../../includes_knife/includes_knife_client_reregister_options.rst
|
122
|
-
|
123
|
-
Examples
|
124
|
-
-----------------------------------------------------
|
125
|
-
The following examples show how to use this |knife| subcommand:
|
126
|
-
|
127
|
-
**Reregister clients**
|
128
|
-
|
129
|
-
.. include:: ../../step_knife/step_knife_client_reregister.rst
|
130
|
-
|
131
|
-
show
|
132
|
-
=====================================================
|
133
|
-
.. include:: ../../includes_knife/includes_knife_client_show.rst
|
134
|
-
|
135
|
-
Syntax
|
136
|
-
-----------------------------------------------------
|
137
|
-
.. include:: ../../includes_knife/includes_knife_client_show_syntax.rst
|
138
|
-
|
139
|
-
Options
|
140
|
-
-----------------------------------------------------
|
141
|
-
.. include:: ../../includes_knife/includes_knife_client_show_options.rst
|
142
|
-
|
143
|
-
Examples
|
144
|
-
-----------------------------------------------------
|
145
|
-
The following examples show how to use this |knife| subcommand:
|
146
|
-
|
147
|
-
**Show clients**
|
148
|
-
|
149
|
-
.. include:: ../../step_knife/step_knife_client_show.rst
|
150
|
-
|
151
|
-
.. include:: ../../step_knife/step_knife_common_view_json.rst
|
@@ -1,29 +0,0 @@
|
|
1
|
-
=====================================================
|
2
|
-
knife configure
|
3
|
-
=====================================================
|
4
|
-
|
5
|
-
.. include:: ../../includes_knife/includes_knife_configure.rst
|
6
|
-
|
7
|
-
Syntax
|
8
|
-
=====================================================
|
9
|
-
.. include:: ../../includes_knife/includes_knife_configure_syntax.rst
|
10
|
-
|
11
|
-
Options
|
12
|
-
=====================================================
|
13
|
-
.. note:: Review the list of :doc:`common options </knife_common_options>` available to this (and all) |knife| subcommands and plugins.
|
14
|
-
|
15
|
-
.. include:: ../../includes_knife/includes_knife_configure_options.rst
|
16
|
-
|
17
|
-
Examples
|
18
|
-
=====================================================
|
19
|
-
The following examples show how to use this |knife| subcommand:
|
20
|
-
|
21
|
-
**Configure knife.rb**
|
22
|
-
|
23
|
-
.. include:: ../../step_knife/step_knife_configure_knife_rb.rst
|
24
|
-
|
25
|
-
**Configure client.rb**
|
26
|
-
|
27
|
-
.. include:: ../../step_knife/step_knife_configure_client_rb.rst
|
28
|
-
|
29
|
-
|
@@ -1,236 +0,0 @@
|
|
1
|
-
=====================================================
|
2
|
-
knife cookbook
|
3
|
-
=====================================================
|
4
|
-
|
5
|
-
.. include:: ../../includes_cookbooks/includes_cookbooks.rst
|
6
|
-
|
7
|
-
.. include:: ../../includes_knife/includes_knife_cookbook.rst
|
8
|
-
|
9
|
-
.. note:: Review the list of :doc:`common options </knife_common_options>` available to this (and all) |knife| subcommands and plugins.
|
10
|
-
|
11
|
-
bulk delete
|
12
|
-
=====================================================
|
13
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_bulk_delete.rst
|
14
|
-
|
15
|
-
Syntax
|
16
|
-
-----------------------------------------------------
|
17
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_bulk_delete_syntax.rst
|
18
|
-
|
19
|
-
Options
|
20
|
-
-----------------------------------------------------
|
21
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_bulk_delete_options.rst
|
22
|
-
|
23
|
-
Examples
|
24
|
-
-----------------------------------------------------
|
25
|
-
The following examples show how to use this |knife| subcommand:
|
26
|
-
|
27
|
-
**Bulk delete many cookbooks**
|
28
|
-
|
29
|
-
.. include:: ../../step_knife/step_knife_cookbook_bulk_delete.rst
|
30
|
-
|
31
|
-
|
32
|
-
create
|
33
|
-
=====================================================
|
34
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_create.rst
|
35
|
-
|
36
|
-
Syntax
|
37
|
-
-----------------------------------------------------
|
38
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_create_syntax.rst
|
39
|
-
|
40
|
-
Options
|
41
|
-
-----------------------------------------------------
|
42
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_create_options.rst
|
43
|
-
|
44
|
-
Examples
|
45
|
-
-----------------------------------------------------
|
46
|
-
The following examples show how to use this |knife| subcommand:
|
47
|
-
|
48
|
-
**Create a cookbook**
|
49
|
-
|
50
|
-
.. include:: ../../step_knife/step_knife_cookbook_create_with_options.rst
|
51
|
-
|
52
|
-
|
53
|
-
delete
|
54
|
-
=====================================================
|
55
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_delete.rst
|
56
|
-
|
57
|
-
Syntax
|
58
|
-
-----------------------------------------------------
|
59
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_delete_syntax.rst
|
60
|
-
|
61
|
-
Options
|
62
|
-
-----------------------------------------------------
|
63
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_delete_options.rst
|
64
|
-
|
65
|
-
Examples
|
66
|
-
-----------------------------------------------------
|
67
|
-
The following examples show how to use this |knife| subcommand:
|
68
|
-
|
69
|
-
**Delete a cookbook**
|
70
|
-
|
71
|
-
.. include:: ../../step_knife/step_knife_cookbook_delete.rst
|
72
|
-
|
73
|
-
|
74
|
-
download
|
75
|
-
=====================================================
|
76
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_download.rst
|
77
|
-
|
78
|
-
Syntax
|
79
|
-
-----------------------------------------------------
|
80
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_download_syntax.rst
|
81
|
-
|
82
|
-
Options
|
83
|
-
-----------------------------------------------------
|
84
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_download_options.rst
|
85
|
-
|
86
|
-
Examples
|
87
|
-
-----------------------------------------------------
|
88
|
-
The following examples show how to use this |knife| subcommand:
|
89
|
-
|
90
|
-
**Download a cookbook**
|
91
|
-
|
92
|
-
.. include:: ../../step_knife/step_knife_cookbook_download.rst
|
93
|
-
|
94
|
-
|
95
|
-
list
|
96
|
-
=====================================================
|
97
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_list.rst
|
98
|
-
|
99
|
-
Syntax
|
100
|
-
-----------------------------------------------------
|
101
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_list_syntax.rst
|
102
|
-
|
103
|
-
Options
|
104
|
-
-----------------------------------------------------
|
105
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_list_options.rst
|
106
|
-
|
107
|
-
Examples
|
108
|
-
-----------------------------------------------------
|
109
|
-
The following examples show how to use this |knife| subcommand:
|
110
|
-
|
111
|
-
**View a list of cookbooks**
|
112
|
-
|
113
|
-
.. include:: ../../step_knife/step_knife_cookbook_list.rst
|
114
|
-
|
115
|
-
|
116
|
-
metadata
|
117
|
-
=====================================================
|
118
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_metadata.rst
|
119
|
-
|
120
|
-
Syntax
|
121
|
-
-----------------------------------------------------
|
122
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_metadata_syntax.rst
|
123
|
-
|
124
|
-
Options
|
125
|
-
-----------------------------------------------------
|
126
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_metadata_options.rst
|
127
|
-
|
128
|
-
Examples
|
129
|
-
-----------------------------------------------------
|
130
|
-
The following examples show how to use this |knife| subcommand:
|
131
|
-
|
132
|
-
**Generate metadata**
|
133
|
-
|
134
|
-
.. include:: ../../step_knife/step_knife_cookbook_metadata.rst
|
135
|
-
|
136
|
-
|
137
|
-
metadata from file
|
138
|
-
=====================================================
|
139
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_metadata_from_file.rst
|
140
|
-
|
141
|
-
Syntax
|
142
|
-
-----------------------------------------------------
|
143
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_metadata_from_file_syntax.rst
|
144
|
-
|
145
|
-
Options
|
146
|
-
-----------------------------------------------------
|
147
|
-
|no_options|
|
148
|
-
|
149
|
-
Examples
|
150
|
-
-----------------------------------------------------
|
151
|
-
The following examples show how to use this |knife| subcommand:
|
152
|
-
|
153
|
-
**View metadata**
|
154
|
-
|
155
|
-
.. include:: ../../step_knife/step_knife_cookbook_metadata_from_file.rst
|
156
|
-
|
157
|
-
|
158
|
-
show
|
159
|
-
=====================================================
|
160
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_show.rst
|
161
|
-
|
162
|
-
Syntax
|
163
|
-
-----------------------------------------------------
|
164
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_show_syntax.rst
|
165
|
-
|
166
|
-
Options
|
167
|
-
-----------------------------------------------------
|
168
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_show_options.rst
|
169
|
-
|
170
|
-
Examples
|
171
|
-
-----------------------------------------------------
|
172
|
-
The following examples show how to use this |knife| subcommand:
|
173
|
-
|
174
|
-
**Show cookbook data**
|
175
|
-
|
176
|
-
.. include:: ../../step_knife/step_knife_cookbook_show_cookbook_data.rst
|
177
|
-
|
178
|
-
**Show cookbook versions**
|
179
|
-
|
180
|
-
.. include:: ../../step_knife/step_knife_cookbook_show_cookbook_versions.rst
|
181
|
-
|
182
|
-
**Show a cookbook version**
|
183
|
-
|
184
|
-
.. include:: ../../step_knife/step_knife_cookbook_show_cookbook_version.rst
|
185
|
-
|
186
|
-
**Show cookbook data as JSON**
|
187
|
-
|
188
|
-
.. include:: ../../step_knife/step_knife_common_view_json.rst
|
189
|
-
|
190
|
-
|
191
|
-
test
|
192
|
-
=====================================================
|
193
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_test.rst
|
194
|
-
|
195
|
-
Syntax
|
196
|
-
-----------------------------------------------------
|
197
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_test_syntax.rst
|
198
|
-
|
199
|
-
Options
|
200
|
-
-----------------------------------------------------
|
201
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_test_options.rst
|
202
|
-
|
203
|
-
Examples
|
204
|
-
-----------------------------------------------------
|
205
|
-
The following examples show how to use this |knife| subcommand:
|
206
|
-
|
207
|
-
**Test a cookbook**
|
208
|
-
|
209
|
-
.. include:: ../../step_knife/step_knife_cookbook_test.rst
|
210
|
-
|
211
|
-
|
212
|
-
upload
|
213
|
-
=====================================================
|
214
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_upload.rst
|
215
|
-
|
216
|
-
Syntax
|
217
|
-
-----------------------------------------------------
|
218
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_upload_syntax.rst
|
219
|
-
|
220
|
-
Options
|
221
|
-
-----------------------------------------------------
|
222
|
-
.. include:: ../../includes_knife/includes_knife_cookbook_upload_options.rst
|
223
|
-
|
224
|
-
Examples
|
225
|
-
-----------------------------------------------------
|
226
|
-
The following examples show how to use this |knife| subcommand:
|
227
|
-
|
228
|
-
**Upload a cookbook**
|
229
|
-
|
230
|
-
.. include:: ../../step_knife/step_knife_cookbook_upload.rst
|
231
|
-
|
232
|
-
**Freeze a cookbook**
|
233
|
-
|
234
|
-
.. include:: ../../step_knife/step_knife_cookbook_upload_freeze.rst
|
235
|
-
|
236
|
-
.. include:: ../../step_knife/step_knife_cookbook_upload_force.rst
|