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,161 +0,0 @@
|
|
1
|
-
.\" Man page generated from reStructuredText.
|
2
|
-
.
|
3
|
-
.TH "KNIFE-CONFIGURE" "1" "Chef 12.0" "" "knife configure"
|
4
|
-
.SH NAME
|
5
|
-
knife-configure \- The man page for the knife configure subcommand.
|
6
|
-
.
|
7
|
-
.nr rst2man-indent-level 0
|
8
|
-
.
|
9
|
-
.de1 rstReportMargin
|
10
|
-
\\$1 \\n[an-margin]
|
11
|
-
level \\n[rst2man-indent-level]
|
12
|
-
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
13
|
-
-
|
14
|
-
\\n[rst2man-indent0]
|
15
|
-
\\n[rst2man-indent1]
|
16
|
-
\\n[rst2man-indent2]
|
17
|
-
..
|
18
|
-
.de1 INDENT
|
19
|
-
.\" .rstReportMargin pre:
|
20
|
-
. RS \\$1
|
21
|
-
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
22
|
-
. nr rst2man-indent-level +1
|
23
|
-
.\" .rstReportMargin post:
|
24
|
-
..
|
25
|
-
.de UNINDENT
|
26
|
-
. RE
|
27
|
-
.\" indent \\n[an-margin]
|
28
|
-
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
29
|
-
.nr rst2man-indent-level -1
|
30
|
-
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
31
|
-
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
32
|
-
..
|
33
|
-
.sp
|
34
|
-
The \fBknife configure\fP subcommand is used to create the knife.rb and client.rb files so that they can be distributed to workstations and nodes.
|
35
|
-
.sp
|
36
|
-
\fBSyntax\fP
|
37
|
-
.sp
|
38
|
-
This subcommand has the following syntax when creating a knife.rb file:
|
39
|
-
.INDENT 0.0
|
40
|
-
.INDENT 3.5
|
41
|
-
.sp
|
42
|
-
.nf
|
43
|
-
.ft C
|
44
|
-
$ knife configure (options)
|
45
|
-
.ft P
|
46
|
-
.fi
|
47
|
-
.UNINDENT
|
48
|
-
.UNINDENT
|
49
|
-
.sp
|
50
|
-
and the following syntax when creating a client.rb file:
|
51
|
-
.INDENT 0.0
|
52
|
-
.INDENT 3.5
|
53
|
-
.sp
|
54
|
-
.nf
|
55
|
-
.ft C
|
56
|
-
$ knife configure client DIRECTORY
|
57
|
-
.ft P
|
58
|
-
.fi
|
59
|
-
.UNINDENT
|
60
|
-
.UNINDENT
|
61
|
-
.sp
|
62
|
-
\fBOptions\fP
|
63
|
-
.sp
|
64
|
-
This subcommand has the following options:
|
65
|
-
.INDENT 0.0
|
66
|
-
.TP
|
67
|
-
.B \fB\-\-admin\-client\-key PATH\fP
|
68
|
-
The path to the private key used by the client, typically a file named \fBadmin.pem\fP\&.
|
69
|
-
.TP
|
70
|
-
.B \fB\-\-admin\-client\-name NAME\fP
|
71
|
-
The name of the client, typically the name of the admin client.
|
72
|
-
.TP
|
73
|
-
.B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
|
74
|
-
The configuration file to use.
|
75
|
-
.TP
|
76
|
-
.B \fB\-\-chef\-zero\-port PORT\fP
|
77
|
-
The port on which chef\-zero will listen.
|
78
|
-
.TP
|
79
|
-
.B \fB\-\-[no\-]color\fP
|
80
|
-
Use to view colored output.
|
81
|
-
.TP
|
82
|
-
.B \fB\-d\fP, \fB\-\-disable\-editing\fP
|
83
|
-
Use to prevent the $EDITOR from being opened and to accept data as\-is.
|
84
|
-
.TP
|
85
|
-
.B \fB\-\-defaults\fP
|
86
|
-
Use to have knife use the default value instead of asking a user to provide one.
|
87
|
-
.TP
|
88
|
-
.B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
|
89
|
-
The $EDITOR that is used for all interactive commands.
|
90
|
-
.TP
|
91
|
-
.B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
|
92
|
-
The name of the environment. When this option is added to a command, the command will run only against the named environment.
|
93
|
-
.TP
|
94
|
-
.B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
|
95
|
-
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
|
96
|
-
.TP
|
97
|
-
.B \fB\-h\fP, \fB\-\-help\fP
|
98
|
-
Shows help for the command.
|
99
|
-
.TP
|
100
|
-
.B \fB\-i\fP, \fB\-\-initial\fP
|
101
|
-
Use to create a API client, typically an administrator client on a freshly\-installed Chef server\&.
|
102
|
-
.TP
|
103
|
-
.B \fB\-k KEY\fP, \fB\-\-key KEY\fP
|
104
|
-
The private key that knife will use to sign requests made by the API client to the Chef server\&.
|
105
|
-
.TP
|
106
|
-
.B \fB\-\-print\-after\fP
|
107
|
-
Use to show data after a destructive operation.
|
108
|
-
.TP
|
109
|
-
.B \fB\-r REPO\fP, \fB\-\-repository REPO\fP
|
110
|
-
The path to the chef\-repo\&.
|
111
|
-
.TP
|
112
|
-
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
113
|
-
The URL for the Chef server\&.
|
114
|
-
.TP
|
115
|
-
.B \fB\-u USER\fP, \fB\-\-user USER\fP
|
116
|
-
The user name used by knife to sign requests made by the API client to the Chef server\&. Authentication will fail if the user name does not match the private key.
|
117
|
-
.TP
|
118
|
-
.B \fB\-v\fP, \fB\-\-version\fP
|
119
|
-
The version of the chef\-client\&.
|
120
|
-
.TP
|
121
|
-
.B \fB\-V\fP, \fB\-\-verbose\fP
|
122
|
-
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
123
|
-
.TP
|
124
|
-
.B \fB\-\-validation\-client\-name NAME\fP
|
125
|
-
The name of the validation client.
|
126
|
-
.TP
|
127
|
-
.B \fB\-\-validation\-key PATH\fP
|
128
|
-
The path to the validation key used by the client, typically a file named \fBvalidation.pem\fP\&.
|
129
|
-
.TP
|
130
|
-
.B \fB\-y\fP, \fB\-\-yes\fP
|
131
|
-
Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
|
132
|
-
.TP
|
133
|
-
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
134
|
-
Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
|
135
|
-
.UNINDENT
|
136
|
-
.sp
|
137
|
-
\fBExamples\fP
|
138
|
-
.INDENT 0.0
|
139
|
-
.INDENT 3.5
|
140
|
-
.sp
|
141
|
-
.nf
|
142
|
-
.ft C
|
143
|
-
$ knife configure
|
144
|
-
.ft P
|
145
|
-
.fi
|
146
|
-
.UNINDENT
|
147
|
-
.UNINDENT
|
148
|
-
.INDENT 0.0
|
149
|
-
.INDENT 3.5
|
150
|
-
.sp
|
151
|
-
.nf
|
152
|
-
.ft C
|
153
|
-
$ knife configure client \(aq/directory\(aq
|
154
|
-
.ft P
|
155
|
-
.fi
|
156
|
-
.UNINDENT
|
157
|
-
.UNINDENT
|
158
|
-
.SH AUTHOR
|
159
|
-
Chef
|
160
|
-
.\" Generated by docutils manpage writer.
|
161
|
-
.
|
@@ -1,552 +0,0 @@
|
|
1
|
-
.\" Man page generated from reStructuredText.
|
2
|
-
.
|
3
|
-
.TH "KNIFE-COOKBOOK-SITE" "1" "Chef 12.0" "" "knife cookbook site"
|
4
|
-
.SH NAME
|
5
|
-
knife-cookbook-site \- The man page for the knife cookbook site subcommand.
|
6
|
-
.
|
7
|
-
.nr rst2man-indent-level 0
|
8
|
-
.
|
9
|
-
.de1 rstReportMargin
|
10
|
-
\\$1 \\n[an-margin]
|
11
|
-
level \\n[rst2man-indent-level]
|
12
|
-
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
13
|
-
-
|
14
|
-
\\n[rst2man-indent0]
|
15
|
-
\\n[rst2man-indent1]
|
16
|
-
\\n[rst2man-indent2]
|
17
|
-
..
|
18
|
-
.de1 INDENT
|
19
|
-
.\" .rstReportMargin pre:
|
20
|
-
. RS \\$1
|
21
|
-
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
22
|
-
. nr rst2man-indent-level +1
|
23
|
-
.\" .rstReportMargin post:
|
24
|
-
..
|
25
|
-
.de UNINDENT
|
26
|
-
. RE
|
27
|
-
.\" indent \\n[an-margin]
|
28
|
-
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
29
|
-
.nr rst2man-indent-level -1
|
30
|
-
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
31
|
-
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
32
|
-
..
|
33
|
-
.sp
|
34
|
-
The Cookbooks Site API is used to provide access to the cookbooks community hosted at \fI\%https://supermarket.getchef.com/cookbooks\fP\&. All of the cookbooks in the community are accessible through a RESTful API located at \fI\%https://supermarket.getchef.com/api/v1/cookbooks\fP by using any of the supported endpoints. In most cases, using knife and the \fBknife cookbook site\fP sub\-command (and any of its arguments) is the recommended method of interacting with these cookbooks, but in some cases, using the Cookbooks Site API directly may make sense.
|
35
|
-
.sp
|
36
|
-
The \fBknife cookbook site\fP subcommand is used to interact with cookbooks that are located at \fI\%https://supermarket.getchef.com/cookbooks\fP\&. A user account is required for any community actions that write data to this site. The following arguments do not require a user account: \fBdownload\fP, \fBsearch\fP, \fBinstall\fP, and \fBlist\fP\&.
|
37
|
-
.SH COMMON OPTIONS
|
38
|
-
.sp
|
39
|
-
The following options may be used with any of the arguments available to the \fBknife cookbook site\fP subcommand:
|
40
|
-
.INDENT 0.0
|
41
|
-
.TP
|
42
|
-
.B \fB\-\-chef\-zero\-port PORT\fP
|
43
|
-
The port on which chef\-zero will listen.
|
44
|
-
.TP
|
45
|
-
.B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
|
46
|
-
The configuration file to use.
|
47
|
-
.TP
|
48
|
-
.B \fB\-d\fP, \fB\-\-disable\-editing\fP
|
49
|
-
Use to prevent the $EDITOR from being opened and to accept data as\-is.
|
50
|
-
.TP
|
51
|
-
.B \fB\-\-defaults\fP
|
52
|
-
Use to have knife use the default value instead of asking a user to provide one.
|
53
|
-
.TP
|
54
|
-
.B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
|
55
|
-
The $EDITOR that is used for all interactive commands.
|
56
|
-
.TP
|
57
|
-
.B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
|
58
|
-
The name of the environment. When this option is added to a command, the command will run only against the named environment.
|
59
|
-
.TP
|
60
|
-
.B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
|
61
|
-
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
|
62
|
-
.TP
|
63
|
-
.B \fB\-h\fP, \fB\-\-help\fP
|
64
|
-
Shows help for the command.
|
65
|
-
.TP
|
66
|
-
.B \fB\-k KEY\fP, \fB\-\-key KEY\fP
|
67
|
-
The private key that knife will use to sign requests made by the API client to the Chef server\&.
|
68
|
-
.TP
|
69
|
-
.B \fB\-\-[no\-]color\fP
|
70
|
-
Use to view colored output.
|
71
|
-
.TP
|
72
|
-
.B \fB\-\-print\-after\fP
|
73
|
-
Use to show data after a destructive operation.
|
74
|
-
.TP
|
75
|
-
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
76
|
-
The URL for the Chef server\&.
|
77
|
-
.TP
|
78
|
-
.B \fB\-u USER\fP, \fB\-\-user USER\fP
|
79
|
-
The user name used by knife to sign requests made by the API client to the Chef server\&. Authentication will fail if the user name does not match the private key.
|
80
|
-
.TP
|
81
|
-
.B \fB\-V\fP, \fB\-\-verbose\fP
|
82
|
-
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
83
|
-
.TP
|
84
|
-
.B \fB\-v\fP, \fB\-\-version\fP
|
85
|
-
The version of the chef\-client\&.
|
86
|
-
.TP
|
87
|
-
.B \fB\-y\fP, \fB\-\-yes\fP
|
88
|
-
Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
|
89
|
-
.TP
|
90
|
-
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
91
|
-
Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
|
92
|
-
.UNINDENT
|
93
|
-
.SH DOWNLOAD
|
94
|
-
.sp
|
95
|
-
The \fBdownload\fP argument is used to download a cookbook from the community website. A cookbook will be downloaded as a tar.gz archive and placed in the current working directory. If a cookbook (or cookbook version) has been deprecated and the \fB\-\-force\fP option is not used, knife will alert the user that the cookbook is deprecated and then will provide the name of the most recent non\-deprecated version of that cookbook.
|
96
|
-
.sp
|
97
|
-
\fBSyntax\fP
|
98
|
-
.sp
|
99
|
-
This argument has the following syntax:
|
100
|
-
.INDENT 0.0
|
101
|
-
.INDENT 3.5
|
102
|
-
.sp
|
103
|
-
.nf
|
104
|
-
.ft C
|
105
|
-
$ knife cookbook site download COOKBOOK_NAME [COOKBOOK_VERSION] (options)
|
106
|
-
.ft P
|
107
|
-
.fi
|
108
|
-
.UNINDENT
|
109
|
-
.UNINDENT
|
110
|
-
.sp
|
111
|
-
\fBOptions\fP
|
112
|
-
.sp
|
113
|
-
This argument has the following options:
|
114
|
-
.INDENT 0.0
|
115
|
-
.TP
|
116
|
-
.B \fBCOOKBOOK_VERSION\fP
|
117
|
-
The version of a cookbook to be downloaded. If a cookbook has only one version, this option does not need to be specified. If a cookbook has more than one version and this option is not specified, the most recent version of the cookbook will be downloaded.
|
118
|
-
.TP
|
119
|
-
.B \fB\-f FILE\fP, \fB\-\-file FILE\fP
|
120
|
-
The file to which a cookbook download is written.
|
121
|
-
.TP
|
122
|
-
.B \fB\-\-force\fP
|
123
|
-
Use to overwrite an existing directory.
|
124
|
-
.UNINDENT
|
125
|
-
.sp
|
126
|
-
\fBExamples\fP
|
127
|
-
.sp
|
128
|
-
To download the cookbook \fBgetting\-started\fP, enter:
|
129
|
-
.INDENT 0.0
|
130
|
-
.INDENT 3.5
|
131
|
-
.sp
|
132
|
-
.nf
|
133
|
-
.ft C
|
134
|
-
$ knife cookbook site download getting\-started
|
135
|
-
.ft P
|
136
|
-
.fi
|
137
|
-
.UNINDENT
|
138
|
-
.UNINDENT
|
139
|
-
.sp
|
140
|
-
to return something like:
|
141
|
-
.INDENT 0.0
|
142
|
-
.INDENT 3.5
|
143
|
-
.sp
|
144
|
-
.nf
|
145
|
-
.ft C
|
146
|
-
Downloading getting\-started from the cookbooks site at version 0.3.0 to
|
147
|
-
/Users/sdanna/opscodesupport/getting\-started\-0.3.0.tar.gz
|
148
|
-
Cookbook saved: /Users/sdanna/opscodesupport/getting\-started\-0.3.0.tar.gz
|
149
|
-
.ft P
|
150
|
-
.fi
|
151
|
-
.UNINDENT
|
152
|
-
.UNINDENT
|
153
|
-
.SH INSTALL
|
154
|
-
.sp
|
155
|
-
The \fBinstall\fP argument is used to install a cookbook that has been downloaded from the community site to a local git repository . This action uses the git version control system in conjunction with the \fI\%https://supermarket.getchef.com/cookbooks\fP site to install community\-contributed cookbooks to the local chef\-repo\&. Using this argument does the following:
|
156
|
-
.INDENT 0.0
|
157
|
-
.INDENT 3.5
|
158
|
-
.INDENT 0.0
|
159
|
-
.IP 1. 3
|
160
|
-
A new "pristine copy" branch is created in git for tracking the upstream.
|
161
|
-
.IP 2. 3
|
162
|
-
All existing versions of a cookbook are removed from the branch.
|
163
|
-
.IP 3. 3
|
164
|
-
The cookbook is downloaded from \fI\%https://supermarket.getchef.com/cookbooks\fP in the tar.gz format.
|
165
|
-
.IP 4. 3
|
166
|
-
The downloaded cookbook is untarred and its contents are committed to git and a tag is created.
|
167
|
-
.IP 5. 3
|
168
|
-
The "pristine copy" branch is merged into the master branch.
|
169
|
-
.UNINDENT
|
170
|
-
.UNINDENT
|
171
|
-
.UNINDENT
|
172
|
-
.sp
|
173
|
-
This process allows the upstream cookbook in the master branch to be modified while letting git maintain changes as a separate patch. When an updated upstream version becomes available, those changes can be merged while maintaining any local modifications.
|
174
|
-
.sp
|
175
|
-
\fBSyntax\fP
|
176
|
-
.sp
|
177
|
-
This argument has the following syntax:
|
178
|
-
.INDENT 0.0
|
179
|
-
.INDENT 3.5
|
180
|
-
.sp
|
181
|
-
.nf
|
182
|
-
.ft C
|
183
|
-
$ knife cookbook site install COOKBOOK_NAME [COOKBOOK_VERSION] (options)
|
184
|
-
.ft P
|
185
|
-
.fi
|
186
|
-
.UNINDENT
|
187
|
-
.UNINDENT
|
188
|
-
.sp
|
189
|
-
\fBOptions\fP
|
190
|
-
.sp
|
191
|
-
This argument has the following options:
|
192
|
-
.INDENT 0.0
|
193
|
-
.TP
|
194
|
-
.B \fB\-b\fP, \fB\-\-use\-current\-branch\fP
|
195
|
-
Use to ensure that the current branch is used.
|
196
|
-
.TP
|
197
|
-
.B \fB\-B BRANCH\fP, \fB\-\-branch BRANCH\fP
|
198
|
-
The name of the default branch. This will default to the master branch.
|
199
|
-
.TP
|
200
|
-
.B \fBCOOKBOOK_VERSION\fP
|
201
|
-
The version of the cookbook to be installed. If a version is not specified, the most recent version of the cookbook will be installed.
|
202
|
-
.TP
|
203
|
-
.B \fB\-D\fP, \fB\-\-skip\-dependencies\fP
|
204
|
-
Use to ensure that all cookbooks to which the installed cookbook has a dependency will not be installed.
|
205
|
-
.TP
|
206
|
-
.B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
|
207
|
-
The directory in which cookbooks are created. This can be a colon\-separated path.
|
208
|
-
.UNINDENT
|
209
|
-
.sp
|
210
|
-
\fBExamples\fP
|
211
|
-
.sp
|
212
|
-
To install the cookbook \fBgetting\-started\fP, enter:
|
213
|
-
.INDENT 0.0
|
214
|
-
.INDENT 3.5
|
215
|
-
.sp
|
216
|
-
.nf
|
217
|
-
.ft C
|
218
|
-
$ knife cookbook site install getting\-started
|
219
|
-
.ft P
|
220
|
-
.fi
|
221
|
-
.UNINDENT
|
222
|
-
.UNINDENT
|
223
|
-
.sp
|
224
|
-
to return something like:
|
225
|
-
.INDENT 0.0
|
226
|
-
.INDENT 3.5
|
227
|
-
.sp
|
228
|
-
.nf
|
229
|
-
.ft C
|
230
|
-
Installing getting\-started to /Users/sdanna/opscodesupport/.chef/../cookbooks
|
231
|
-
Checking out the master branch.
|
232
|
-
Creating pristine copy branch chef\-vendor\-getting\-started
|
233
|
-
Downloading getting\-started from the cookbooks site at version 0.3.0 to
|
234
|
-
/Users/sdanna/opscodesupport/.chef/../cookbooks/getting\-started.tar.gz
|
235
|
-
Cookbook saved: /Users/sdanna/opscodesupport/.chef/../cookbooks/getting\-started.tar.gz
|
236
|
-
Removing pre\-existing version.
|
237
|
-
Uncompressing getting\-started version /Users/sdanna/opscodesupport/.chef/../cookbooks.
|
238
|
-
removing downloaded tarball
|
239
|
-
1 files updated, committing changes
|
240
|
-
Creating tag cookbook\-site\-imported\-getting\-started\-0.3.0
|
241
|
-
Checking out the master branch.
|
242
|
-
Updating 4d44b5b..b4c32f2
|
243
|
-
Fast\-forward
|
244
|
-
cookbooks/getting\-started/README.rdoc | 4 +++
|
245
|
-
cookbooks/getting\-started/attributes/default.rb | 1 +
|
246
|
-
cookbooks/getting\-started/metadata.json | 29 ++++++++++++++++++++
|
247
|
-
cookbooks/getting\-started/metadata.rb | 6 ++++
|
248
|
-
cookbooks/getting\-started/recipes/default.rb | 23 +++++++++++++++
|
249
|
-
.../templates/default/chef\-getting\-started.txt.erb | 5 +++
|
250
|
-
6 files changed, 68 insertions(+), 0 deletions(\-)
|
251
|
-
create mode 100644 cookbooks/getting\-started/README.rdoc
|
252
|
-
create mode 100644 cookbooks/getting\-started/attributes/default.rb
|
253
|
-
create mode 100644 cookbooks/getting\-started/metadata.json
|
254
|
-
create mode 100644 cookbooks/getting\-started/metadata.rb
|
255
|
-
create mode 100644 cookbooks/getting\-started/recipes/default.rb
|
256
|
-
create mode 100644 cookbooks/getting\-started/templates/default/chef\-getting\-started.txt.erb
|
257
|
-
Cookbook getting\-started version 0.3.0 successfully installed
|
258
|
-
.ft P
|
259
|
-
.fi
|
260
|
-
.UNINDENT
|
261
|
-
.UNINDENT
|
262
|
-
.SH LIST
|
263
|
-
.sp
|
264
|
-
The \fBlist\fP argument is used to view a list of cookbooks that are currently available at \fI\%https://supermarket.getchef.com/cookbooks\fP\&.
|
265
|
-
.sp
|
266
|
-
\fBSyntax\fP
|
267
|
-
.sp
|
268
|
-
This argument has the following syntax:
|
269
|
-
.INDENT 0.0
|
270
|
-
.INDENT 3.5
|
271
|
-
.sp
|
272
|
-
.nf
|
273
|
-
.ft C
|
274
|
-
$ knife cookbook site list
|
275
|
-
.ft P
|
276
|
-
.fi
|
277
|
-
.UNINDENT
|
278
|
-
.UNINDENT
|
279
|
-
.sp
|
280
|
-
\fBOptions\fP
|
281
|
-
.sp
|
282
|
-
This argument has the following options:
|
283
|
-
.INDENT 0.0
|
284
|
-
.TP
|
285
|
-
.B \fB\-w\fP, \fB\-\-with\-uri\fP
|
286
|
-
Use to show the corresponding URIs.
|
287
|
-
.UNINDENT
|
288
|
-
.sp
|
289
|
-
\fBExamples\fP
|
290
|
-
.sp
|
291
|
-
To view a list of cookbooks at \fI\%https://supermarket.getchef.com/cookbooks\fP server, enter:
|
292
|
-
.INDENT 0.0
|
293
|
-
.INDENT 3.5
|
294
|
-
.sp
|
295
|
-
.nf
|
296
|
-
.ft C
|
297
|
-
$ knife cookbook site list
|
298
|
-
.ft P
|
299
|
-
.fi
|
300
|
-
.UNINDENT
|
301
|
-
.UNINDENT
|
302
|
-
.sp
|
303
|
-
to return:
|
304
|
-
.INDENT 0.0
|
305
|
-
.INDENT 3.5
|
306
|
-
.sp
|
307
|
-
.nf
|
308
|
-
.ft C
|
309
|
-
1password homesick rabbitmq
|
310
|
-
7\-zip hostname rabbitmq\-management
|
311
|
-
AmazonEC2Tag hosts rabbitmq_chef
|
312
|
-
R hosts\-awareness rackspaceknife
|
313
|
-
accounts htop radiant
|
314
|
-
ack\-grep hudson rails
|
315
|
-
activemq icinga rails_enterprise
|
316
|
-
ad id3lib redis\-package
|
317
|
-
ad\-likewise iftop redis2
|
318
|
-
ant iis redmine
|
319
|
-
[...truncated...]
|
320
|
-
.ft P
|
321
|
-
.fi
|
322
|
-
.UNINDENT
|
323
|
-
.UNINDENT
|
324
|
-
.SH SEARCH
|
325
|
-
.sp
|
326
|
-
The \fBsearch\fP argument is used to search for a cookbook at \fI\%https://supermarket.getchef.com/cookbooks\fP\&. A search query is used to return a list of cookbooks at \fI\%https://supermarket.getchef.com/cookbooks\fP and uses the same syntax as the \fBknife search\fP sub\-command.
|
327
|
-
.sp
|
328
|
-
\fBSyntax\fP
|
329
|
-
.sp
|
330
|
-
This argument has the following syntax:
|
331
|
-
.INDENT 0.0
|
332
|
-
.INDENT 3.5
|
333
|
-
.sp
|
334
|
-
.nf
|
335
|
-
.ft C
|
336
|
-
$ knife cookbook site search SEARCH_QUERY (options)
|
337
|
-
.ft P
|
338
|
-
.fi
|
339
|
-
.UNINDENT
|
340
|
-
.UNINDENT
|
341
|
-
.sp
|
342
|
-
\fBOptions\fP
|
343
|
-
.sp
|
344
|
-
This command does not have any specific options.
|
345
|
-
.sp
|
346
|
-
\fBExamples\fP
|
347
|
-
.sp
|
348
|
-
To search for all of the cookbooks that can be used with Apache, enter:
|
349
|
-
.INDENT 0.0
|
350
|
-
.INDENT 3.5
|
351
|
-
.sp
|
352
|
-
.nf
|
353
|
-
.ft C
|
354
|
-
$ knife cookbook site search apache*
|
355
|
-
.ft P
|
356
|
-
.fi
|
357
|
-
.UNINDENT
|
358
|
-
.UNINDENT
|
359
|
-
.sp
|
360
|
-
to return something like:
|
361
|
-
.INDENT 0.0
|
362
|
-
.INDENT 3.5
|
363
|
-
.sp
|
364
|
-
.nf
|
365
|
-
.ft C
|
366
|
-
apache2:
|
367
|
-
cookbook: https://supermarket.chef.io/api/v1/cookbooks/apache2
|
368
|
-
cookbook_description: Installs and configures apache2 using Debian symlinks with helper definitions
|
369
|
-
cookbook_maintainer: opscode
|
370
|
-
cookbook_name: apache2
|
371
|
-
instiki:
|
372
|
-
cookbook: https://supermarket.chef.io/api/v1/cookbooks/instiki
|
373
|
-
cookbook_description: Installs instiki, a Ruby on Rails wiki server under passenger+Apache2.
|
374
|
-
cookbook_maintainer: jtimberman
|
375
|
-
cookbook_name: instiki
|
376
|
-
kickstart:
|
377
|
-
cookbook: https://supermarket.chef.io/api/v1/cookbooks/kickstart
|
378
|
-
cookbook_description: Creates apache2 vhost and serves a kickstart file.
|
379
|
-
cookbook_maintainer: opscode
|
380
|
-
cookbook_name: kickstart
|
381
|
-
[...truncated...]
|
382
|
-
.ft P
|
383
|
-
.fi
|
384
|
-
.UNINDENT
|
385
|
-
.UNINDENT
|
386
|
-
.SH SHARE
|
387
|
-
.sp
|
388
|
-
The \fBshare\fP argument is used to add a cookbook to \fI\%https://supermarket.getchef.com/cookbooks\fP\&. This action will require a user account and a certificate for \fI\%https://supermarket.getchef.com\fP\&. By default, knife will use the user name and API key that is identified in the configuration file used during the upload; otherwise these values must be specified on the command line or in an alternate configuration file. If a cookbook already exists on \fI\%https://supermarket.getchef.com/cookbooks\fP, then only an owner or maintainer of that cookbook can make updates.
|
389
|
-
.sp
|
390
|
-
\fBSyntax\fP
|
391
|
-
.sp
|
392
|
-
This argument has the following syntax:
|
393
|
-
.INDENT 0.0
|
394
|
-
.INDENT 3.5
|
395
|
-
.sp
|
396
|
-
.nf
|
397
|
-
.ft C
|
398
|
-
$ knife cookbook site share COOKBOOK_NAME CATEGORY (options)
|
399
|
-
.ft P
|
400
|
-
.fi
|
401
|
-
.UNINDENT
|
402
|
-
.UNINDENT
|
403
|
-
.sp
|
404
|
-
\fBOptions\fP
|
405
|
-
.sp
|
406
|
-
This argument has the following options:
|
407
|
-
.INDENT 0.0
|
408
|
-
.TP
|
409
|
-
.B \fBCATEGORY\fP
|
410
|
-
The cookbook category: \fB"Databases"\fP, \fB"Web Servers"\fP, \fB"Process Management"\fP, \fB"Monitoring & Trending"\fP, \fB"Programming Languages"\fP, \fB"Package Management"\fP, \fB"Applications"\fP, \fB"Networking"\fP, \fB"Operating Systems & Virtualization"\fP, \fB"Utilities"\fP, or \fB"Other"\fP\&.
|
411
|
-
.TP
|
412
|
-
.B \fB\-n\fP, \fB\-\-dry\-run\fP
|
413
|
-
Use to take no action and only print out results. Default: \fBfalse\fP\&.
|
414
|
-
.TP
|
415
|
-
.B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
|
416
|
-
The directory in which cookbooks are created. This can be a colon\-separated path.
|
417
|
-
.UNINDENT
|
418
|
-
.sp
|
419
|
-
\fBExamples\fP
|
420
|
-
.sp
|
421
|
-
To share a cookbook named \fBapache2\fP:
|
422
|
-
.INDENT 0.0
|
423
|
-
.INDENT 3.5
|
424
|
-
.sp
|
425
|
-
.nf
|
426
|
-
.ft C
|
427
|
-
$ knife cookbook site share "apache2" "Web Servers"
|
428
|
-
.ft P
|
429
|
-
.fi
|
430
|
-
.UNINDENT
|
431
|
-
.UNINDENT
|
432
|
-
.SH SHOW
|
433
|
-
.sp
|
434
|
-
The \fBshow\fP argument is used to view information about a cookbook on \fI\%https://supermarket.getchef.com/cookbooks\fP\&.
|
435
|
-
.sp
|
436
|
-
\fBSyntax\fP
|
437
|
-
.sp
|
438
|
-
This argument has the following syntax:
|
439
|
-
.INDENT 0.0
|
440
|
-
.INDENT 3.5
|
441
|
-
.sp
|
442
|
-
.nf
|
443
|
-
.ft C
|
444
|
-
$ knife cookbook site show COOKBOOK_NAME [COOKBOOK_VERSION]
|
445
|
-
.ft P
|
446
|
-
.fi
|
447
|
-
.UNINDENT
|
448
|
-
.UNINDENT
|
449
|
-
.sp
|
450
|
-
\fBOptions\fP
|
451
|
-
.sp
|
452
|
-
This argument has the following options:
|
453
|
-
.INDENT 0.0
|
454
|
-
.TP
|
455
|
-
.B \fBCOOKBOOK_VERSION\fP
|
456
|
-
The version of a cookbook to be shown. If a cookbook has only one version, this option does not need to be specified. If a cookbook has more than one version and this option is not specified, a list of cookbook versions will be returned.
|
457
|
-
.UNINDENT
|
458
|
-
.sp
|
459
|
-
\fBExamples\fP
|
460
|
-
.sp
|
461
|
-
To show the details for a cookbook named \fBhaproxy\fP:
|
462
|
-
.INDENT 0.0
|
463
|
-
.INDENT 3.5
|
464
|
-
.sp
|
465
|
-
.nf
|
466
|
-
.ft C
|
467
|
-
$ knife cookbook site show haproxy
|
468
|
-
.ft P
|
469
|
-
.fi
|
470
|
-
.UNINDENT
|
471
|
-
.UNINDENT
|
472
|
-
.sp
|
473
|
-
to return something like:
|
474
|
-
.INDENT 0.0
|
475
|
-
.INDENT 3.5
|
476
|
-
.sp
|
477
|
-
.nf
|
478
|
-
.ft C
|
479
|
-
average_rating:
|
480
|
-
category: Networking
|
481
|
-
created_at: 2009\-10\-25T23:51:07Z
|
482
|
-
description: Installs and configures haproxy
|
483
|
-
external_url:
|
484
|
-
latest_version: https://supermarket.chef.io/api/v1/cookbooks/haproxy/versions/1_0_3
|
485
|
-
maintainer: opscode
|
486
|
-
name: haproxy
|
487
|
-
updated_at: 2011\-06\-30T21:53:25Z
|
488
|
-
versions:
|
489
|
-
https://supermarket.chef.io/api/v1/cookbooks/haproxy/versions/1_0_3
|
490
|
-
https://supermarket.chef.io/api/v1/cookbooks/haproxy/versions/1_0_2
|
491
|
-
https://supermarket.chef.io/api/v1/cookbooks/haproxy/versions/1_0_1
|
492
|
-
https://supermarket.chef.io/api/v1/cookbooks/haproxy/versions/1_0_0
|
493
|
-
https://supermarket.chef.io/api/v1/cookbooks/haproxy/versions/0_8_1
|
494
|
-
https://supermarket.chef.io/api/v1/cookbooks/haproxy/versions/0_8_0
|
495
|
-
https://supermarket.chef.io/api/v1/cookbooks/haproxy/versions/0_7_0
|
496
|
-
.ft P
|
497
|
-
.fi
|
498
|
-
.UNINDENT
|
499
|
-
.UNINDENT
|
500
|
-
.sp
|
501
|
-
To view information in JSON format, use the \fB\-F\fP common option as part of the command like this:
|
502
|
-
.INDENT 0.0
|
503
|
-
.INDENT 3.5
|
504
|
-
.sp
|
505
|
-
.nf
|
506
|
-
.ft C
|
507
|
-
$ knife role show devops \-F json
|
508
|
-
.ft P
|
509
|
-
.fi
|
510
|
-
.UNINDENT
|
511
|
-
.UNINDENT
|
512
|
-
.sp
|
513
|
-
Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP\&.
|
514
|
-
.SH UNSHARE
|
515
|
-
.sp
|
516
|
-
The \fBunshare\fP argument is used to stop the sharing of a cookbook at \fI\%https://supermarket.getchef.com/cookbooks\fP\&. Only the maintainer of a cookbook may perform this action.
|
517
|
-
.sp
|
518
|
-
\fBSyntax\fP
|
519
|
-
.sp
|
520
|
-
This argument has the following syntax:
|
521
|
-
.INDENT 0.0
|
522
|
-
.INDENT 3.5
|
523
|
-
.sp
|
524
|
-
.nf
|
525
|
-
.ft C
|
526
|
-
$ knife cookbook site unshare COOKBOOK_NAME
|
527
|
-
.ft P
|
528
|
-
.fi
|
529
|
-
.UNINDENT
|
530
|
-
.UNINDENT
|
531
|
-
.sp
|
532
|
-
\fBOptions\fP
|
533
|
-
.sp
|
534
|
-
This command does not have any specific options.
|
535
|
-
.sp
|
536
|
-
\fBExamples\fP
|
537
|
-
.sp
|
538
|
-
To unshare a cookbook named \fBgetting\-started\fP, enter:
|
539
|
-
.INDENT 0.0
|
540
|
-
.INDENT 3.5
|
541
|
-
.sp
|
542
|
-
.nf
|
543
|
-
.ft C
|
544
|
-
$ knife cookbook site unshare getting\-started
|
545
|
-
.ft P
|
546
|
-
.fi
|
547
|
-
.UNINDENT
|
548
|
-
.UNINDENT
|
549
|
-
.SH AUTHOR
|
550
|
-
Chef
|
551
|
-
.\" Generated by docutils manpage writer.
|
552
|
-
.
|