chef 11.12.8 → 11.14.0.alpha.2
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 +164 -151
- 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-DOWNLOAD" "1" "Chef 11.12.0" "" "knife download"
|
2
4
|
.SH NAME
|
3
5
|
knife-download \- The man page for the knife download 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 download\fP subcommand is used to download roles, cookbooks, environments, nodes, and data bags from the server to the current working directory. It can be used to back up data on the server, inspect the state of one or more files, or to extract out\-of\-process changes users may have made to files on the server, such as if a user made a change that bypassed version source control. This subcommand is often used in conjunction with \fBknife diff\fP, which can be used to see exactly what changes will be downloaded, and then \fBknife upload\fP, which does the opposite of \fBknife download\fP
|
34
|
+
The \fBknife download\fP subcommand is used to download roles, cookbooks, environments, nodes, and data bags from the Chef server to the current working directory. It can be used to back up data on the Chef server, inspect the state of one or more files, or to extract out\-of\-process changes users may have made to files on the Chef server, such as if a user made a change that bypassed version source control. This subcommand is often used in conjunction with \fBknife diff\fP, which can be used to see exactly what changes will be downloaded, and then \fBknife upload\fP, which does the opposite of \fBknife download\fP\&.
|
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 download [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.
|
@@ -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\-\-cookbook\-version VERSION\fP
|
67
71
|
The version of a cookbook to be downloaded.
|
@@ -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\-\-[no\-]diff\fP
|
76
|
-
Indicates that only new and modified files will be downloaded. Set to \fBfalse\fP to download all files. Default: \fB\-\-diff\fP
|
80
|
+
Indicates that only new and modified files will be downloaded. Set to \fBfalse\fP to download all files. Default: \fB\-\-diff\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,40 +86,40 @@ 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\-\-[no\-]force\fP
|
88
|
-
Use \fB\-\-force\fP to download files even when the file on the hard drive is identical to the object on the server (role, cookbook, etc.).
|
92
|
+
Use \fB\-\-force\fP to download files even when the file on the hard drive is identical to the object on the server (role, cookbook, etc.). By default, files are compared to see if they have equivalent content, and local files are only overwritten if they are different. Default: \fB\-\-no\-force\fP\&.
|
89
93
|
.TP
|
90
94
|
.B \fB\-h\fP, \fB\-\-help\fP
|
91
95
|
Shows help for the command.
|
92
96
|
.TP
|
93
97
|
.B \fB\-k KEY\fP, \fB\-\-key KEY\fP
|
94
|
-
The private key that Knife will use to sign requests made by the API client to the server
|
98
|
+
The private key that Knife will use to sign requests made by the API client to the Chef server\&.
|
95
99
|
.TP
|
96
100
|
.B \fB\-n\fP, \fB\-\-dry\-run\fP
|
97
|
-
Indicates that no action is taken and that results are only printed out. Default: \fBfalse\fP
|
101
|
+
Indicates that no action is taken and that results are only printed out. Default: \fBfalse\fP\&.
|
98
102
|
.TP
|
99
103
|
.B \fB\-\-print\-after\fP
|
100
104
|
Indicates that data will be shown after a destructive operation.
|
101
105
|
.TP
|
102
106
|
.B \fB\-\-[no\-]purge\fP
|
103
|
-
Use \fB\-\-purge\fP to delete local files and directories that do not exist on the server
|
107
|
+
Use \fB\-\-purge\fP to delete local files and directories that do not exist on the Chef server\&. By default, if a role, cookbook, etc. does not exist on the Chef server, the local file for said role will be left alone and NOT deleted. Default: \fB\-\-no\-purge\fP\&.
|
104
108
|
.TP
|
105
109
|
.B \fB\-\-[no\-]recurse\fP
|
106
|
-
Use \fB\-\-no\-recurse\fP to disable downloading a directory recursively. Default: \fB\-\-recurse\fP
|
110
|
+
Use \fB\-\-no\-recurse\fP to disable downloading a directory recursively. Default: \fB\-\-recurse\fP\&.
|
107
111
|
.TP
|
108
112
|
.B \fB\-\-repo\-mode MODE\fP
|
109
|
-
The layout of the local chef\-repo
|
113
|
+
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\&.
|
110
114
|
.TP
|
111
115
|
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
112
|
-
The URL for the server
|
116
|
+
The URL for the Chef server\&.
|
113
117
|
.TP
|
114
118
|
.B \fB\-u USER\fP, \fB\-\-user USER\fP
|
115
|
-
The user name used by Knife to sign requests made by the API client to the server
|
119
|
+
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.
|
116
120
|
.TP
|
117
121
|
.B \fB\-v\fP, \fB\-\-version\fP
|
118
|
-
The version of the chef\-client
|
122
|
+
The version of the chef\-client\&.
|
119
123
|
.TP
|
120
124
|
.B \fB\-V\fP, \fB\-\-verbose\fP
|
121
125
|
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
@@ -124,90 +128,130 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
|
124
128
|
Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
|
125
129
|
.TP
|
126
130
|
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
127
|
-
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
|
131
|
+
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\&.
|
128
132
|
.UNINDENT
|
129
133
|
.sp
|
130
134
|
\fBExamples\fP
|
131
135
|
.sp
|
132
|
-
To download the entire chef\-repo from the server, browse to the top level of the chef\-repo and enter:
|
136
|
+
To download the entire chef\-repo from the Chef server, browse to the top level of the chef\-repo and enter:
|
137
|
+
.INDENT 0.0
|
138
|
+
.INDENT 3.5
|
133
139
|
.sp
|
134
140
|
.nf
|
135
141
|
.ft C
|
136
142
|
$ knife download /
|
137
143
|
.ft P
|
138
144
|
.fi
|
145
|
+
.UNINDENT
|
146
|
+
.UNINDENT
|
139
147
|
.sp
|
140
|
-
To download the \fBcookbooks/\fP directory from the server, browse to the top level of the chef\-repo and enter:
|
148
|
+
To download the \fBcookbooks/\fP directory from the Chef server, browse to the top level of the chef\-repo and enter:
|
149
|
+
.INDENT 0.0
|
150
|
+
.INDENT 3.5
|
141
151
|
.sp
|
142
152
|
.nf
|
143
153
|
.ft C
|
144
154
|
$ knife download cookbooks
|
145
155
|
.ft P
|
146
156
|
.fi
|
157
|
+
.UNINDENT
|
158
|
+
.UNINDENT
|
147
159
|
.sp
|
148
160
|
or from anywhere in the chef\-repo, enter:
|
161
|
+
.INDENT 0.0
|
162
|
+
.INDENT 3.5
|
149
163
|
.sp
|
150
164
|
.nf
|
151
165
|
.ft C
|
152
166
|
$ knife download /cookbooks
|
153
167
|
.ft P
|
154
168
|
.fi
|
169
|
+
.UNINDENT
|
170
|
+
.UNINDENT
|
155
171
|
.sp
|
156
|
-
To download the \fBenvironments/\fP directory from the server, browse to the top level of the chef\-repo and enter:
|
172
|
+
To download the \fBenvironments/\fP directory from the Chef server, browse to the top level of the chef\-repo and enter:
|
173
|
+
.INDENT 0.0
|
174
|
+
.INDENT 3.5
|
157
175
|
.sp
|
158
176
|
.nf
|
159
177
|
.ft C
|
160
178
|
$ knife download environments
|
161
179
|
.ft P
|
162
180
|
.fi
|
181
|
+
.UNINDENT
|
182
|
+
.UNINDENT
|
163
183
|
.sp
|
164
184
|
or from anywhere in the chef\-repo, enter:
|
185
|
+
.INDENT 0.0
|
186
|
+
.INDENT 3.5
|
165
187
|
.sp
|
166
188
|
.nf
|
167
189
|
.ft C
|
168
190
|
$ knife download /environments
|
169
191
|
.ft P
|
170
192
|
.fi
|
193
|
+
.UNINDENT
|
194
|
+
.UNINDENT
|
171
195
|
.sp
|
172
|
-
To download an environment named "production" from the server, browse to the top level of the chef\-repo and enter:
|
196
|
+
To download an environment named "production" from the Chef server, browse to the top level of the chef\-repo and enter:
|
197
|
+
.INDENT 0.0
|
198
|
+
.INDENT 3.5
|
173
199
|
.sp
|
174
200
|
.nf
|
175
201
|
.ft C
|
176
202
|
$ knife download environments/production.json
|
177
203
|
.ft P
|
178
204
|
.fi
|
205
|
+
.UNINDENT
|
206
|
+
.UNINDENT
|
179
207
|
.sp
|
180
208
|
or from the \fBenvironments/\fP directory, enter:
|
209
|
+
.INDENT 0.0
|
210
|
+
.INDENT 3.5
|
181
211
|
.sp
|
182
212
|
.nf
|
183
213
|
.ft C
|
184
214
|
$ knife download production.json
|
185
215
|
.ft P
|
186
216
|
.fi
|
217
|
+
.UNINDENT
|
218
|
+
.UNINDENT
|
187
219
|
.sp
|
188
|
-
To download the \fBroles/\fP directory from the server, browse to the top level of the chef\-repo and enter:
|
220
|
+
To download the \fBroles/\fP directory from the Chef server, browse to the top level of the chef\-repo and enter:
|
221
|
+
.INDENT 0.0
|
222
|
+
.INDENT 3.5
|
189
223
|
.sp
|
190
224
|
.nf
|
191
225
|
.ft C
|
192
226
|
$ knife download roles
|
193
227
|
.ft P
|
194
228
|
.fi
|
229
|
+
.UNINDENT
|
230
|
+
.UNINDENT
|
195
231
|
.sp
|
196
232
|
or from anywhere in the chef\-repo, enter:
|
233
|
+
.INDENT 0.0
|
234
|
+
.INDENT 3.5
|
197
235
|
.sp
|
198
236
|
.nf
|
199
237
|
.ft C
|
200
238
|
$ knife download /roles
|
201
239
|
.ft P
|
202
240
|
.fi
|
241
|
+
.UNINDENT
|
242
|
+
.UNINDENT
|
203
243
|
.sp
|
204
244
|
To download all cookbooks that start with "apache" and belong to the "webserver" role, browse to the top level of the chef\-repo and enter:
|
245
|
+
.INDENT 0.0
|
246
|
+
.INDENT 3.5
|
205
247
|
.sp
|
206
248
|
.nf
|
207
249
|
.ft C
|
208
250
|
$ knife download cookbooks/apache\e* roles/webserver.json
|
209
251
|
.ft P
|
210
252
|
.fi
|
253
|
+
.UNINDENT
|
254
|
+
.UNINDENT
|
211
255
|
.SH AUTHOR
|
212
256
|
Chef
|
213
257
|
.\" Generated by docutils manpage writer.
|
@@ -1,4 +1,6 @@
|
|
1
|
-
|
1
|
+
.\" Man page generated from reStructuredText.
|
2
|
+
.
|
3
|
+
.TH "KNIFE-EDIT" "1" "Chef 11.12.0" "" "knife edit"
|
2
4
|
.SH NAME
|
3
5
|
knife-edit \- The man page for the knife edit 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 edit\fP subcommand is used to edit objects on the server
|
34
|
+
The \fBknife edit\fP subcommand is used to edit objects on the Chef server\&. This subcommand works similar to \fBknife cookbook edit\fP, \fBknife data bag edit\fP, \fBknife environment edit\fP, \fBknife node edit\fP, and \fBknife role edit\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 edit (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,31 +80,31 @@ 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\-\-local\fP
|
88
|
-
Use to show files in the local chef\-repo instead of a remote location. Default: \fBfalse\fP
|
92
|
+
Use to show files in the local chef\-repo instead of a remote location. Default: \fBfalse\fP\&.
|
89
93
|
.TP
|
90
94
|
.B \fB\-\-print\-after\fP
|
91
95
|
Indicates that data will be shown after a destructive operation.
|
92
96
|
.TP
|
93
97
|
.B \fB\-\-repo\-mode MODE\fP
|
94
|
-
The layout of the local chef\-repo
|
98
|
+
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\&.
|
95
99
|
.TP
|
96
100
|
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
97
|
-
The URL for the server
|
101
|
+
The URL for the Chef server\&.
|
98
102
|
.TP
|
99
103
|
.B \fB\-u USER\fP, \fB\-\-user USER\fP
|
100
|
-
The user name used by Knife to sign requests made by the API client to the server
|
104
|
+
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.
|
101
105
|
.TP
|
102
106
|
.B \fB\-v\fP, \fB\-\-version\fP
|
103
|
-
The version of the chef\-client
|
107
|
+
The version of the chef\-client\&.
|
104
108
|
.TP
|
105
109
|
.B \fB\-V\fP, \fB\-\-verbose\fP
|
106
110
|
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
@@ -109,7 +113,7 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
|
109
113
|
Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
|
110
114
|
.TP
|
111
115
|
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
112
|
-
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
|
116
|
+
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\&.
|
113
117
|
.UNINDENT
|
114
118
|
.SH AUTHOR
|
115
119
|
Chef
|
@@ -1,4 +1,6 @@
|
|
1
|
-
|
1
|
+
.\" Man page generated from reStructuredText.
|
2
|
+
.
|
3
|
+
.TH "KNIFE-ENVIRONMENT" "1" "Chef 11.12.0" "" "knife environment"
|
2
4
|
.SH NAME
|
3
5
|
knife-environment \- The man page for the knife environment subcommand.
|
4
6
|
.
|
@@ -28,12 +30,10 @@ 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
|
-
An environment is a way to map an organization\(aqs real\-life workflow to what can be configured and managed when using server
|
34
|
+
An environment is a way to map an organization\(aqs real\-life workflow to what can be configured and managed when using Chef server\&. Every organization begins with a single environment called the \fB_default\fP environment, which cannot be modified (or deleted). Additional environments can be created to reflect each organization\(aqs patterns and workflow. For example, creating \fBproduction\fP, \fBstaging\fP, \fBtesting\fP, and \fBdevelopment\fP environments. Generally, an environment is also associated with one (or more) cookbook versions.
|
35
35
|
.sp
|
36
|
-
The \fBknife environment\fP subcommand is used to manage environments within a single organization on the server
|
36
|
+
The \fBknife environment\fP subcommand is used to manage environments within a single organization on the Chef server\&.
|
37
37
|
.SH COMMON OPTIONS
|
38
38
|
.sp
|
39
39
|
The following options may be used with any of the arguments available to the \fBknife environment\fP subcommand:
|
@@ -58,13 +58,13 @@ The $EDITOR that is used for all interactive commands.
|
|
58
58
|
The name of the environment. When this option is added to a command, the command will run only against the named environment.
|
59
59
|
.TP
|
60
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
|
61
|
+
The output format: \fBsummary\fP (default), \fBtext\fP, \fBjson\fP, \fByaml\fP, and \fBpp\fP\&.
|
62
62
|
.TP
|
63
63
|
.B \fB\-h\fP, \fB\-\-help\fP
|
64
64
|
Shows help for the command.
|
65
65
|
.TP
|
66
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 server
|
67
|
+
The private key that Knife will use to sign requests made by the API client to the Chef server\&.
|
68
68
|
.TP
|
69
69
|
.B \fB\-\-[no\-]color\fP
|
70
70
|
Indicates whether colored output will be used.
|
@@ -73,22 +73,22 @@ Indicates whether colored output will be used.
|
|
73
73
|
Indicates that data will be shown after a destructive operation.
|
74
74
|
.TP
|
75
75
|
.B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
|
76
|
-
The URL for the server
|
76
|
+
The URL for the Chef server\&.
|
77
77
|
.TP
|
78
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 server
|
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
80
|
.TP
|
81
81
|
.B \fB\-V\fP, \fB\-\-verbose\fP
|
82
82
|
Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
|
83
83
|
.TP
|
84
84
|
.B \fB\-v\fP, \fB\-\-version\fP
|
85
|
-
The version of the chef\-client
|
85
|
+
The version of the chef\-client\&.
|
86
86
|
.TP
|
87
87
|
.B \fB\-y\fP, \fB\-\-yes\fP
|
88
88
|
Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
|
89
89
|
.TP
|
90
90
|
.B \fB\-z\fP, \fB\-\-local\-mode\fP
|
91
|
-
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
|
91
|
+
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\&.
|
92
92
|
.UNINDENT
|
93
93
|
.SH COMPARE
|
94
94
|
.sp
|
@@ -97,12 +97,16 @@ The \fBcompare\fP argument is used to compare the cookbook version constraints t
|
|
97
97
|
\fBSyntax\fP
|
98
98
|
.sp
|
99
99
|
This argument has the following syntax:
|
100
|
+
.INDENT 0.0
|
101
|
+
.INDENT 3.5
|
100
102
|
.sp
|
101
103
|
.nf
|
102
104
|
.ft C
|
103
105
|
$ knife environment compare [ENVIRONMENT_NAME...] (options)
|
104
106
|
.ft P
|
105
107
|
.fi
|
108
|
+
.UNINDENT
|
109
|
+
.UNINDENT
|
106
110
|
.sp
|
107
111
|
\fBOptions\fP
|
108
112
|
.sp
|
@@ -119,14 +123,20 @@ Use to show only matching versions.
|
|
119
123
|
\fBExample\fP
|
120
124
|
.sp
|
121
125
|
To compare cookbook versions for a single environment:
|
126
|
+
.INDENT 0.0
|
127
|
+
.INDENT 3.5
|
122
128
|
.sp
|
123
129
|
.nf
|
124
130
|
.ft C
|
125
131
|
$ knife environment compare development
|
126
132
|
.ft P
|
127
133
|
.fi
|
134
|
+
.UNINDENT
|
135
|
+
.UNINDENT
|
128
136
|
.sp
|
129
137
|
to return something similar to:
|
138
|
+
.INDENT 0.0
|
139
|
+
.INDENT 3.5
|
130
140
|
.sp
|
131
141
|
.nf
|
132
142
|
.ft C
|
@@ -135,16 +145,24 @@ apache 2.3.1
|
|
135
145
|
windows 4.1.2
|
136
146
|
.ft P
|
137
147
|
.fi
|
148
|
+
.UNINDENT
|
149
|
+
.UNINDENT
|
138
150
|
.sp
|
139
151
|
To compare cookbook versions for multiple environments:
|
152
|
+
.INDENT 0.0
|
153
|
+
.INDENT 3.5
|
140
154
|
.sp
|
141
155
|
.nf
|
142
156
|
.ft C
|
143
157
|
$ knife environment compare development staging
|
144
158
|
.ft P
|
145
159
|
.fi
|
160
|
+
.UNINDENT
|
161
|
+
.UNINDENT
|
146
162
|
.sp
|
147
163
|
to return something similar to:
|
164
|
+
.INDENT 0.0
|
165
|
+
.INDENT 3.5
|
148
166
|
.sp
|
149
167
|
.nf
|
150
168
|
.ft C
|
@@ -154,16 +172,24 @@ windows 4.1.2 1.0.0
|
|
154
172
|
postgresql 1.0.0 1.0.0
|
155
173
|
.ft P
|
156
174
|
.fi
|
175
|
+
.UNINDENT
|
176
|
+
.UNINDENT
|
157
177
|
.sp
|
158
178
|
To compare all cookbook versions for all environments:
|
179
|
+
.INDENT 0.0
|
180
|
+
.INDENT 3.5
|
159
181
|
.sp
|
160
182
|
.nf
|
161
183
|
.ft C
|
162
184
|
$ knife environment compare \-\-all
|
163
185
|
.ft P
|
164
186
|
.fi
|
187
|
+
.UNINDENT
|
188
|
+
.UNINDENT
|
165
189
|
.sp
|
166
190
|
to return something similar to:
|
191
|
+
.INDENT 0.0
|
192
|
+
.INDENT 3.5
|
167
193
|
.sp
|
168
194
|
.nf
|
169
195
|
.ft C
|
@@ -197,19 +223,25 @@ chef_handler latest latest
|
|
197
223
|
windows 1.0.0 4.1.2
|
198
224
|
.ft P
|
199
225
|
.fi
|
226
|
+
.UNINDENT
|
227
|
+
.UNINDENT
|
200
228
|
.SH CREATE
|
201
229
|
.sp
|
202
|
-
The \fBcreate\fP argument is used to add an environment object to the server
|
230
|
+
The \fBcreate\fP argument is used to add an environment object to the Chef server\&. When this argument is run, Knife will open $EDITOR to enable editing of the \fBENVIRONMENT\fP description field (unless a description is specified as part of the command). When finished, Knife will add the environment to the Chef server\&.
|
203
231
|
.sp
|
204
232
|
\fBSyntax\fP
|
205
233
|
.sp
|
206
234
|
This argument has the following syntax:
|
235
|
+
.INDENT 0.0
|
236
|
+
.INDENT 3.5
|
207
237
|
.sp
|
208
238
|
.nf
|
209
239
|
.ft C
|
210
240
|
$ knife environment create ENVIRONMENT_NAME \-d DESCRIPTION
|
211
241
|
.ft P
|
212
242
|
.fi
|
243
|
+
.UNINDENT
|
244
|
+
.UNINDENT
|
213
245
|
.sp
|
214
246
|
\fBOptions\fP
|
215
247
|
.sp
|
@@ -217,31 +249,39 @@ This argument has the following options:
|
|
217
249
|
.INDENT 0.0
|
218
250
|
.TP
|
219
251
|
.B \fB\-d DESCRIPTION\fP, \fB\-\-description DESCRIPTION\fP
|
220
|
-
The description of the environment. This value will populate the description field for the environment on the server
|
252
|
+
The description of the environment. This value will populate the description field for the environment on the Chef server\&.
|
221
253
|
.UNINDENT
|
222
254
|
.sp
|
223
255
|
\fBExamples\fP
|
224
256
|
.sp
|
225
257
|
To create an environment named "dev" with a description of "The development environment.":
|
258
|
+
.INDENT 0.0
|
259
|
+
.INDENT 3.5
|
226
260
|
.sp
|
227
261
|
.nf
|
228
262
|
.ft C
|
229
263
|
$ knife environment create dev \-d "The development environment."
|
230
264
|
.ft P
|
231
265
|
.fi
|
266
|
+
.UNINDENT
|
267
|
+
.UNINDENT
|
232
268
|
.SH DELETE
|
233
269
|
.sp
|
234
|
-
The \fBdelete\fP argument is used to delete an environment from a server
|
270
|
+
The \fBdelete\fP argument is used to delete an environment from a Chef server\&.
|
235
271
|
.sp
|
236
272
|
\fBSyntax\fP
|
237
273
|
.sp
|
238
274
|
This argument has the following syntax:
|
275
|
+
.INDENT 0.0
|
276
|
+
.INDENT 3.5
|
239
277
|
.sp
|
240
278
|
.nf
|
241
279
|
.ft C
|
242
280
|
$ knife environment delete ENVIRONMENT_NAME
|
243
281
|
.ft P
|
244
282
|
.fi
|
283
|
+
.UNINDENT
|
284
|
+
.UNINDENT
|
245
285
|
.sp
|
246
286
|
\fBOptions\fP
|
247
287
|
.sp
|
@@ -250,27 +290,35 @@ This command does not have any specific options.
|
|
250
290
|
\fBExamples\fP
|
251
291
|
.sp
|
252
292
|
To delete an environment named "dev", enter:
|
293
|
+
.INDENT 0.0
|
294
|
+
.INDENT 3.5
|
253
295
|
.sp
|
254
296
|
.nf
|
255
297
|
.ft C
|
256
298
|
$ knife environment delete dev
|
257
299
|
.ft P
|
258
300
|
.fi
|
301
|
+
.UNINDENT
|
302
|
+
.UNINDENT
|
259
303
|
.sp
|
260
304
|
Type \fBY\fP to confirm a deletion.
|
261
305
|
.SH EDIT
|
262
306
|
.sp
|
263
|
-
The \fBedit\fP argument is used to edit the attributes of an environment. When this argument is run, Knife will open $EDITOR to enable editing of \fBENVIRONMENT\fP attributes. When finished, Knife will update the server with those changes.
|
307
|
+
The \fBedit\fP argument is used to edit the attributes of an environment. When this argument is run, Knife will open $EDITOR to enable editing of \fBENVIRONMENT\fP attributes. When finished, Knife will update the Chef server with those changes.
|
264
308
|
.sp
|
265
309
|
\fBSyntax\fP
|
266
310
|
.sp
|
267
311
|
This argument has the following syntax:
|
312
|
+
.INDENT 0.0
|
313
|
+
.INDENT 3.5
|
268
314
|
.sp
|
269
315
|
.nf
|
270
316
|
.ft C
|
271
317
|
$ knife environment edit ENVIRONMENT_NAME
|
272
318
|
.ft P
|
273
319
|
.fi
|
320
|
+
.UNINDENT
|
321
|
+
.UNINDENT
|
274
322
|
.sp
|
275
323
|
\fBOptions\fP
|
276
324
|
.sp
|
@@ -279,12 +327,16 @@ This command does not have any specific options.
|
|
279
327
|
\fBExamples\fP
|
280
328
|
.sp
|
281
329
|
To edit an environment named "devops", enter:
|
330
|
+
.INDENT 0.0
|
331
|
+
.INDENT 3.5
|
282
332
|
.sp
|
283
333
|
.nf
|
284
334
|
.ft C
|
285
335
|
$ knife environment edit devops
|
286
336
|
.ft P
|
287
337
|
.fi
|
338
|
+
.UNINDENT
|
339
|
+
.UNINDENT
|
288
340
|
.SH FROM FILE
|
289
341
|
.sp
|
290
342
|
The \fBfrom file\fP argument is used to add or update an environment using a JSON or Ruby DSL description. It must be run with the \fBcreate\fP or \fBedit\fP arguments.
|
@@ -292,12 +344,16 @@ The \fBfrom file\fP argument is used to add or update an environment using a JSO
|
|
292
344
|
\fBSyntax\fP
|
293
345
|
.sp
|
294
346
|
This argument has the following syntax:
|
347
|
+
.INDENT 0.0
|
348
|
+
.INDENT 3.5
|
295
349
|
.sp
|
296
350
|
.nf
|
297
351
|
.ft C
|
298
352
|
$ knife environment [create | edit] from file FILE (options)
|
299
353
|
.ft P
|
300
354
|
.fi
|
355
|
+
.UNINDENT
|
356
|
+
.UNINDENT
|
301
357
|
.sp
|
302
358
|
\fBOptions\fP
|
303
359
|
.sp
|
@@ -311,33 +367,45 @@ Indicates that all environments found at the specified path will be uploaded.
|
|
311
367
|
\fBExamples\fP
|
312
368
|
.sp
|
313
369
|
To add an environment using data contained in a JSON file:
|
370
|
+
.INDENT 0.0
|
371
|
+
.INDENT 3.5
|
314
372
|
.sp
|
315
373
|
.nf
|
316
374
|
.ft C
|
317
375
|
$ knife environment create devops from file "path to JSON file"
|
318
376
|
.ft P
|
319
377
|
.fi
|
378
|
+
.UNINDENT
|
379
|
+
.UNINDENT
|
320
380
|
.sp
|
321
381
|
or:
|
382
|
+
.INDENT 0.0
|
383
|
+
.INDENT 3.5
|
322
384
|
.sp
|
323
385
|
.nf
|
324
386
|
.ft C
|
325
387
|
$ knife environment edit devops from file "path to JSON file"
|
326
388
|
.ft P
|
327
389
|
.fi
|
390
|
+
.UNINDENT
|
391
|
+
.UNINDENT
|
328
392
|
.SH LIST
|
329
393
|
.sp
|
330
|
-
The \fBlist\fP argument is used to list all of the environments that are currently available on the server
|
394
|
+
The \fBlist\fP argument is used to list all of the environments that are currently available on the Chef server\&.
|
331
395
|
.sp
|
332
396
|
\fBSyntax\fP
|
333
397
|
.sp
|
334
398
|
This argument has the following syntax:
|
399
|
+
.INDENT 0.0
|
400
|
+
.INDENT 3.5
|
335
401
|
.sp
|
336
402
|
.nf
|
337
403
|
.ft C
|
338
404
|
$ knife environment list \-w
|
339
405
|
.ft P
|
340
406
|
.fi
|
407
|
+
.UNINDENT
|
408
|
+
.UNINDENT
|
341
409
|
.sp
|
342
410
|
\fBOptions\fP
|
343
411
|
.sp
|
@@ -351,12 +419,16 @@ Indicates that the corresponding URIs will be shown.
|
|
351
419
|
\fBExamples\fP
|
352
420
|
.sp
|
353
421
|
To view a list of environments:
|
422
|
+
.INDENT 0.0
|
423
|
+
.INDENT 3.5
|
354
424
|
.sp
|
355
425
|
.nf
|
356
426
|
.ft C
|
357
427
|
$ knife environment list \-w
|
358
428
|
.ft P
|
359
429
|
.fi
|
430
|
+
.UNINDENT
|
431
|
+
.UNINDENT
|
360
432
|
.SH SHOW
|
361
433
|
.sp
|
362
434
|
The \fBshow\fP argument is used to display information about the specified environment.
|
@@ -364,12 +436,16 @@ The \fBshow\fP argument is used to display information about the specified envir
|
|
364
436
|
\fBSyntax\fP
|
365
437
|
.sp
|
366
438
|
This argument has the following syntax:
|
439
|
+
.INDENT 0.0
|
440
|
+
.INDENT 3.5
|
367
441
|
.sp
|
368
442
|
.nf
|
369
443
|
.ft C
|
370
444
|
$ knife environment show ENVIRONMENT_NAME
|
371
445
|
.ft P
|
372
446
|
.fi
|
447
|
+
.UNINDENT
|
448
|
+
.UNINDENT
|
373
449
|
.sp
|
374
450
|
\fBOptions\fP
|
375
451
|
.sp
|
@@ -378,14 +454,20 @@ This command does not have any specific options.
|
|
378
454
|
\fBExamples\fP
|
379
455
|
.sp
|
380
456
|
To view information about the "dev" environment enter:
|
457
|
+
.INDENT 0.0
|
458
|
+
.INDENT 3.5
|
381
459
|
.sp
|
382
460
|
.nf
|
383
461
|
.ft C
|
384
462
|
$ knife environment show dev
|
385
463
|
.ft P
|
386
464
|
.fi
|
465
|
+
.UNINDENT
|
466
|
+
.UNINDENT
|
387
467
|
.sp
|
388
468
|
to return:
|
469
|
+
.INDENT 0.0
|
470
|
+
.INDENT 3.5
|
389
471
|
.sp
|
390
472
|
.nf
|
391
473
|
.ft C
|
@@ -404,16 +486,22 @@ override_attributes:
|
|
404
486
|
\e\e
|
405
487
|
.ft P
|
406
488
|
.fi
|
489
|
+
.UNINDENT
|
490
|
+
.UNINDENT
|
407
491
|
.sp
|
408
492
|
To view information in JSON format, use the \fB\-F\fP common option as part of the command like this:
|
493
|
+
.INDENT 0.0
|
494
|
+
.INDENT 3.5
|
409
495
|
.sp
|
410
496
|
.nf
|
411
497
|
.ft C
|
412
498
|
$ knife role show devops \-F json
|
413
499
|
.ft P
|
414
500
|
.fi
|
501
|
+
.UNINDENT
|
502
|
+
.UNINDENT
|
415
503
|
.sp
|
416
|
-
Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP
|
504
|
+
Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP\&.
|
417
505
|
.SH AUTHOR
|
418
506
|
Chef
|
419
507
|
.\" Generated by docutils manpage writer.
|