chef 13.11.3-universal-mingw32 → 13.12.3-universal-mingw32
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 -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
@@ -1,121 +0,0 @@
|
|
1
|
-
knife-data-bag(1) -- Store arbitrary data on a Chef Server
|
2
|
-
========================================
|
3
|
-
|
4
|
-
## SYNOPSIS
|
5
|
-
|
6
|
-
__knife__ __data bag__ _sub-command_ _(options)_
|
7
|
-
|
8
|
-
## DESCRIPTION
|
9
|
-
Data bags are stores of arbitrary JSON data. Each data bag is a
|
10
|
-
collection that may contain many items. Data Bag Items are indexed by
|
11
|
-
the Chef Server and can be searched via __knife-search__(1).
|
12
|
-
|
13
|
-
Data bags are available to all nodes configured by __chef-client__(8),
|
14
|
-
and are therefore a convenient mechanism to store global information,
|
15
|
-
such as lists of administrative accounts that should be configured on
|
16
|
-
all hosts.
|
17
|
-
|
18
|
-
## DATA BAG SUB-COMMANDS
|
19
|
-
|
20
|
-
## CREATE
|
21
|
-
__knife data bag create__ _bag name_ [item id] _(options)_
|
22
|
-
|
23
|
-
* `-s`, `--secret SECRET`:
|
24
|
-
A secret key used to encrypt the data bag item. See __encryption support__ below.
|
25
|
-
* `--secret-file SECRET_FILE`:
|
26
|
-
The path to a file containing the secret key to be used to encrypt
|
27
|
-
the data bag item.
|
28
|
-
|
29
|
-
If _item id_ is given, creates a new, empty data bag item and opens it for
|
30
|
-
editing in your editor. The data bag will be created if it does not
|
31
|
-
exist.
|
32
|
-
|
33
|
-
If _item id_ is not given, the data bag will be created.
|
34
|
-
|
35
|
-
## DELETE
|
36
|
-
__knife data bag delete__ _bag name_ [item id] _(options)_
|
37
|
-
|
38
|
-
Delete a data bag, or an item from a data bag.
|
39
|
-
|
40
|
-
## EDIT
|
41
|
-
__knife data bag edit__ _bag name_ _item id_ _(options)_
|
42
|
-
|
43
|
-
* `-s`, `--secret SECRET`:
|
44
|
-
A secret key used to encrypt the data bag item. See __encryption support__ below.
|
45
|
-
* `--secret-file SECRET_FILE`:
|
46
|
-
The path to a file containing the secret key to be used to encrypt
|
47
|
-
the data bag item.
|
48
|
-
|
49
|
-
Edit an item in a data bag.
|
50
|
-
|
51
|
-
## FROM FILE
|
52
|
-
__knife data bag from file__ _bag name_ _file_ _(options)_
|
53
|
-
|
54
|
-
__knife data bag from file__ _bag name_ _file1_ _file2_ _file3_ _(options)_
|
55
|
-
|
56
|
-
__knife data bag from file__ _bag name_ _folder_ _(options)_
|
57
|
-
|
58
|
-
* `-s`, `--secret SECRET`:
|
59
|
-
A secret key used to encrypt the data bag item. See __encryption support__ below.
|
60
|
-
* `--secret-file SECRET_FILE`:
|
61
|
-
The path to a file containing the secret key to be used to encrypt
|
62
|
-
the data bag item.
|
63
|
-
|
64
|
-
Load a data bag item from a JSON file. If _file_ is a relative or
|
65
|
-
absolute path to the file, that file will be used. Otherwise, the _file_
|
66
|
-
parameter is treated as the base name of a data bag file in a Chef
|
67
|
-
repository, and `knife` will search for the file in
|
68
|
-
`./data_bags/bag_name/file`. For example `knife data bag from file users
|
69
|
-
dan.json` would attempt to load the file `./data_bags/users/dan.json`.
|
70
|
-
|
71
|
-
## LIST
|
72
|
-
__knife data bag list__ _(options)_
|
73
|
-
|
74
|
-
* `-w`, `--with-uri`:
|
75
|
-
Show corresponding URIs
|
76
|
-
|
77
|
-
Lists the data bags that exist on the Chef Server.
|
78
|
-
|
79
|
-
## SHOW
|
80
|
-
__knife data bag show BAG [ITEM]__ _(options)_
|
81
|
-
|
82
|
-
* `-s`, `--secret SECRET`:
|
83
|
-
A secret key used to encrypt the data bag item. See __encryption support__ below.
|
84
|
-
* `--secret-file SECRET_FILE`:
|
85
|
-
The path to a file containing the secret key to be used to encrypt
|
86
|
-
the data bag item.
|
87
|
-
|
88
|
-
Show a specific data bag or an item in a data bag. The output will be
|
89
|
-
formatted according to the --format option.
|
90
|
-
|
91
|
-
## ENCRYPTION SUPPORT
|
92
|
-
Data Bag Items may be encrypted to keep their contents secret. This may
|
93
|
-
be desirable when storing sensitive information such as database
|
94
|
-
passwords, API keys, etc.
|
95
|
-
|
96
|
-
Data Bag Item encryption uses the AES-256 CBC symmetric key algorithm.
|
97
|
-
|
98
|
-
__CAVEATS:__ Keys are not encrypted; only values are encrypted. The "id"
|
99
|
-
of a Data Bag Item is not encrypted, since it is used by Chef Server to
|
100
|
-
store the item in its database. For example, given the following data bag item:
|
101
|
-
{"id": "important_passwords", "secret_password": "opensesame"}
|
102
|
-
The key "secret\_password" will be visible to an evesdropper, but the
|
103
|
-
value "opensesame" will be protected. Both the key "id" and its value
|
104
|
-
"important\_passwords" will be visible to an evesdropper.
|
105
|
-
|
106
|
-
Chef Server does not provide a secure mechanism for distributing
|
107
|
-
encryption keys.
|
108
|
-
|
109
|
-
## SEE ALSO
|
110
|
-
__knife-search__(1)
|
111
|
-
|
112
|
-
## AUTHOR
|
113
|
-
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
114
|
-
|
115
|
-
## DOCUMENTATION
|
116
|
-
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
117
|
-
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
118
|
-
|
119
|
-
## CHEF
|
120
|
-
Knife is distributed with Chef. http://docs.chef.io/
|
121
|
-
|
@@ -1,151 +0,0 @@
|
|
1
|
-
knife-environment(1) -- Define cookbook policies for the environments in your infrastructure
|
2
|
-
========================================
|
3
|
-
|
4
|
-
## SYNOPSIS
|
5
|
-
|
6
|
-
__knife__ __environment__ _sub-command_ _(options)_
|
7
|
-
|
8
|
-
## SUBCOMMANDS
|
9
|
-
Environment subcommands follow a basic create, read, update, delete
|
10
|
-
(CRUD) pattern. The following subcommands are available:
|
11
|
-
|
12
|
-
## CREATE
|
13
|
-
__knife environment create__ _environment_ _(options)_
|
14
|
-
|
15
|
-
* `-d`, `--description DESCRIPTION`:
|
16
|
-
The value of the description field.
|
17
|
-
|
18
|
-
Create a new environment object on the Chef Server. The envrionment will
|
19
|
-
be opened in the text editor for editing prior to creation if the -n
|
20
|
-
option is not present.
|
21
|
-
|
22
|
-
## DELETE
|
23
|
-
__knife environment delete__ _environment_ _(options)_
|
24
|
-
|
25
|
-
Destroy an environment on the Chef Server. A prompt for confirmation
|
26
|
-
will be displayed if the -y options is not given.
|
27
|
-
|
28
|
-
## EDIT
|
29
|
-
__knife environment edit__ _environment_ _(options)_
|
30
|
-
|
31
|
-
Fetch _environment_ and display it in the text editor for editing. The
|
32
|
-
environment will be saved to the Chef Server when the editing session
|
33
|
-
exits.
|
34
|
-
|
35
|
-
## FROM FILE
|
36
|
-
__knife environment from file__ _file_ _(options)_
|
37
|
-
|
38
|
-
Create or update an environment from the JSON or Ruby format _file_. See
|
39
|
-
__format__ for the proper format of this file.
|
40
|
-
|
41
|
-
## LIST
|
42
|
-
__knife environment list__ _(options)_
|
43
|
-
* `-w`, `--with-uri`:
|
44
|
-
Show the resource URI for each environment
|
45
|
-
|
46
|
-
## SHOW
|
47
|
-
__knife environment show__ _environment_ _(options)_
|
48
|
-
|
49
|
-
## DESCRIPTION
|
50
|
-
Environments provide a means to apply policies to hosts in your
|
51
|
-
infrastructure based on business function. For example, you may have a
|
52
|
-
separate copy of your infrastructure called "dev" that runs the latest
|
53
|
-
version of your application and should use the newest versions of your
|
54
|
-
cookbooks when configuring systems, and a production instance of your
|
55
|
-
infrastructure where you wish to update code and cookbooks in a more
|
56
|
-
controlled fashion. In Chef, this function is implemented with
|
57
|
-
_environments_.
|
58
|
-
|
59
|
-
Environments contain two major components: a set of cookbook version
|
60
|
-
constraints and environment attributes.
|
61
|
-
|
62
|
-
## SYNTAX
|
63
|
-
A cookbook version constraint is comprised of a _cookbook name_ and a
|
64
|
-
_version constraint_. The _cookbook name_ is the name of a cookbook in
|
65
|
-
your system, and the _version constraint_ is a String describing the
|
66
|
-
version(s) of that cookbook allowed in the environment. Only one
|
67
|
-
_version constraint_ is supported for a given _cookbook name_.
|
68
|
-
|
69
|
-
The exact syntax used to define a cookbook version constraint varies
|
70
|
-
depending on whether you use the JSON format or the Ruby format. In the
|
71
|
-
JSON format, the cookbook version constraints for an environment are
|
72
|
-
represented as a single JSON object, like this:
|
73
|
-
|
74
|
-
{"apache2": ">= 1.5.0"}
|
75
|
-
|
76
|
-
In the Ruby format, the cookbook version constraints for an environment
|
77
|
-
are represented as a Ruby Hash, like this:
|
78
|
-
|
79
|
-
{"apache2" => ">= 1.5.0"}
|
80
|
-
|
81
|
-
A _version number_ is a String comprised of two or three digits
|
82
|
-
separated by a dot (.) character, or in other words, strings of the form
|
83
|
-
"major.minor" or "major.minor.patch". "1.2" and "1.2.3" are examples of
|
84
|
-
valid version numbers. Version numbers containing more than three digits
|
85
|
-
or alphabetic characters are not supported.
|
86
|
-
|
87
|
-
A _version constraint_ String is composed of an _operator_ and a
|
88
|
-
_version number_. The following operators are available:
|
89
|
-
|
90
|
-
* `= VERSION`:
|
91
|
-
Equality. Only the exact version specified may be used.
|
92
|
-
* `> VERSION`:
|
93
|
-
Greater than. Only versions greater than `VERSION` may be used.
|
94
|
-
* `>= VERSION`:
|
95
|
-
Greater than or equal to. Only versions equal to VERSION or greater
|
96
|
-
may be used.
|
97
|
-
* `< VERSION`:
|
98
|
-
Less than. Only versions less than VERSION may be used.
|
99
|
-
* `<= VERSION`:
|
100
|
-
Less than or equal to. Only versions lesser or equal to VERSION may
|
101
|
-
be used.
|
102
|
-
* `~> VERSION`:
|
103
|
-
Pessimistic greater than. Depending on the number of components in
|
104
|
-
the given VERSION, the constraint will be optimistic about future
|
105
|
-
minor or patch revisions only. For example, `~> 1.1` will match any
|
106
|
-
version less than `2.0` and greater than or equal to `1.1.0`,
|
107
|
-
whereas `~> 2.0.5` will match any version less than `2.1.0` and
|
108
|
-
greater than or equal to `2.0.5`.
|
109
|
-
|
110
|
-
## FORMAT
|
111
|
-
The JSON format of an envioronment is as follows:
|
112
|
-
|
113
|
-
{
|
114
|
-
"name": "dev",
|
115
|
-
"description": "The development environment",
|
116
|
-
"cookbook_versions": {
|
117
|
-
"couchdb": "= 11.0.0"
|
118
|
-
},
|
119
|
-
"json_class": "Chef::Environment",
|
120
|
-
"chef_type": "environment",
|
121
|
-
"default_attributes": {
|
122
|
-
"apache2": { "listen_ports": [ "80", "443" ] }
|
123
|
-
},
|
124
|
-
"override_attributes": {
|
125
|
-
"aws_s3_bucket": "production"
|
126
|
-
}
|
127
|
-
}
|
128
|
-
|
129
|
-
The Ruby format of an environment is as follows:
|
130
|
-
|
131
|
-
name "dev"
|
132
|
-
description "The development environment"
|
133
|
-
cookbook_versions "couchdb" => "= 11.0.0"
|
134
|
-
default_attributes "apache2" => { "listen_ports" => [ "80", "443" ] }
|
135
|
-
override_attributes "aws_s3_bucket" => "production"
|
136
|
-
|
137
|
-
|
138
|
-
## SEE ALSO
|
139
|
-
__knife-node(1)__ __knife-cookbook(1)__ __knife-role(1)__
|
140
|
-
<http://docs.chef.io/environments.html>
|
141
|
-
<http://docs.chef.io/cookbook_versions.html>
|
142
|
-
|
143
|
-
## AUTHOR
|
144
|
-
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
145
|
-
|
146
|
-
## DOCUMENTATION
|
147
|
-
This manual page was written by Daniel DeLeo <dan@opscode.com>.
|
148
|
-
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
149
|
-
|
150
|
-
## CHEF
|
151
|
-
Knife is distributed with Chef. <http://docs.chef.io>
|
@@ -1,42 +0,0 @@
|
|
1
|
-
knife-exec(1) -- Run user scripts using the Chef API DSL
|
2
|
-
========================================
|
3
|
-
|
4
|
-
## SYNOPSIS
|
5
|
-
|
6
|
-
__knife__ __exec__ _(options)_
|
7
|
-
|
8
|
-
* `-E`, `--exec CODE`:
|
9
|
-
Provide a snippet of code to evaluate on the command line
|
10
|
-
|
11
|
-
## DESCRIPTION
|
12
|
-
|
13
|
-
`knife exec` runs arbitrary ruby scripts in a context similar to that
|
14
|
-
of the chef-shell(1) DSL. See the chef-shell documentation for a
|
15
|
-
description of the commands available.
|
16
|
-
|
17
|
-
## EXAMPLES
|
18
|
-
|
19
|
-
* Make an API call against an arbitrary endpoint:
|
20
|
-
knife exec -E 'api.get("nodes/fluke.localdomain/cookbooks")'
|
21
|
-
=> list of cookbooks for the node _fluke.localdomain_
|
22
|
-
* Remove the role _obsolete_ from all nodes:
|
23
|
-
knife exec -E 'nodes.transform(:all){|n| n.run\_list.delete("role[obsolete]")}'
|
24
|
-
* Generate the expanded run list for hosts in the `webserver` role:
|
25
|
-
knife exec -E 'nodes.find(:roles => "webserver") {|n| n.expand!; n[:recipes]}'
|
26
|
-
|
27
|
-
## SEE ALSO
|
28
|
-
|
29
|
-
__chef-shell(1)__
|
30
|
-
|
31
|
-
## AUTHOR
|
32
|
-
|
33
|
-
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
34
|
-
|
35
|
-
## DOCUMENTATION
|
36
|
-
|
37
|
-
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
38
|
-
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
39
|
-
|
40
|
-
## CHEF
|
41
|
-
|
42
|
-
Knife is distributed with Chef. <http://docs.chef.io>
|
@@ -1,30 +0,0 @@
|
|
1
|
-
knife-index(1) -- Rebuild the search index on a Chef Server
|
2
|
-
========================================
|
3
|
-
|
4
|
-
## SYNOPSIS
|
5
|
-
|
6
|
-
__knife__ __index rebuild__ _(options)_
|
7
|
-
|
8
|
-
* `-y`, `--yes`:
|
9
|
-
don't bother to ask if I'm sure
|
10
|
-
|
11
|
-
## DESCRIPTION
|
12
|
-
Rebuilds all the search indexes on the server. This is accomplished by
|
13
|
-
deleting all objects from the search index, and then forwarding each
|
14
|
-
item in the database to __chef-expander__(8) via __rabbitmq-server__(1).
|
15
|
-
Depending on the number of objects in the database, it may take some
|
16
|
-
time for all objects to be indexed and available for search.
|
17
|
-
|
18
|
-
## SEE ALSO
|
19
|
-
__knife-search__(1)
|
20
|
-
|
21
|
-
## AUTHOR
|
22
|
-
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
23
|
-
|
24
|
-
## DOCUMENTATION
|
25
|
-
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
26
|
-
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
27
|
-
|
28
|
-
## CHEF
|
29
|
-
Knife is distributed with Chef. <http://docs.chef.io>
|
30
|
-
|
@@ -1,130 +0,0 @@
|
|
1
|
-
knife-node(1) -- Manage the hosts in your infrastructure
|
2
|
-
========================================
|
3
|
-
|
4
|
-
## SYNOPSIS
|
5
|
-
|
6
|
-
__knife__ __node__ _sub-command_ _(options)_
|
7
|
-
|
8
|
-
## DESCRIPTION
|
9
|
-
Nodes are data structures that represent hosts configured with Chef.
|
10
|
-
Nodes have a __name__, a String that uniquely identifies the node,
|
11
|
-
__attributes__, a nested Hash of properties that describe how the host
|
12
|
-
should be configured, a __chef\_environment__, a String representing the
|
13
|
-
environment to which the node belongs, and a __run\_list__, an ordered
|
14
|
-
list of __recipes__ or __roles__ that chef-client should apply when
|
15
|
-
configuring a host.
|
16
|
-
|
17
|
-
When a host communicates with a Chef Server, it authenticates using its
|
18
|
-
__node\_name__ for identification and signs its reqests with a private
|
19
|
-
key. The Server validates the request by looking up a __client__ object
|
20
|
-
with a name identical to the __node\_name__ submitted with the request
|
21
|
-
and verifes the signature using the public key for that __client__
|
22
|
-
object. __NOTE__ that the __client__ is a different object in the
|
23
|
-
system. It is associated with a node by virtue of having a matching
|
24
|
-
name.
|
25
|
-
|
26
|
-
By default __chef-client__(8) will create a node using the FQDN of the
|
27
|
-
host for the node name, though this may be overridden by configuration
|
28
|
-
settings.
|
29
|
-
|
30
|
-
## NODE SUB-COMMANDS
|
31
|
-
The following `node` subcommands are available:
|
32
|
-
|
33
|
-
## BULK DELETE
|
34
|
-
__knife node bulk delete__ _regex_ _(options)_
|
35
|
-
|
36
|
-
Deletes nodes for which the name matches the regular expression _regex_
|
37
|
-
on the Chef Server. The regular expression should be given in quotes,
|
38
|
-
and should not be surrounded with forward slashes (as is typical of
|
39
|
-
regular expression literals in scripting languages).
|
40
|
-
|
41
|
-
## CREATE
|
42
|
-
__knife node create__ _name_ _(options)_
|
43
|
-
|
44
|
-
Create a new node. Unless the --disable-editing option is given, an empty node
|
45
|
-
object will be created and displayed in your text editor. If the editor
|
46
|
-
exits with a successful exit status, the node data will be posted to the
|
47
|
-
Chef Server to create the node.
|
48
|
-
|
49
|
-
## DELETE
|
50
|
-
__knife node delete__ _name_ _(options)_
|
51
|
-
|
52
|
-
Deletes the node identified by _name_ on the Chef Server.
|
53
|
-
|
54
|
-
## EDIT
|
55
|
-
__knife node edit__ _name_ _(options)_
|
56
|
-
|
57
|
-
* `-a`, `--all`:
|
58
|
-
Display all node data in the editor. By default, default, override,
|
59
|
-
and automatic attributes are not shown.
|
60
|
-
|
61
|
-
Edit the node identified by _name_. Like __knife node create__, the node
|
62
|
-
will be displayed in your text editor unless the -n option is present.
|
63
|
-
|
64
|
-
## FROM FILE
|
65
|
-
__knife node from file__ _file_ _(options)_
|
66
|
-
|
67
|
-
Create a node from a JSON format _file_.
|
68
|
-
|
69
|
-
## LIST
|
70
|
-
__knife node list__ _(options)_
|
71
|
-
|
72
|
-
* `-w`, `--with-uri`:
|
73
|
-
Show corresponding URIs
|
74
|
-
|
75
|
-
List all nodes.
|
76
|
-
|
77
|
-
## RUN\_LIST ADD
|
78
|
-
__knife node run_list add__ _name_ _run list item_ _(options)_
|
79
|
-
|
80
|
-
* `-a`, `--after ITEM`:
|
81
|
-
Place the ENTRY in the run list after ITEM
|
82
|
-
|
83
|
-
Add the _run list item_ to the node's `run_list`. See Run list
|
84
|
-
|
85
|
-
## RUN\_LIST REMOVE
|
86
|
-
__knife node run_list remove__ _node name_ _run list item_ _(options)_
|
87
|
-
|
88
|
-
Remove the _run list item_ from the node's `run_list`.
|
89
|
-
|
90
|
-
## SHOW
|
91
|
-
__knife node show__ _node name_ _(options)_
|
92
|
-
|
93
|
-
* `-a`, `--attribute [ATTR]`:
|
94
|
-
Show only one attribute
|
95
|
-
* `-r`, `--run-list `:
|
96
|
-
Show only the run list
|
97
|
-
* `-F`, `--format FORMAT`:
|
98
|
-
Display the node in a different format.
|
99
|
-
* `-m`, `--medium`:
|
100
|
-
Display more, but not all, of the node's data when using the default
|
101
|
-
_summary_ format
|
102
|
-
|
103
|
-
Displays the node identified by _node name_ on stdout.
|
104
|
-
|
105
|
-
## RUN LIST ITEM FORMAT
|
106
|
-
Run list items may be either roles or recipes. When adding a role to a
|
107
|
-
run list, the correct syntax is "role[ROLE\_NAME]"
|
108
|
-
|
109
|
-
When adding a recipe to a run list, there are several valid formats:
|
110
|
-
|
111
|
-
* Fully Qualified Format:
|
112
|
-
"recipe[COOKBOOK::RECIPE\_NAME]", for example, "recipe[chef::client]"
|
113
|
-
* Cookbook Recipe Format:
|
114
|
-
For brevity, the recipe part of the fully qualified format may be omitted, and recipes specified as "COOKBOOK::RECIPE\_NAME", e.g., "chef::client"
|
115
|
-
* Default Recipe Format:
|
116
|
-
When adding the default recipe of a cookbook to a run list, the recipe name may be omitted as well, e.g., "chef::default" may be written as just "chef"
|
117
|
-
|
118
|
-
## SEE ALSO
|
119
|
-
__knife-client__(1) __knife-search__(1) __knife-role__(1)
|
120
|
-
|
121
|
-
## AUTHOR
|
122
|
-
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
123
|
-
|
124
|
-
## DOCUMENTATION
|
125
|
-
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
126
|
-
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
127
|
-
|
128
|
-
## CHEF
|
129
|
-
Knife is distributed with Chef. <http://docs.chef.io>
|
130
|
-
|