chef 11.12.8-x86-mingw32 → 11.14.0.alpha.2-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Rakefile +4 -2
- data/distro/common/html/_sources/index.txt +6 -0
- data/distro/common/html/_sources/knife_ssl_check.txt +41 -0
- data/distro/common/html/_sources/knife_ssl_fetch.txt +41 -0
- data/distro/common/html/_static/basic.css +2 -5
- data/distro/common/html/_static/doctools.js +5 -14
- data/distro/common/html/_static/jquery.js +2 -154
- data/distro/common/html/_static/pygments.css +2 -2
- data/distro/common/html/_static/searchtools.js +212 -150
- data/distro/common/html/_static/underscore.js +29 -21
- data/distro/common/html/_static/websupport.js +1 -1
- data/distro/common/html/ctl_chef_client.html +15 -18
- data/distro/common/html/ctl_chef_server.html +7 -7
- data/distro/common/html/ctl_chef_shell.html +6 -6
- data/distro/common/html/ctl_chef_solo.html +7 -8
- data/distro/common/html/index.html +34 -24
- data/distro/common/html/knife.html +23 -24
- data/distro/common/html/knife_bootstrap.html +13 -9
- data/distro/common/html/knife_client.html +10 -11
- data/distro/common/html/knife_common_options.html +6 -7
- data/distro/common/html/knife_configure.html +3 -4
- data/distro/common/html/knife_cookbook.html +18 -11
- data/distro/common/html/knife_cookbook_site.html +14 -14
- data/distro/common/html/knife_data_bag.html +24 -23
- data/distro/common/html/knife_delete.html +4 -5
- data/distro/common/html/knife_deps.html +4 -5
- data/distro/common/html/knife_diff.html +6 -7
- data/distro/common/html/knife_download.html +12 -13
- data/distro/common/html/knife_edit.html +4 -5
- data/distro/common/html/knife_environment.html +8 -9
- data/distro/common/html/knife_exec.html +9 -10
- data/distro/common/html/knife_index_rebuild.html +4 -5
- data/distro/common/html/knife_list.html +8 -9
- data/distro/common/html/knife_node.html +34 -33
- data/distro/common/html/knife_raw.html +2 -3
- data/distro/common/html/knife_recipe_list.html +3 -4
- data/distro/common/html/knife_role.html +30 -29
- data/distro/common/html/knife_search.html +7 -7
- data/distro/common/html/knife_show.html +4 -5
- data/distro/common/html/knife_ssh.html +2 -3
- data/distro/common/html/knife_ssl_check.html +148 -0
- data/distro/common/html/knife_ssl_fetch.html +152 -0
- data/distro/common/html/knife_status.html +4 -5
- data/distro/common/html/knife_tag.html +2 -3
- data/distro/common/html/knife_upload.html +5 -6
- data/distro/common/html/knife_user.html +9 -10
- data/distro/common/html/knife_using.html +12 -12
- data/distro/common/html/knife_xargs.html +11 -12
- data/distro/common/html/search.html +1 -2
- data/distro/common/html/searchindex.js +1 -1
- data/distro/common/man/man1/chef-shell.1 +19 -11
- data/distro/common/man/man1/knife-bootstrap.1 +35 -19
- data/distro/common/man/man1/knife-client.1 +111 -28
- data/distro/common/man/man1/knife-configure.1 +30 -14
- data/distro/common/man/man1/knife-cookbook-site.1 +105 -22
- data/distro/common/man/man1/knife-cookbook.1 +164 -23
- data/distro/common/man/man1/knife-data-bag.1 +157 -33
- data/distro/common/man/man1/knife-delete.1 +21 -17
- data/distro/common/man/man1/knife-deps.1 +60 -16
- data/distro/common/man/man1/knife-diff.1 +37 -17
- data/distro/common/man/man1/knife-download.1 +68 -24
- data/distro/common/man/man1/knife-edit.1 +19 -15
- data/distro/common/man/man1/knife-environment.1 +105 -17
- data/distro/common/man/man1/knife-exec.1 +78 -18
- data/distro/common/man/man1/knife-index-rebuild.1 +16 -8
- data/distro/common/man/man1/knife-list.1 +39 -23
- data/distro/common/man/man1/knife-node.1 +170 -22
- data/distro/common/man/man1/knife-raw.1 +33 -13
- data/distro/common/man/man1/knife-recipe-list.1 +17 -5
- data/distro/common/man/man1/knife-role.1 +86 -18
- data/distro/common/man/man1/knife-search.1 +80 -16
- data/distro/common/man/man1/knife-show.1 +30 -14
- data/distro/common/man/man1/knife-ssh.1 +54 -14
- data/distro/common/man/man1/knife-ssl-check.1 +207 -0
- data/distro/common/man/man1/knife-ssl-fetch.1 +207 -0
- data/distro/common/man/man1/knife-status.1 +48 -12
- data/distro/common/man/man1/knife-tag.1 +30 -10
- data/distro/common/man/man1/knife-upload.1 +72 -20
- data/distro/common/man/man1/knife-user.1 +79 -23
- data/distro/common/man/man1/knife-xargs.1 +61 -53
- data/distro/common/man/man8/chef-client.8 +87 -29
- data/distro/common/man/man8/chef-solo.8 +36 -15
- data/lib/chef/application.rb +19 -14
- data/lib/chef/application/client.rb +5 -0
- data/lib/chef/application/solo.rb +5 -0
- data/lib/chef/application/windows_service_manager.rb +3 -0
- data/lib/chef/chef_fs/chef_fs_data_store.rb +72 -24
- data/lib/chef/chef_fs/file_system/chef_repository_file_system_cookbook_dir.rb +20 -4
- data/lib/chef/chef_fs/file_system/chef_repository_file_system_cookbooks_dir.rb +20 -1
- data/lib/chef/chef_fs/file_system/file_system_entry.rb +10 -2
- data/lib/chef/client.rb +2 -3
- data/lib/chef/config.rb +34 -8
- data/lib/chef/cookbook/cookbook_version_loader.rb +45 -4
- data/lib/chef/cookbook_version.rb +38 -30
- data/lib/chef/dsl/recipe.rb +4 -1
- data/lib/chef/event_dispatch/base.rb +14 -0
- data/lib/chef/event_dispatch/events_output_stream.rb +29 -0
- data/lib/chef/exceptions.rb +8 -0
- data/lib/chef/formatters/base.rb +16 -45
- data/lib/chef/formatters/doc.rb +51 -26
- data/lib/chef/formatters/indentable_output_stream.rb +165 -0
- data/lib/chef/knife/node_environment_set.rb +54 -0
- data/lib/chef/knife/user_create.rb +1 -1
- data/lib/chef/monkey_patches/pathname.rb +32 -0
- data/lib/chef/node.rb +1 -1
- data/lib/chef/platform/provider_mapping.rb +345 -338
- data/lib/chef/policy_builder/expand_node_object.rb +1 -1
- data/lib/chef/policy_builder/policyfile.rb +1 -1
- data/lib/chef/provider.rb +1 -0
- data/lib/chef/provider/git.rb +1 -1
- data/lib/chef/provider/link.rb +2 -2
- data/lib/chef/provider/remote_file/content.rb +1 -1
- data/lib/chef/provider/remote_file/local_file.rb +8 -2
- data/lib/chef/provider/service/arch.rb +0 -1
- data/lib/chef/provider/service/debian.rb +0 -2
- data/lib/chef/provider/service/freebsd.rb +2 -1
- data/lib/chef/provider/service/gentoo.rb +1 -1
- data/lib/chef/provider/service/init.rb +0 -1
- data/lib/chef/provider/service/insserv.rb +0 -2
- data/lib/chef/provider/service/invokercd.rb +0 -2
- data/lib/chef/provider/service/macosx.rb +2 -1
- data/lib/chef/provider/service/redhat.rb +0 -1
- data/lib/chef/provider/service/simple.rb +1 -0
- data/lib/chef/provider/service/solaris.rb +1 -0
- data/lib/chef/provider/service/systemd.rb +1 -1
- data/lib/chef/provider/service/upstart.rb +1 -1
- data/lib/chef/provider/user.rb +9 -9
- data/lib/chef/provider/user/solaris.rb +2 -0
- data/lib/chef/resource.rb +1 -0
- data/lib/chef/resource/remote_file.rb +32 -6
- data/lib/chef/run_context.rb +22 -0
- data/lib/chef/run_lock.rb +43 -4
- data/lib/chef/version.rb +2 -2
- data/spec/functional/http/simple_spec.rb +84 -0
- data/spec/functional/resource/remote_file_spec.rb +107 -43
- data/spec/functional/rest_spec.rb +94 -0
- data/spec/functional/run_lock_spec.rb +1 -1
- data/spec/functional/win32/service_manager_spec.rb +6 -0
- data/spec/integration/knife/chef_fs_data_store_spec.rb +2 -0
- data/spec/integration/recipes/lwrp_inline_resources_spec.rb +76 -0
- data/spec/spec_helper.rb +2 -0
- data/spec/support/mock/platform.rb +7 -0
- data/spec/support/pedant/pedant_config.rb +121 -0
- data/spec/support/pedant/run_pedant.rb +63 -0
- data/spec/support/pedant/stickywicket.pem +27 -0
- data/spec/support/shared/functional/http.rb +242 -0
- data/spec/support/shared/unit/api_error_inspector.rb +2 -2
- data/spec/unit/api_client_spec.rb +2 -2
- data/spec/unit/application/client_spec.rb +6 -1
- data/spec/unit/application/knife_spec.rb +4 -0
- data/spec/unit/application/solo_spec.rb +2 -0
- data/spec/unit/application_spec.rb +7 -0
- data/spec/unit/client_spec.rb +16 -0
- data/spec/unit/config_spec.rb +3 -20
- data/spec/unit/cookbook_version_spec.rb +224 -122
- data/spec/unit/formatters/error_inspectors/compile_error_inspector_spec.rb +2 -2
- data/spec/unit/formatters/error_inspectors/cookbook_resolve_error_inspector_spec.rb +2 -2
- data/spec/unit/formatters/error_inspectors/cookbook_sync_error_inspector_spec.rb +2 -2
- data/spec/unit/formatters/error_inspectors/resource_failure_inspector_spec.rb +2 -2
- data/spec/unit/formatters/error_inspectors/run_list_expansion_error_inspector_spec.rb +2 -2
- data/spec/unit/handler_spec.rb +0 -1
- data/spec/unit/knife/client_bulk_delete_spec.rb +3 -0
- data/spec/unit/knife/cookbook_bulk_delete_spec.rb +2 -0
- data/spec/unit/knife/cookbook_metadata_spec.rb +2 -2
- data/spec/unit/knife/cookbook_site_install_spec.rb +3 -1
- data/spec/unit/knife/cookbook_upload_spec.rb +10 -10
- data/spec/unit/knife/node_environment_set_spec.rb +80 -0
- data/spec/unit/knife/user_create_spec.rb +6 -4
- data/spec/unit/knife/user_edit_spec.rb +5 -0
- data/spec/unit/knife_spec.rb +3 -0
- data/spec/unit/mixin/securable_spec.rb +18 -20
- data/spec/unit/node/attribute_spec.rb +15 -2
- data/spec/unit/node/immutable_collections_spec.rb +4 -4
- data/spec/unit/provider/cron_spec.rb +14 -14
- data/spec/unit/provider/git_spec.rb +4 -4
- data/spec/unit/provider/group_spec.rb +1 -1
- data/spec/unit/provider/ohai_spec.rb +2 -2
- data/spec/unit/provider/remote_file/content_spec.rb +58 -35
- data/spec/unit/provider/remote_file/local_file_spec.rb +23 -0
- data/spec/unit/provider/service/solaris_smf_service_spec.rb +13 -13
- data/spec/unit/resource/mount_spec.rb +0 -1
- data/spec/unit/resource/remote_file_spec.rb +29 -0
- data/spec/unit/resource_spec.rb +1 -1
- data/spec/unit/run_context_spec.rb +7 -0
- data/spec/unit/run_lock_spec.rb +98 -0
- data/spec/unit/version_constraint_spec.rb +1 -1
- metadata +166 -153
- data/distro/common/html/_static/chef.css +0 -507
- data/distro/common/html/_static/chef_logo.png +0 -0
- data/lib/chef/checksum/storage.rb +0 -18
- data/lib/chef/checksum/storage/filesystem.rb +0 -56
- data/spec/unit/checksum/storage/filesystem_spec.rb +0 -70
@@ -1,4 +1,6 @@
|
|
1
|
-
|
1
|
+
.\" Man page generated from reStructuredText.
|
2
|
+
.
|
3
|
+
.TH "KNIFE-DELETE" "1" "Chef 11.12.0" "" "knife delete"
|
2
4
|
.SH NAME
|
3
5
|
knife-delete \- The man page for the knife delete subcommand.
|
4
6
|
.
|
@@ -28,20 +30,22 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
28
30
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
29
31
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
30
32
|
..
|
31
|
-
.\" Man page generated from reStructuredText.
|
32
|
-
.
|
33
33
|
.sp
|
34
|
-
The \fBknife delete\fP subcommand is used to delete an object from a server
|
34
|
+
The \fBknife delete\fP subcommand is used to delete an object from a Chef server\&. This subcommand works similar to \fBknife cookbook delete\fP, \fBknife data bag delete\fP, \fBknife environment delete\fP, \fBknife node delete\fP, and \fBknife role delete\fP, but with a single verb (and a single action).
|
35
35
|
.sp
|
36
36
|
\fBSyntax\fP
|
37
37
|
.sp
|
38
|
-
This
|
38
|
+
This subcommand has the following syntax:
|
39
|
+
.INDENT 0.0
|
40
|
+
.INDENT 3.5
|
39
41
|
.sp
|
40
42
|
.nf
|
41
43
|
.ft C
|
42
44
|
$ knife delete [PATTERN...] (options)
|
43
45
|
.ft P
|
44
46
|
.fi
|
47
|
+
.UNINDENT
|
48
|
+
.UNINDENT
|
45
49
|
.sp
|
46
50
|
\fBOptions\fP
|
47
51
|
.sp
|
@@ -49,13 +53,13 @@ This subcommand has the following options:
|
|
49
53
|
.INDENT 0.0
|
50
54
|
.TP
|
51
55
|
.B \fB\-\-both\fP
|
52
|
-
Indicates that both local and remote copies of an object should be deleted. Default: \fBfalse\fP
|
56
|
+
Indicates that both local and remote copies of an object should be deleted. Default: \fBfalse\fP\&.
|
53
57
|
.TP
|
54
58
|
.B \fB\-c CONFIG_FILE\fP, \fB\-\-config CONFIG_FILE\fP
|
55
59
|
The configuration file to use.
|
56
60
|
.TP
|
57
61
|
.B \fB\-\-chef\-repo\-path PATH\fP
|
58
|
-
The path to the chef\-repo
|
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.
|
59
63
|
.TP
|
60
64
|
.B \fB\-\-chef\-zero\-port PORT\fP
|
61
65
|
The port on which chef\-zero will listen.
|
@@ -64,7 +68,7 @@ The port on which chef\-zero will listen.
|
|
64
68
|
Indicates whether colored output will be used.
|
65
69
|
.TP
|
66
70
|
.B \fB\-\-concurrency\fP
|
67
|
-
The number of allowed concurrent connections. Default: \fB10\fP
|
71
|
+
The number of allowed concurrent connections. Default: \fB10\fP\&.
|
68
72
|
.TP
|
69
73
|
.B \fB\-d\fP, \fB\-\-disable\-editing\fP
|
70
74
|
Indicates that $EDITOR will not be opened; data will be accepted as\-is.
|
@@ -79,34 +83,34 @@ The $EDITOR that is used for all interactive commands.
|
|
79
83
|
The name of the environment. When this option is added to a command, the command will run only against the named environment.
|
80
84
|
.TP
|
81
85
|
.B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
|
82
|
-
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP
|
86
|
+
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
|
83
87
|
.TP
|
84
88
|
.B \fB\-h\fP, \fB\-\-help\fP
|
85
89
|
Shows help for the command.
|
86
90
|
.TP
|
87
91
|
.B \fB\-k KEY\fP, \fB\-\-key KEY\fP
|
88
|
-
The private key that Knife will use to sign requests made by the API client to the server
|
92
|
+
The private key that Knife will use to sign requests made by the API client to the Chef server\&.
|
89
93
|
.TP
|
90
94
|
.B \fB\-\-local\fP
|
91
|
-
Indicates that only the local copy of an object should be deleted. (The remote copy will not be deleted.) Default: \fBfalse\fP
|
95
|
+
Indicates that only the local copy of an object should be deleted. (The remote copy will not be deleted.) Default: \fBfalse\fP\&.
|
92
96
|
.TP
|
93
97
|
.B \fB\-\-print\-after\fP
|
94
98
|
Indicates that data will be shown after a destructive operation.
|
95
99
|
.TP
|
96
100
|
.B \fB\-r\fP, \fB\-\-[no\-]recurse\fP
|
97
|
-
Use \fB\-\-recurse\fP to delete directories recursively. Default: \fB\-\-no\-recurse\fP
|
101
|
+
Use \fB\-\-recurse\fP to delete directories recursively. Default: \fB\-\-no\-recurse\fP\&.
|
98
102
|
.TP
|
99
103
|
.B \fB\-\-repo\-mode MODE\fP
|
100
|
-
The layout of the local chef\-repo
|
104
|
+
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\&.
|
101
105
|
.TP
|
102
106
|
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
103
|
-
The URL for the server
|
107
|
+
The URL for the Chef server\&.
|
104
108
|
.TP
|
105
109
|
.B \fB\-u USER\fP, \fB\-\-user USER\fP
|
106
|
-
The user name used by Knife to sign requests made by the API client to the server
|
110
|
+
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.
|
107
111
|
.TP
|
108
112
|
.B \fB\-v\fP, \fB\-\-version\fP
|
109
|
-
The version of the chef\-client
|
113
|
+
The version of the chef\-client\&.
|
110
114
|
.TP
|
111
115
|
.B \fB\-V\fP, \fB\-\-verbose\fP
|
112
116
|
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
@@ -115,7 +119,7 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
|
115
119
|
Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
|
116
120
|
.TP
|
117
121
|
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
118
|
-
Indicates that the chef\-client will be run in local mode, which allows all commands that work against the server to also work against the local chef\-repo
|
122
|
+
Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
|
119
123
|
.UNINDENT
|
120
124
|
.SH AUTHOR
|
121
125
|
Chef
|
@@ -1,4 +1,6 @@
|
|
1
|
-
|
1
|
+
.\" Man page generated from reStructuredText.
|
2
|
+
.
|
3
|
+
.TH "KNIFE-DEPS" "1" "Chef 11.12.0" "" "knife deps"
|
2
4
|
.SH NAME
|
3
5
|
knife-deps \- The man page for the knife deps subcommand.
|
4
6
|
.
|
@@ -28,20 +30,22 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
28
30
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
29
31
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
30
32
|
..
|
31
|
-
.\" Man page generated from reStructuredText.
|
32
|
-
.
|
33
33
|
.sp
|
34
34
|
The \fBknife deps\fP subcommand is used to identify dependencies for a node, role, or cookbook.
|
35
35
|
.sp
|
36
36
|
\fBSyntax\fP
|
37
37
|
.sp
|
38
|
-
This
|
38
|
+
This subcommand has the following syntax:
|
39
|
+
.INDENT 0.0
|
40
|
+
.INDENT 3.5
|
39
41
|
.sp
|
40
42
|
.nf
|
41
43
|
.ft C
|
42
44
|
$ knife deps (options)
|
43
45
|
.ft P
|
44
46
|
.fi
|
47
|
+
.UNINDENT
|
48
|
+
.UNINDENT
|
45
49
|
.sp
|
46
50
|
\fBOptions\fP
|
47
51
|
.sp
|
@@ -52,7 +56,7 @@ This subcommand has the following options:
|
|
52
56
|
The configuration file to use.
|
53
57
|
.TP
|
54
58
|
.B \fB\-\-chef\-repo\-path PATH\fP
|
55
|
-
The path to the chef\-repo
|
59
|
+
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.
|
56
60
|
.TP
|
57
61
|
.B \fB\-\-chef\-zero\-port PORT\fP
|
58
62
|
The port on which chef\-zero will listen.
|
@@ -61,7 +65,7 @@ The port on which chef\-zero will listen.
|
|
61
65
|
Indicates whether colored output will be used.
|
62
66
|
.TP
|
63
67
|
.B \fB\-\-concurrency\fP
|
64
|
-
The number of allowed concurrent connections. Default: \fB10\fP
|
68
|
+
The number of allowed concurrent connections. Default: \fB10\fP\&.
|
65
69
|
.TP
|
66
70
|
.B \fB\-d\fP, \fB\-\-disable\-editing\fP
|
67
71
|
Indicates that $EDITOR will not be opened; data will be accepted as\-is.
|
@@ -76,37 +80,37 @@ The $EDITOR that is used for all interactive commands.
|
|
76
80
|
The name of the environment. When this option is added to a command, the command will run only against the named environment.
|
77
81
|
.TP
|
78
82
|
.B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
|
79
|
-
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP
|
83
|
+
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
|
80
84
|
.TP
|
81
85
|
.B \fB\-h\fP, \fB\-\-help\fP
|
82
86
|
Shows help for the command.
|
83
87
|
.TP
|
84
88
|
.B \fB\-k KEY\fP, \fB\-\-key KEY\fP
|
85
|
-
The private key that Knife will use to sign requests made by the API client to the server
|
89
|
+
The private key that Knife will use to sign requests made by the API client to the Chef server\&.
|
86
90
|
.TP
|
87
91
|
.B \fB\-\-print\-after\fP
|
88
92
|
Indicates that data will be shown after a destructive operation.
|
89
93
|
.TP
|
90
94
|
.B \fB\-\-[no\-]recurse\fP
|
91
|
-
Use \fB\-\-recurse\fP to list dependencies recursively. This option can only be used when \fB\-\-tree\fP is set to \fBtrue\fP
|
95
|
+
Use \fB\-\-recurse\fP to list dependencies recursively. This option can only be used when \fB\-\-tree\fP is set to \fBtrue\fP\&. Default: \fB\-\-no\-recurse\fP\&.
|
92
96
|
.TP
|
93
97
|
.B \fB\-\-remote\fP
|
94
|
-
Indicates that dependencies will be determined from objects located on the server instead of the local chef\-repo
|
98
|
+
Indicates that dependencies will be determined from objects located on the Chef server instead of the local chef\-repo\&. Default: \fBfalse\fP\&.
|
95
99
|
.TP
|
96
100
|
.B \fB\-\-repo\-mode MODE\fP
|
97
|
-
The layout of the local chef\-repo
|
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\&.
|
98
102
|
.TP
|
99
103
|
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
100
|
-
The URL for the server
|
104
|
+
The URL for the Chef server\&.
|
101
105
|
.TP
|
102
106
|
.B \fB\-\-tree\fP
|
103
|
-
Indicates that dependencies are shown in a visual tree structure (including duplicates, if they exist). Default: \fBfalse\fP
|
107
|
+
Indicates that dependencies are shown in a visual tree structure (including duplicates, if they exist). Default: \fBfalse\fP\&.
|
104
108
|
.TP
|
105
109
|
.B \fB\-u USER\fP, \fB\-\-user USER\fP
|
106
|
-
The user name used by Knife to sign requests made by the API client to the server
|
110
|
+
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.
|
107
111
|
.TP
|
108
112
|
.B \fB\-v\fP, \fB\-\-version\fP
|
109
|
-
The version of the chef\-client
|
113
|
+
The version of the chef\-client\&.
|
110
114
|
.TP
|
111
115
|
.B \fB\-V\fP, \fB\-\-verbose\fP
|
112
116
|
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
@@ -115,60 +119,90 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
|
115
119
|
Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
|
116
120
|
.TP
|
117
121
|
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
118
|
-
Indicates that the chef\-client will be run in local mode, which allows all commands that work against the server to also work against the local chef\-repo
|
122
|
+
Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
|
119
123
|
.UNINDENT
|
120
124
|
.sp
|
121
125
|
\fBExamples\fP
|
126
|
+
.INDENT 0.0
|
127
|
+
.INDENT 3.5
|
122
128
|
.sp
|
123
129
|
.nf
|
124
130
|
.ft C
|
125
131
|
$ knife deps nodes/node_name.json
|
126
132
|
.ft P
|
127
133
|
.fi
|
134
|
+
.UNINDENT
|
135
|
+
.UNINDENT
|
136
|
+
.INDENT 0.0
|
137
|
+
.INDENT 3.5
|
128
138
|
.sp
|
129
139
|
.nf
|
130
140
|
.ft C
|
131
141
|
$ knife deps roles/role_name.json
|
132
142
|
.ft P
|
133
143
|
.fi
|
144
|
+
.UNINDENT
|
145
|
+
.UNINDENT
|
146
|
+
.INDENT 0.0
|
147
|
+
.INDENT 3.5
|
134
148
|
.sp
|
135
149
|
.nf
|
136
150
|
.ft C
|
137
151
|
$ knife deps cookbooks/cookbook_name.json
|
138
152
|
.ft P
|
139
153
|
.fi
|
154
|
+
.UNINDENT
|
155
|
+
.UNINDENT
|
156
|
+
.INDENT 0.0
|
157
|
+
.INDENT 3.5
|
140
158
|
.sp
|
141
159
|
.nf
|
142
160
|
.ft C
|
143
161
|
$ knife deps environments/environment_name.json
|
144
162
|
.ft P
|
145
163
|
.fi
|
164
|
+
.UNINDENT
|
165
|
+
.UNINDENT
|
146
166
|
.sp
|
147
167
|
To find the dependencies for a combination of nodes, cookbooks, roles, and/or environments:
|
168
|
+
.INDENT 0.0
|
169
|
+
.INDENT 3.5
|
148
170
|
.sp
|
149
171
|
.nf
|
150
172
|
.ft C
|
151
173
|
$ knife deps cookbooks/git.json cookbooks/github.json roles/base.json environments/desert.json nodes/mynode.json
|
152
174
|
.ft P
|
153
175
|
.fi
|
176
|
+
.UNINDENT
|
177
|
+
.UNINDENT
|
154
178
|
.sp
|
155
179
|
A wildcard can be used to return all of the child nodes. For example, all of the environments:
|
180
|
+
.INDENT 0.0
|
181
|
+
.INDENT 3.5
|
156
182
|
.sp
|
157
183
|
.nf
|
158
184
|
.ft C
|
159
185
|
$ knife deps environments/*.json
|
160
186
|
.ft P
|
161
187
|
.fi
|
188
|
+
.UNINDENT
|
189
|
+
.UNINDENT
|
162
190
|
.sp
|
163
191
|
Use the \fB\-\-tree\fP option to view the results with structure:
|
192
|
+
.INDENT 0.0
|
193
|
+
.INDENT 3.5
|
164
194
|
.sp
|
165
195
|
.nf
|
166
196
|
.ft C
|
167
197
|
$ knife deps roles/webserver.json
|
168
198
|
.ft P
|
169
199
|
.fi
|
200
|
+
.UNINDENT
|
201
|
+
.UNINDENT
|
170
202
|
.sp
|
171
203
|
to return something like:
|
204
|
+
.INDENT 0.0
|
205
|
+
.INDENT 3.5
|
172
206
|
.sp
|
173
207
|
.nf
|
174
208
|
.ft C
|
@@ -180,22 +214,32 @@ roles/webserver.json
|
|
180
214
|
cookbooks/apache2
|
181
215
|
.ft P
|
182
216
|
.fi
|
217
|
+
.UNINDENT
|
218
|
+
.UNINDENT
|
183
219
|
.sp
|
184
220
|
The output of \fBknife deps\fP can be passed to \fBknife upload\fP:
|
221
|
+
.INDENT 0.0
|
222
|
+
.INDENT 3.5
|
185
223
|
.sp
|
186
224
|
.nf
|
187
225
|
.ft C
|
188
226
|
$ knife upload \(gaknife deps nodes/*.json
|
189
227
|
.ft P
|
190
228
|
.fi
|
229
|
+
.UNINDENT
|
230
|
+
.UNINDENT
|
191
231
|
.sp
|
192
232
|
The output of \fBknife deps\fP can be passed to \fBknife xargs\fP:
|
233
|
+
.INDENT 0.0
|
234
|
+
.INDENT 3.5
|
193
235
|
.sp
|
194
236
|
.nf
|
195
237
|
.ft C
|
196
238
|
$ knife deps nodes/*.json | xargs knife upload
|
197
239
|
.ft P
|
198
240
|
.fi
|
241
|
+
.UNINDENT
|
242
|
+
.UNINDENT
|
199
243
|
.SH AUTHOR
|
200
244
|
Chef
|
201
245
|
.\" Generated by docutils manpage writer.
|
@@ -1,4 +1,6 @@
|
|
1
|
-
|
1
|
+
.\" Man page generated from reStructuredText.
|
2
|
+
.
|
3
|
+
.TH "KNIFE-DIFF" "1" "Chef 11.12.0" "" "knife diff"
|
2
4
|
.SH NAME
|
3
5
|
knife-diff \- The man page for the knife diff subcommand.
|
4
6
|
.
|
@@ -28,20 +30,22 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
28
30
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
29
31
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
30
32
|
..
|
31
|
-
.\" Man page generated from reStructuredText.
|
32
|
-
.
|
33
33
|
.sp
|
34
|
-
The \fBknife diff\fP subcommand is used to compare the differences between files and directories on the server and in the chef\-repo
|
34
|
+
The \fBknife diff\fP subcommand is used to compare the differences between files and directories on the Chef server and in the chef\-repo\&. For example, to compare files on the Chef server prior to an uploading or downloading files using the \fBknife download\fP and \fBknife upload\fP subcommands, or to ensure that certain files in multiple production environments are the same. This subcommand is similar to the \fBgit diff\fP command that can be used to diff what is in the chef\-repo with what is synced to a git repository.
|
35
35
|
.sp
|
36
36
|
\fBSyntax\fP
|
37
37
|
.sp
|
38
|
-
This
|
38
|
+
This subcommand has the following syntax:
|
39
|
+
.INDENT 0.0
|
40
|
+
.INDENT 3.5
|
39
41
|
.sp
|
40
42
|
.nf
|
41
43
|
.ft C
|
42
44
|
$ knife diff [PATTERN...] (options)
|
43
45
|
.ft P
|
44
46
|
.fi
|
47
|
+
.UNINDENT
|
48
|
+
.UNINDENT
|
45
49
|
.sp
|
46
50
|
\fBOptions\fP
|
47
51
|
.sp
|
@@ -52,7 +56,7 @@ This subcommand has the following options:
|
|
52
56
|
The configuration file to use.
|
53
57
|
.TP
|
54
58
|
.B \fB\-\-chef\-repo\-path PATH\fP
|
55
|
-
The path to the chef\-repo
|
59
|
+
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.
|
56
60
|
.TP
|
57
61
|
.B \fB\-\-chef\-zero\-port PORT\fP
|
58
62
|
The port on which chef\-zero will listen.
|
@@ -64,7 +68,7 @@ Indicates whether colored output will be used.
|
|
64
68
|
The version of a cookbook to be downloaded.
|
65
69
|
.TP
|
66
70
|
.B \fB\-\-concurrency\fP
|
67
|
-
The number of allowed concurrent connections. Default: \fB10\fP
|
71
|
+
The number of allowed concurrent connections. Default: \fB10\fP\&.
|
68
72
|
.TP
|
69
73
|
.B \fB\-d\fP, \fB\-\-disable\-editing\fP
|
70
74
|
Indicates that $EDITOR will not be opened; data will be accepted as\-is.
|
@@ -73,7 +77,7 @@ Indicates that $EDITOR will not be opened; data will be accepted as\-is.
|
|
73
77
|
Indicates that Knife will use the default value, instead of asking a user to provide one.
|
74
78
|
.TP
|
75
79
|
.B \fB\-\-diff\-filter=[(A|D|M|T)...[*]]\fP
|
76
|
-
Indicates that files will be selected that have been added (\fBA\fP), deleted (\fBD\fP), modified (\fBM\fP), and/or have had their type changed (\fBT\fP). Any combination of filter characters may be used, including no filter characters. Use \fB*\fP to select all paths if a file matches other criteria in the comparison. Default value: \fBnil\fP
|
80
|
+
Indicates that files will be selected that have been added (\fBA\fP), deleted (\fBD\fP), modified (\fBM\fP), and/or have had their type changed (\fBT\fP). Any combination of filter characters may be used, including no filter characters. Use \fB*\fP to select all paths if a file matches other criteria in the comparison. Default value: \fBnil\fP\&.
|
77
81
|
.TP
|
78
82
|
.B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
|
79
83
|
The $EDITOR that is used for all interactive commands.
|
@@ -82,13 +86,13 @@ The $EDITOR that is used for all interactive commands.
|
|
82
86
|
The name of the environment. When this option is added to a command, the command will run only against the named environment.
|
83
87
|
.TP
|
84
88
|
.B \fB\-F FORMAT\fP, \fB\-\-format FORMAT\fP
|
85
|
-
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP
|
89
|
+
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
|
86
90
|
.TP
|
87
91
|
.B \fB\-h\fP, \fB\-\-help\fP
|
88
92
|
Shows help for the command.
|
89
93
|
.TP
|
90
94
|
.B \fB\-k KEY\fP, \fB\-\-key KEY\fP
|
91
|
-
The private key that Knife will use to sign requests made by the API client to the server
|
95
|
+
The private key that Knife will use to sign requests made by the API client to the Chef server\&.
|
92
96
|
.TP
|
93
97
|
.B \fB\-\-name\-only\fP
|
94
98
|
Indicates that only the names of modified files will be shown.
|
@@ -97,22 +101,22 @@ Indicates that only the names of modified files will be shown.
|
|
97
101
|
Indicates that only the names of files with a status of \fBAdded\fP, \fBDeleted\fP, \fBModified\fP, or \fBType Changed\fP will be shown.
|
98
102
|
.TP
|
99
103
|
.B \fB\-\-no\-recurse\fP
|
100
|
-
Use \fB\-\-no\-recurse\fP to disable listing a directory recursively. Default: \fB\-\-recurse\fP
|
104
|
+
Use \fB\-\-no\-recurse\fP to disable listing a directory recursively. Default: \fB\-\-recurse\fP\&.
|
101
105
|
.TP
|
102
106
|
.B \fB\-\-print\-after\fP
|
103
107
|
Indicates that data will be shown after a destructive operation.
|
104
108
|
.TP
|
105
109
|
.B \fB\-\-repo\-mode MODE\fP
|
106
|
-
The layout of the local chef\-repo
|
110
|
+
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\&.
|
107
111
|
.TP
|
108
112
|
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
109
|
-
The URL for the server
|
113
|
+
The URL for the Chef server\&.
|
110
114
|
.TP
|
111
115
|
.B \fB\-u USER\fP, \fB\-\-user USER\fP
|
112
|
-
The user name used by Knife to sign requests made by the API client to the server
|
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.
|
113
117
|
.TP
|
114
118
|
.B \fB\-v\fP, \fB\-\-version\fP
|
115
|
-
The version of the chef\-client
|
119
|
+
The version of the chef\-client\&.
|
116
120
|
.TP
|
117
121
|
.B \fB\-V\fP, \fB\-\-verbose\fP
|
118
122
|
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
@@ -121,7 +125,7 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
|
121
125
|
Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
|
122
126
|
.TP
|
123
127
|
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
124
|
-
Indicates that the chef\-client will be run in local mode, which allows all commands that work against the server to also work against the local chef\-repo
|
128
|
+
Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
|
125
129
|
.UNINDENT
|
126
130
|
.sp
|
127
131
|
\fBknife.rb File Settings\fP
|
@@ -163,30 +167,44 @@ Use to add the \fB\-\-repo\-mode\fP option.
|
|
163
167
|
\fBExamples\fP
|
164
168
|
.sp
|
165
169
|
To compare the "base.json" role to a "webserver.json" role, enter:
|
170
|
+
.INDENT 0.0
|
171
|
+
.INDENT 3.5
|
166
172
|
.sp
|
167
173
|
.nf
|
168
174
|
.ft C
|
169
175
|
$ knife diff roles/base.json roles/webserver.json
|
170
176
|
.ft P
|
171
177
|
.fi
|
178
|
+
.UNINDENT
|
179
|
+
.UNINDENT
|
172
180
|
.sp
|
173
|
-
To compare the differences between the local chef\-repo and the files that are on the server, enter:
|
181
|
+
To compare the differences between the local chef\-repo and the files that are on the Chef server, enter:
|
182
|
+
.INDENT 0.0
|
183
|
+
.INDENT 3.5
|
174
184
|
.sp
|
175
185
|
.nf
|
176
186
|
.ft C
|
177
187
|
$ knife diff
|
178
188
|
.ft P
|
179
189
|
.fi
|
190
|
+
.UNINDENT
|
191
|
+
.UNINDENT
|
180
192
|
.sp
|
181
193
|
To diff a node named \fBnode\-lb\fP and then only return files that have been added, deleted, modified, or changed, enter:
|
194
|
+
.INDENT 0.0
|
195
|
+
.INDENT 3.5
|
182
196
|
.sp
|
183
197
|
.nf
|
184
198
|
.ft C
|
185
199
|
$ knife diff \-\-name\-status node\-lb
|
186
200
|
.ft P
|
187
201
|
.fi
|
202
|
+
.UNINDENT
|
203
|
+
.UNINDENT
|
188
204
|
.sp
|
189
205
|
to return something like:
|
206
|
+
.INDENT 0.0
|
207
|
+
.INDENT 3.5
|
190
208
|
.sp
|
191
209
|
.nf
|
192
210
|
.ft C
|
@@ -200,6 +218,8 @@ node\-lb/.gitignore
|
|
200
218
|
node\-lb/Rakefile
|
201
219
|
.ft P
|
202
220
|
.fi
|
221
|
+
.UNINDENT
|
222
|
+
.UNINDENT
|
203
223
|
.SH AUTHOR
|
204
224
|
Chef
|
205
225
|
.\" Generated by docutils manpage writer.
|