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,160 +0,0 @@
|
|
1
|
-
.\" Man page generated from reStructuredText.
|
2
|
-
.
|
3
|
-
.TH "KNIFE-SHOW" "1" "Chef 12.0" "" "knife show"
|
4
|
-
.SH NAME
|
5
|
-
knife-show \- The man page for the knife show 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 show\fP subcommand is used to view the details of one (or more) objects on the Chef server\&. This subcommand works similar to \fBknife cookbook show\fP, \fBknife data bag show\fP, \fBknife environment show\fP, \fBknife node show\fP, and \fBknife role show\fP, but with a single verb (and a single action).
|
35
|
-
.sp
|
36
|
-
\fBSyntax\fP
|
37
|
-
.sp
|
38
|
-
This subcommand has the following syntax:
|
39
|
-
.INDENT 0.0
|
40
|
-
.INDENT 3.5
|
41
|
-
.sp
|
42
|
-
.nf
|
43
|
-
.ft C
|
44
|
-
$ knife show [PATTERN...] (options)
|
45
|
-
.ft P
|
46
|
-
.fi
|
47
|
-
.UNINDENT
|
48
|
-
.UNINDENT
|
49
|
-
.sp
|
50
|
-
\fBOptions\fP
|
51
|
-
.sp
|
52
|
-
This subcommand has the following options:
|
53
|
-
.INDENT 0.0
|
54
|
-
.TP
|
55
|
-
.B \fB\-a ATTR\fP, \fB\-\-attribute ATTR\fP
|
56
|
-
The attribute (or attributes) to show.
|
57
|
-
.TP
|
58
|
-
.B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
|
59
|
-
The configuration file to use.
|
60
|
-
.TP
|
61
|
-
.B \fB\-\-chef\-repo\-path PATH\fP
|
62
|
-
The path to the chef\-repo\&. This setting will override the default path to the chef\-repo\&. Default: same as specified by \fBchef_repo_path\fP in config.rb.
|
63
|
-
.TP
|
64
|
-
.B \fB\-\-chef\-zero\-port PORT\fP
|
65
|
-
The port on which chef\-zero will listen.
|
66
|
-
.TP
|
67
|
-
.B \fB\-\-[no\-]color\fP
|
68
|
-
Use to view colored output.
|
69
|
-
.TP
|
70
|
-
.B \fB\-\-concurrency\fP
|
71
|
-
The number of allowed concurrent connections. Default: \fB10\fP\&.
|
72
|
-
.TP
|
73
|
-
.B \fB\-d\fP, \fB\-\-disable\-editing\fP
|
74
|
-
Use to prevent the $EDITOR from being opened and to accept data as\-is.
|
75
|
-
.TP
|
76
|
-
.B \fB\-\-defaults\fP
|
77
|
-
Use to have knife use the default value instead of asking a user to provide one.
|
78
|
-
.TP
|
79
|
-
.B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
|
80
|
-
The $EDITOR that is used for all interactive commands.
|
81
|
-
.TP
|
82
|
-
.B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
|
83
|
-
The name of the environment. When this option is added to a command, the command will run only against the named environment.
|
84
|
-
.TP
|
85
|
-
.B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
|
86
|
-
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
|
87
|
-
.TP
|
88
|
-
.B \fB\-h\fP, \fB\-\-help\fP
|
89
|
-
Shows help for the command.
|
90
|
-
.TP
|
91
|
-
.B \fB\-k KEY\fP, \fB\-\-key KEY\fP
|
92
|
-
The private key that knife will use to sign requests made by the API client to the Chef server\&.
|
93
|
-
.TP
|
94
|
-
.B \fB\-\-local\fP
|
95
|
-
Use to show local files instead of remote files.
|
96
|
-
.TP
|
97
|
-
.B \fB\-\-print\-after\fP
|
98
|
-
Use to show data after a destructive operation.
|
99
|
-
.TP
|
100
|
-
.B \fB\-\-repo\-mode MODE\fP
|
101
|
-
The layout of the local chef\-repo\&. Possible values: \fBstatic\fP, \fBeverything\fP, or \fBhosted_everything\fP\&. Use \fBstatic\fP for just roles, environments, cookbooks, and data bags. By default, \fBeverything\fP and \fBhosted_everything\fP are dynamically selected depending on the server type. Default: \fBeverything\fP / \fBhosted_everything\fP\&.
|
102
|
-
.TP
|
103
|
-
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
104
|
-
The URL for the Chef server\&.
|
105
|
-
.TP
|
106
|
-
.B \fB\-u USER\fP, \fB\-\-user USER\fP
|
107
|
-
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.
|
108
|
-
.TP
|
109
|
-
.B \fB\-v\fP, \fB\-\-version\fP
|
110
|
-
The version of the chef\-client\&.
|
111
|
-
.TP
|
112
|
-
.B \fB\-V\fP, \fB\-\-verbose\fP
|
113
|
-
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
114
|
-
.TP
|
115
|
-
.B \fB\-y\fP, \fB\-\-yes\fP
|
116
|
-
Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
|
117
|
-
.TP
|
118
|
-
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
119
|
-
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\&.
|
120
|
-
.UNINDENT
|
121
|
-
.sp
|
122
|
-
\fBExamples\fP
|
123
|
-
.sp
|
124
|
-
To show all cookbooks in the \fBcookbooks/\fP directory:
|
125
|
-
.INDENT 0.0
|
126
|
-
.INDENT 3.5
|
127
|
-
.sp
|
128
|
-
.nf
|
129
|
-
.ft C
|
130
|
-
$ knife show cookbooks/
|
131
|
-
.ft P
|
132
|
-
.fi
|
133
|
-
.UNINDENT
|
134
|
-
.UNINDENT
|
135
|
-
.sp
|
136
|
-
or, (if already in the \fBcookbooks/\fP directory in the local chef\-repo):
|
137
|
-
.INDENT 0.0
|
138
|
-
.INDENT 3.5
|
139
|
-
.sp
|
140
|
-
.nf
|
141
|
-
.ft C
|
142
|
-
$ knife show
|
143
|
-
.ft P
|
144
|
-
.fi
|
145
|
-
.UNINDENT
|
146
|
-
.UNINDENT
|
147
|
-
.INDENT 0.0
|
148
|
-
.INDENT 3.5
|
149
|
-
.sp
|
150
|
-
.nf
|
151
|
-
.ft C
|
152
|
-
$ knife show roles/ environments/
|
153
|
-
.ft P
|
154
|
-
.fi
|
155
|
-
.UNINDENT
|
156
|
-
.UNINDENT
|
157
|
-
.SH AUTHOR
|
158
|
-
Chef
|
159
|
-
.\" Generated by docutils manpage writer.
|
160
|
-
.
|
@@ -1,284 +0,0 @@
|
|
1
|
-
.\" Man page generated from reStructuredText.
|
2
|
-
.
|
3
|
-
.TH "KNIFE-SSH" "1" "Chef 12.0" "" "knife ssh"
|
4
|
-
.SH NAME
|
5
|
-
knife-ssh \- The man page for the knife ssh 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 ssh\fP subcommand is used to invoke SSH commands (in parallel) on a subset of nodes within an organization, based on the results of a \fI\%search query\fP made to the Chef server\&.
|
35
|
-
.sp
|
36
|
-
\fBSyntax\fP
|
37
|
-
.sp
|
38
|
-
This subcommand has the following syntax:
|
39
|
-
.INDENT 0.0
|
40
|
-
.INDENT 3.5
|
41
|
-
.sp
|
42
|
-
.nf
|
43
|
-
.ft C
|
44
|
-
$ knife ssh SEARCH_QUERY SSH_COMMAND (options)
|
45
|
-
.ft P
|
46
|
-
.fi
|
47
|
-
.UNINDENT
|
48
|
-
.UNINDENT
|
49
|
-
.sp
|
50
|
-
\fBOptions\fP
|
51
|
-
.sp
|
52
|
-
This subcommand has the following options:
|
53
|
-
.INDENT 0.0
|
54
|
-
.TP
|
55
|
-
.B \fB\-a SSH_ATTR\fP, \fB\-\-attribute SSH_ATTR\fP
|
56
|
-
The attribute that is used when opening the SSH connection. The default attribute is the FQDN of the host. Other possible values include a public IP address, a private IP address, or a hostname.
|
57
|
-
.TP
|
58
|
-
.B \fB\-A\fP, \fB\-\-forward\-agent\fP
|
59
|
-
Use to enable SSH agent forwarding.
|
60
|
-
.TP
|
61
|
-
.B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
|
62
|
-
The configuration file to use.
|
63
|
-
.TP
|
64
|
-
.B \fB\-C NUM\fP, \fB\-\-concurrency NUM\fP
|
65
|
-
The number of allowed concurrent connections.
|
66
|
-
.TP
|
67
|
-
.B \fB\-\-chef\-zero\-port PORT\fP
|
68
|
-
The port on which chef\-zero will listen.
|
69
|
-
.TP
|
70
|
-
.B \fB\-\-[no\-]color\fP
|
71
|
-
Use to view colored output.
|
72
|
-
.TP
|
73
|
-
.B \fB\-d\fP, \fB\-\-disable\-editing\fP
|
74
|
-
Use to prevent the $EDITOR from being opened and to accept data as\-is.
|
75
|
-
.TP
|
76
|
-
.B \fB\-\-defaults\fP
|
77
|
-
Use to have knife use the default value instead of asking a user to provide one.
|
78
|
-
.TP
|
79
|
-
.B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
|
80
|
-
The $EDITOR that is used for all interactive commands.
|
81
|
-
.TP
|
82
|
-
.B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
|
83
|
-
The name of the environment. When this option is added to a command, the command will run only against the named environment.
|
84
|
-
.TP
|
85
|
-
.B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
|
86
|
-
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
|
87
|
-
.TP
|
88
|
-
.B \fB\-G GATEWAY\fP, \fB\-\-ssh\-gateway GATEWAY\fP
|
89
|
-
The SSH tunnel or gateway that is used to run a bootstrap action on a machine that is not accessible from the workstation.
|
90
|
-
.TP
|
91
|
-
.B \fB\-h\fP, \fB\-\-help\fP
|
92
|
-
Shows help for the command.
|
93
|
-
.TP
|
94
|
-
.B \fB\-i IDENTITY_FILE\fP, \fB\-\-identity\-file IDENTIFY_FILE\fP
|
95
|
-
The SSH identity file used for authentication. Key\-based authentication is recommended.
|
96
|
-
.TP
|
97
|
-
.B \fB\-k KEY\fP, \fB\-\-key KEY\fP
|
98
|
-
The private key that knife will use to sign requests made by the API client to the Chef server\&.
|
99
|
-
.TP
|
100
|
-
.B \fB\-m\fP, \fB\-\-manual\-list\fP
|
101
|
-
Use to define a search query as a space\-separated list of servers. If there is more than one item in the list, put quotes around the entire list. For example: \fB\-\-manual\-list "server01 server 02 server 03"\fP
|
102
|
-
.TP
|
103
|
-
.B \fB\-\-[no\-]host\-key\-verify\fP
|
104
|
-
Use \fB\-\-no\-host\-key\-verify\fP to disable host key verification. Default setting: \fB\-\-host\-key\-verify\fP\&.
|
105
|
-
.TP
|
106
|
-
.B \fBOTHER\fP
|
107
|
-
The shell type. Possible values: \fBinteractive\fP, \fBscreen\fP, \fBtmux\fP, \fBmacterm\fP, or \fBcssh\fP\&. (\fBcsshx\fP is deprecated in favor of \fBcssh\fP\&.)
|
108
|
-
.TP
|
109
|
-
.B \fB\-p PORT\fP, \fB\-\-ssh\-port PORT\fP
|
110
|
-
The SSH port.
|
111
|
-
.TP
|
112
|
-
.B \fB\-P PASSWORD\fP, \fB\-\-ssh\-password PASSWORD\fP
|
113
|
-
The SSH password. This can be used to pass the password directly on the command line. If this option is not specified (and a password is required) knife will prompt for the password.
|
114
|
-
.TP
|
115
|
-
.B \fB\-\-print\-after\fP
|
116
|
-
Use to show data after a destructive operation.
|
117
|
-
.TP
|
118
|
-
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
119
|
-
The URL for the Chef server\&.
|
120
|
-
.TP
|
121
|
-
.B \fBSEARCH_QUERY\fP
|
122
|
-
The search query used to return a list of servers to be accessed using SSH and the specified \fBSSH_COMMAND\fP\&. This option uses the same syntax as the search sub\-command.
|
123
|
-
.TP
|
124
|
-
.B \fBSSH_COMMAND\fP
|
125
|
-
The command that will be run against the results of a search query.
|
126
|
-
.TP
|
127
|
-
.B \fB\-u USER\fP, \fB\-\-user USER\fP
|
128
|
-
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.
|
129
|
-
.TP
|
130
|
-
.B \fB\-v\fP, \fB\-\-version\fP
|
131
|
-
The version of the chef\-client\&.
|
132
|
-
.TP
|
133
|
-
.B \fB\-V\fP, \fB\-\-verbose\fP
|
134
|
-
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
135
|
-
.TP
|
136
|
-
.B \fB\-x USER_NAME\fP, \fB\-\-ssh\-user USER_NAME\fP
|
137
|
-
The SSH user name.
|
138
|
-
.TP
|
139
|
-
.B \fB\-y\fP, \fB\-\-yes\fP
|
140
|
-
Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
|
141
|
-
.TP
|
142
|
-
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
143
|
-
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\&.
|
144
|
-
.UNINDENT
|
145
|
-
.sp
|
146
|
-
\fBExamples\fP
|
147
|
-
.sp
|
148
|
-
To find the uptime of all of web servers running Ubuntu on the Amazon EC2 platform, enter:
|
149
|
-
.INDENT 0.0
|
150
|
-
.INDENT 3.5
|
151
|
-
.sp
|
152
|
-
.nf
|
153
|
-
.ft C
|
154
|
-
$ knife ssh "role:web" "uptime" \-x ubuntu \-a ec2.public_hostname
|
155
|
-
.ft P
|
156
|
-
.fi
|
157
|
-
.UNINDENT
|
158
|
-
.UNINDENT
|
159
|
-
.sp
|
160
|
-
to return something like:
|
161
|
-
.INDENT 0.0
|
162
|
-
.INDENT 3.5
|
163
|
-
.sp
|
164
|
-
.nf
|
165
|
-
.ft C
|
166
|
-
ec2\-174\-129\-127\-206.compute\-1.amazonaws.com 13:50:47 up 1 day, 23:26, 1 user, load average: 0.25, 0.18, 0.11
|
167
|
-
ec2\-67\-202\-63\-102.compute\-1.amazonaws.com 13:50:47 up 1 day, 23:33, 1 user, load average: 0.12, 0.13, 0.10
|
168
|
-
ec2\-184\-73\-9\-250.compute\-1.amazonaws.com 13:50:48 up 16:45, 1 user, load average: 0.30, 0.22, 0.13
|
169
|
-
ec2\-75\-101\-240\-230.compute\-1.amazonaws.com 13:50:48 up 1 day, 22:59, 1 user, load average: 0.24, 0.17, 0.11
|
170
|
-
ec2\-184\-73\-60\-141.compute\-1.amazonaws.com 13:50:48 up 1 day, 23:30, 1 user, load average: 0.32, 0.17, 0.15
|
171
|
-
.ft P
|
172
|
-
.fi
|
173
|
-
.UNINDENT
|
174
|
-
.UNINDENT
|
175
|
-
.INDENT 0.0
|
176
|
-
.INDENT 3.5
|
177
|
-
.sp
|
178
|
-
.nf
|
179
|
-
.ft C
|
180
|
-
$ knife ssh \(aqname:*\(aq \(aqsudo chef\-client\(aq
|
181
|
-
.ft P
|
182
|
-
.fi
|
183
|
-
.UNINDENT
|
184
|
-
.UNINDENT
|
185
|
-
.sp
|
186
|
-
To force a chef\-client run on all of the web servers running Ubuntu on the Amazon EC2 platform, enter:
|
187
|
-
.INDENT 0.0
|
188
|
-
.INDENT 3.5
|
189
|
-
.sp
|
190
|
-
.nf
|
191
|
-
.ft C
|
192
|
-
$ knife ssh "role:web" "sudo chef\-client" \-x ubuntu \-a ec2.public_hostname
|
193
|
-
.ft P
|
194
|
-
.fi
|
195
|
-
.UNINDENT
|
196
|
-
.UNINDENT
|
197
|
-
.sp
|
198
|
-
to return something like:
|
199
|
-
.INDENT 0.0
|
200
|
-
.INDENT 3.5
|
201
|
-
.sp
|
202
|
-
.nf
|
203
|
-
.ft C
|
204
|
-
ec2\-67\-202\-63\-102.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:37 +0000] INFO: Starting Chef Run (Version 0.9.10)
|
205
|
-
ec2\-174\-129\-127\-206.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:37 +0000] INFO: Starting Chef Run (Version 0.9.10)
|
206
|
-
ec2\-184\-73\-9\-250.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:38 +0000] INFO: Starting Chef Run (Version 0.9.10)
|
207
|
-
ec2\-75\-101\-240\-230.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:38 +0000] INFO: Starting Chef Run (Version 0.9.10)
|
208
|
-
ec2\-184\-73\-60\-141.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:38 +0000] INFO: Starting Chef Run (Version 0.9.10)
|
209
|
-
ec2\-174\-129\-127\-206.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Chef Run complete in 1.419243 seconds
|
210
|
-
ec2\-174\-129\-127\-206.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: cleaning the checksum cache
|
211
|
-
ec2\-174\-129\-127\-206.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Running report handlers
|
212
|
-
ec2\-174\-129\-127\-206.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Report handlers complete
|
213
|
-
ec2\-67\-202\-63\-102.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Chef Run complete in 1.578265 seconds
|
214
|
-
ec2\-67\-202\-63\-102.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: cleaning the checksum cache
|
215
|
-
ec2\-67\-202\-63\-102.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Running report handlers
|
216
|
-
ec2\-67\-202\-63\-102.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:39 +0000] INFO: Report handlers complete
|
217
|
-
ec2\-184\-73\-9\-250.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Chef Run complete in 1.638884 seconds
|
218
|
-
ec2\-184\-73\-9\-250.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: cleaning the checksum cache
|
219
|
-
ec2\-184\-73\-9\-250.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Running report handlers
|
220
|
-
ec2\-184\-73\-9\-250.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Report handlers complete
|
221
|
-
ec2\-75\-101\-240\-230.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Chef Run complete in 1.540257 seconds
|
222
|
-
ec2\-75\-101\-240\-230.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: cleaning the checksum cache
|
223
|
-
ec2\-75\-101\-240\-230.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Running report handlers
|
224
|
-
ec2\-75\-101\-240\-230.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Report handlers complete
|
225
|
-
ec2\-184\-73\-60\-141.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Chef Run complete in 1.502489 seconds
|
226
|
-
ec2\-184\-73\-60\-141.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: cleaning the checksum cache
|
227
|
-
ec2\-184\-73\-60\-141.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Running report handlers
|
228
|
-
ec2\-184\-73\-60\-141.compute\-1.amazonaws.com [Fri, 22 Oct 2010 14:18:40 +0000] INFO: Report handlers complete
|
229
|
-
.ft P
|
230
|
-
.fi
|
231
|
-
.UNINDENT
|
232
|
-
.UNINDENT
|
233
|
-
.sp
|
234
|
-
To query for all nodes that have the \fBwebserver\fP role and then use SSH to run the command \fBsudo chef\-client\fP, enter:
|
235
|
-
.INDENT 0.0
|
236
|
-
.INDENT 3.5
|
237
|
-
.sp
|
238
|
-
.nf
|
239
|
-
.ft C
|
240
|
-
$ knife ssh "role:webserver" "sudo chef\-client"
|
241
|
-
.ft P
|
242
|
-
.fi
|
243
|
-
.UNINDENT
|
244
|
-
.UNINDENT
|
245
|
-
.INDENT 0.0
|
246
|
-
.INDENT 3.5
|
247
|
-
.sp
|
248
|
-
.nf
|
249
|
-
.ft C
|
250
|
-
$ knife ssh name:* "sudo aptitude upgrade \-y"
|
251
|
-
.ft P
|
252
|
-
.fi
|
253
|
-
.UNINDENT
|
254
|
-
.UNINDENT
|
255
|
-
.sp
|
256
|
-
To specify the shell type used on the nodes returned by a search query:
|
257
|
-
.INDENT 0.0
|
258
|
-
.INDENT 3.5
|
259
|
-
.sp
|
260
|
-
.nf
|
261
|
-
.ft C
|
262
|
-
$ knife ssh roles:opscode\-omnitruck macterm
|
263
|
-
.ft P
|
264
|
-
.fi
|
265
|
-
.UNINDENT
|
266
|
-
.UNINDENT
|
267
|
-
.sp
|
268
|
-
where \fBscreen\fP is one of the following values: \fBcssh\fP, \fBinteractive\fP, \fBmacterm\fP, \fBscreen\fP, or \fBtmux\fP\&. If the node does not have the shell type installed, knife will return an error similar to the following:
|
269
|
-
.INDENT 0.0
|
270
|
-
.INDENT 3.5
|
271
|
-
.sp
|
272
|
-
.nf
|
273
|
-
.ft C
|
274
|
-
you need the rb\-appscript gem to use knife ssh macterm.
|
275
|
-
\(ga(sudo) gem install rb\-appscript\(ga to install
|
276
|
-
ERROR: LoadError: cannot load such file \-\- appscript
|
277
|
-
.ft P
|
278
|
-
.fi
|
279
|
-
.UNINDENT
|
280
|
-
.UNINDENT
|
281
|
-
.SH AUTHOR
|
282
|
-
Chef
|
283
|
-
.\" Generated by docutils manpage writer.
|
284
|
-
.
|
@@ -1,207 +0,0 @@
|
|
1
|
-
.\" Man page generated from reStructuredText.
|
2
|
-
.
|
3
|
-
.TH "KNIFE-SSL-CHECK" "1" "Chef 12.0" "" "knife ssl check"
|
4
|
-
.SH NAME
|
5
|
-
knife-ssl-check \- The man page for the knife ssl check 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 ssl check\fP subcommand is used to verify the SSL configuration for the Enterprise Chef and/or Open Source Chef servers, or at another location specified by a URL or URI.
|
35
|
-
.sp
|
36
|
-
\fBWARNING:\fP
|
37
|
-
.INDENT 0.0
|
38
|
-
.INDENT 3.5
|
39
|
-
When verification of a remote server\(aqs SSL certificate is disabled, the chef\-client will issue a warning similar to "SSL validation of HTTPS requests is disabled. HTTPS connections are still encrypted, but the chef\-client is not able to detect forged replies or man\-in\-the\-middle attacks." To configure SSL for the chef\-client, set \fBssl_verify_mode\fP to \fB:verify_peer\fP (recommended) \fBor\fP \fBverify_api_cert\fP to \fBtrue\fP in the client.rb file.
|
40
|
-
.UNINDENT
|
41
|
-
.UNINDENT
|
42
|
-
.sp
|
43
|
-
\fBSyntax\fP
|
44
|
-
.sp
|
45
|
-
This subcommand has the following syntax:
|
46
|
-
.INDENT 0.0
|
47
|
-
.INDENT 3.5
|
48
|
-
.sp
|
49
|
-
.nf
|
50
|
-
.ft C
|
51
|
-
$ knife ssl check URI
|
52
|
-
.ft P
|
53
|
-
.fi
|
54
|
-
.UNINDENT
|
55
|
-
.UNINDENT
|
56
|
-
.sp
|
57
|
-
\fBOptions\fP
|
58
|
-
.sp
|
59
|
-
This subcommand has the following options:
|
60
|
-
.INDENT 0.0
|
61
|
-
.TP
|
62
|
-
.B \fB\-a SSH_ATTR\fP, \fB\-\-attribute SSH_ATTR\fP
|
63
|
-
The attribute that is used when opening the SSH connection. The default attribute is the FQDN of the host. Other possible values include a public IP address, a private IP address, or a hostname.
|
64
|
-
.TP
|
65
|
-
.B \fB\-A\fP, \fB\-\-forward\-agent\fP
|
66
|
-
Use to enable SSH agent forwarding.
|
67
|
-
.TP
|
68
|
-
.B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
|
69
|
-
The configuration file to use.
|
70
|
-
.TP
|
71
|
-
.B \fB\-C NUM\fP, \fB\-\-concurrency NUM\fP
|
72
|
-
The number of allowed concurrent connections.
|
73
|
-
.TP
|
74
|
-
.B \fB\-\-chef\-zero\-port PORT\fP
|
75
|
-
The port on which chef\-zero will listen.
|
76
|
-
.TP
|
77
|
-
.B \fB\-\-[no\-]color\fP
|
78
|
-
Use to view colored output.
|
79
|
-
.TP
|
80
|
-
.B \fB\-d\fP, \fB\-\-disable\-editing\fP
|
81
|
-
Use to prevent the $EDITOR from being opened and to accept data as\-is.
|
82
|
-
.TP
|
83
|
-
.B \fB\-\-defaults\fP
|
84
|
-
Use to have knife use the default value instead of asking a user to provide one.
|
85
|
-
.TP
|
86
|
-
.B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
|
87
|
-
The $EDITOR that is used for all interactive commands.
|
88
|
-
.TP
|
89
|
-
.B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
|
90
|
-
The name of the environment. When this option is added to a command, the command will run only against the named environment.
|
91
|
-
.TP
|
92
|
-
.B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
|
93
|
-
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
|
94
|
-
.TP
|
95
|
-
.B \fB\-G GATEWAY\fP, \fB\-\-ssh\-gateway GATEWAY\fP
|
96
|
-
The SSH tunnel or gateway that is used to run a bootstrap action on a machine that is not accessible from the workstation.
|
97
|
-
.TP
|
98
|
-
.B \fB\-h\fP, \fB\-\-help\fP
|
99
|
-
Shows help for the command.
|
100
|
-
.TP
|
101
|
-
.B \fB\-i IDENTITY_FILE\fP, \fB\-\-identity\-file IDENTIFY_FILE\fP
|
102
|
-
The SSH identity file used for authentication. Key\-based authentication is recommended.
|
103
|
-
.TP
|
104
|
-
.B \fB\-k KEY\fP, \fB\-\-key KEY\fP
|
105
|
-
The private key that knife will use to sign requests made by the API client to the Chef server\&.
|
106
|
-
.TP
|
107
|
-
.B \fB\-m\fP, \fB\-\-manual\-list\fP
|
108
|
-
Use to define a search query as a space\-separated list of servers. If there is more than one item in the list, put quotes around the entire list. For example: \fB\-\-manual\-list "server01 server 02 server 03"\fP
|
109
|
-
.TP
|
110
|
-
.B \fB\-\-[no\-]host\-key\-verify\fP
|
111
|
-
Use \fB\-\-no\-host\-key\-verify\fP to disable host key verification. Default setting: \fB\-\-host\-key\-verify\fP\&.
|
112
|
-
.TP
|
113
|
-
.B \fBOTHER\fP
|
114
|
-
The shell type. Possible values: \fBinteractive\fP, \fBscreen\fP, \fBtmux\fP, \fBmacterm\fP, or \fBcssh\fP\&. (\fBcsshx\fP is deprecated in favor of \fBcssh\fP\&.)
|
115
|
-
.TP
|
116
|
-
.B \fB\-p PORT\fP, \fB\-\-ssh\-port PORT\fP
|
117
|
-
The SSH port.
|
118
|
-
.TP
|
119
|
-
.B \fB\-P PASSWORD\fP, \fB\-\-ssh\-password PASSWORD\fP
|
120
|
-
The SSH password. This can be used to pass the password directly on the command line. If this option is not specified (and a password is required) knife will prompt for the password.
|
121
|
-
.TP
|
122
|
-
.B \fB\-\-print\-after\fP
|
123
|
-
Use to show data after a destructive operation.
|
124
|
-
.TP
|
125
|
-
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
126
|
-
The URL for the Chef server\&.
|
127
|
-
.TP
|
128
|
-
.B \fBSEARCH_QUERY\fP
|
129
|
-
The search query used to return a list of servers to be accessed using SSH and the specified \fBSSH_COMMAND\fP\&. This option uses the same syntax as the search sub\-command.
|
130
|
-
.TP
|
131
|
-
.B \fBSSH_COMMAND\fP
|
132
|
-
The command that will be run against the results of a search query.
|
133
|
-
.TP
|
134
|
-
.B \fB\-u USER\fP, \fB\-\-user USER\fP
|
135
|
-
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.
|
136
|
-
.TP
|
137
|
-
.B \fB\-v\fP, \fB\-\-version\fP
|
138
|
-
The version of the chef\-client\&.
|
139
|
-
.TP
|
140
|
-
.B \fB\-V\fP, \fB\-\-verbose\fP
|
141
|
-
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
142
|
-
.TP
|
143
|
-
.B \fB\-x USER_NAME\fP, \fB\-\-ssh\-user USER_NAME\fP
|
144
|
-
The SSH user name.
|
145
|
-
.TP
|
146
|
-
.B \fB\-y\fP, \fB\-\-yes\fP
|
147
|
-
Use to respond to all confirmation prompts with "Yes". knife will not ask for confirmation.
|
148
|
-
.TP
|
149
|
-
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
150
|
-
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\&.
|
151
|
-
.UNINDENT
|
152
|
-
.sp
|
153
|
-
\fBExamples\fP
|
154
|
-
.sp
|
155
|
-
The following examples show how to use this knife subcommand:
|
156
|
-
.sp
|
157
|
-
\fBVerify the SSL configuration for the Chef server\fP
|
158
|
-
.INDENT 0.0
|
159
|
-
.INDENT 3.5
|
160
|
-
.sp
|
161
|
-
.nf
|
162
|
-
.ft C
|
163
|
-
$ knife ssl check
|
164
|
-
.ft P
|
165
|
-
.fi
|
166
|
-
.UNINDENT
|
167
|
-
.UNINDENT
|
168
|
-
.sp
|
169
|
-
\fBVerify the SSL configuration for the chef\-client\fP
|
170
|
-
.INDENT 0.0
|
171
|
-
.INDENT 3.5
|
172
|
-
.sp
|
173
|
-
.nf
|
174
|
-
.ft C
|
175
|
-
$ knife ssl check \-c /etc/chef/client.rb
|
176
|
-
.ft P
|
177
|
-
.fi
|
178
|
-
.UNINDENT
|
179
|
-
.UNINDENT
|
180
|
-
.sp
|
181
|
-
\fBVerify an external server\(aqs SSL certificate\fP
|
182
|
-
.INDENT 0.0
|
183
|
-
.INDENT 3.5
|
184
|
-
.sp
|
185
|
-
.nf
|
186
|
-
.ft C
|
187
|
-
$ knife ssl check URL_or_URI
|
188
|
-
.ft P
|
189
|
-
.fi
|
190
|
-
.UNINDENT
|
191
|
-
.UNINDENT
|
192
|
-
.sp
|
193
|
-
for example:
|
194
|
-
.INDENT 0.0
|
195
|
-
.INDENT 3.5
|
196
|
-
.sp
|
197
|
-
.nf
|
198
|
-
.ft C
|
199
|
-
$ knife ssl check https://www.getchef.com
|
200
|
-
.ft P
|
201
|
-
.fi
|
202
|
-
.UNINDENT
|
203
|
-
.UNINDENT
|
204
|
-
.SH AUTHOR
|
205
|
-
Chef
|
206
|
-
.\" Generated by docutils manpage writer.
|
207
|
-
.
|