chef 11.6.0 → 11.6.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +6 -14
- data/Rakefile +12 -4
- data/distro/common/html/chef-client.8.html +4 -4
- data/distro/common/html/chef-expander.8.html +4 -4
- data/distro/common/html/chef-expanderctl.8.html +4 -4
- data/distro/common/html/chef-server-webui.8.html +4 -4
- data/distro/common/html/chef-server.8.html +4 -4
- data/distro/common/html/chef-shell.1.html +4 -4
- data/distro/common/html/chef-solo.8.html +4 -4
- data/distro/common/html/chef-solr.8.html +5 -5
- data/distro/common/html/knife-bootstrap.1.html +4 -4
- data/distro/common/html/knife-client.1.html +4 -4
- data/distro/common/html/knife-configure.1.html +4 -4
- data/distro/common/html/knife-cookbook-site.1.html +4 -4
- data/distro/common/html/knife-cookbook.1.html +4 -4
- data/distro/common/html/knife-data-bag.1.html +4 -4
- data/distro/common/html/knife-environment.1.html +4 -4
- data/distro/common/html/knife-exec.1.html +4 -4
- data/distro/common/html/knife-index.1.html +4 -4
- data/distro/common/html/knife-node.1.html +4 -4
- data/distro/common/html/knife-role.1.html +4 -4
- data/distro/common/html/knife-search.1.html +4 -4
- data/distro/common/html/knife-ssh.1.html +4 -4
- data/distro/common/html/knife-status.1.html +4 -4
- data/distro/common/html/knife-tag.1.html +4 -4
- data/distro/common/html/knife.1.html +4 -4
- data/distro/common/man/man1/chef-shell.1 +1 -1
- data/distro/common/man/man1/knife-bootstrap.1 +1 -1
- data/distro/common/man/man1/knife-client.1 +0 -99
- data/distro/common/man/man1/knife-configure.1 +1 -1
- data/distro/common/man/man1/knife-cookbook-site.1 +1 -1
- data/distro/common/man/man1/knife-cookbook.1 +1 -1
- data/distro/common/man/man1/knife-data-bag.1 +1 -1
- data/distro/common/man/man1/knife-environment.1 +0 -168
- data/distro/common/man/man1/knife-exec.1 +1 -1
- data/distro/common/man/man1/knife-index.1 +1 -1
- data/distro/common/man/man1/knife-node.1 +1 -1
- data/distro/common/man/man1/knife-role.1 +1 -1
- data/distro/common/man/man1/knife-search.1 +1 -1
- data/distro/common/man/man1/knife-ssh.1 +1 -1
- data/distro/common/man/man1/knife-status.1 +1 -1
- data/distro/common/man/man1/knife-tag.1 +1 -1
- data/distro/common/man/man1/knife.1 +1 -1
- data/distro/common/man/man8/chef-client.8 +1 -1
- data/distro/common/man/man8/chef-expander.8 +1 -1
- data/distro/common/man/man8/chef-expanderctl.8 +1 -1
- data/distro/common/man/man8/chef-server-webui.8 +1 -1
- data/distro/common/man/man8/chef-server.8 +1 -1
- data/distro/common/man/man8/chef-solo.8 +1 -1
- data/distro/common/man/man8/chef-solr.8 +1 -1
- data/lib/chef/deprecation/provider/template.rb +1 -1
- data/lib/chef/provider/remote_file/cache_control_data.rb +4 -1
- data/lib/chef/version.rb +3 -3
- data/lib/chef/win32/api/file.rb +7 -0
- data/spec/data/apt/chef-integration-test-1.0/debian/changelog +5 -0
- data/spec/data/apt/chef-integration-test-1.0/debian/compat +1 -0
- data/spec/data/apt/chef-integration-test-1.0/debian/control +13 -0
- data/spec/data/apt/chef-integration-test-1.0/debian/copyright +34 -0
- data/spec/data/apt/chef-integration-test-1.0/debian/files +1 -0
- data/spec/data/apt/chef-integration-test-1.0/debian/rules +13 -0
- data/spec/data/apt/chef-integration-test-1.0/debian/source/format +1 -0
- data/spec/data/apt/chef-integration-test-1.1/debian/changelog +11 -0
- data/spec/data/apt/chef-integration-test-1.1/debian/compat +1 -0
- data/spec/data/apt/chef-integration-test-1.1/debian/control +13 -0
- data/spec/data/apt/chef-integration-test-1.1/debian/copyright +34 -0
- data/spec/data/apt/chef-integration-test-1.1/debian/files +1 -0
- data/spec/data/apt/chef-integration-test-1.1/debian/rules +13 -0
- data/spec/data/apt/chef-integration-test-1.1/debian/source/format +1 -0
- data/spec/data/apt/chef-integration-test_1.0-1_amd64.changes +22 -0
- data/spec/data/apt/chef-integration-test_1.0-1_amd64.deb +0 -0
- data/spec/data/apt/chef-integration-test_1.0.orig.tar.gz +0 -0
- data/spec/data/apt/chef-integration-test_1.1-1_amd64.changes +22 -0
- data/spec/data/apt/chef-integration-test_1.1-1_amd64.deb +0 -0
- data/spec/data/apt/chef-integration-test_1.1.orig.tar.gz +0 -0
- data/spec/data/apt/var/www/apt/conf/distributions +7 -0
- data/spec/data/apt/var/www/apt/conf/incoming +4 -0
- data/spec/data/apt/var/www/apt/conf/pulls +3 -0
- data/spec/data/apt/var/www/apt/db/checksums.db +0 -0
- data/spec/data/apt/var/www/apt/db/contents.cache.db +0 -0
- data/spec/data/apt/var/www/apt/db/packages.db +0 -0
- data/spec/data/apt/var/www/apt/db/references.db +0 -0
- data/spec/data/apt/var/www/apt/db/release.caches.db +0 -0
- data/spec/data/apt/var/www/apt/db/version +4 -0
- data/spec/data/apt/var/www/apt/dists/sid/Release +19 -0
- data/spec/data/apt/var/www/apt/dists/sid/main/binary-amd64/Packages +16 -0
- data/spec/data/apt/var/www/apt/dists/sid/main/binary-amd64/Packages.gz +0 -0
- data/spec/data/apt/var/www/apt/dists/sid/main/binary-amd64/Release +5 -0
- data/spec/data/apt/var/www/apt/dists/sid/main/binary-i386/Packages +0 -0
- data/spec/data/apt/var/www/apt/pool/main/c/chef-integration-test/chef-integration-test_1.0-1_amd64.deb +0 -0
- data/spec/data/apt/var/www/apt/pool/main/c/chef-integration-test/chef-integration-test_1.1-1_amd64.deb +0 -0
- data/spec/data/cookbooks/preseed/files/default/preseed-file.seed +1 -0
- data/spec/data/cookbooks/preseed/templates/default/preseed-template.seed +1 -0
- data/spec/functional/provider/remote_file/cache_control_data_spec.rb +101 -0
- data/spec/functional/resource/package_spec.rb +297 -0
- data/spec/functional/resource/user_spec.rb +6 -14
- data/spec/spec_helper.rb +29 -0
- data/spec/support/shared/functional/file_resource.rb +37 -0
- data/spec/unit/provider/package/rubygems_spec.rb +1 -1
- data/spec/unit/provider/remote_file/cache_control_data_spec.rb +41 -0
- metadata +101 -43
@@ -102,11 +102,11 @@ time for all objects to be indexed and available for search.</p>
|
|
102
102
|
|
103
103
|
<h2 id="AUTHOR">AUTHOR</h2>
|
104
104
|
|
105
|
-
<p> Chef was written by Adam Jacob <a href="m&#
|
105
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> with many contributions from the community.</p>
|
106
106
|
|
107
107
|
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
108
108
|
|
109
|
-
<p> This manual page was written by Joshua Timberman <a href="mail&#
|
109
|
+
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
110
110
|
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
111
111
|
|
112
112
|
<h2 id="CHEF">CHEF</h2>
|
@@ -115,8 +115,8 @@ time for all objects to be indexed and available for search.</p>
|
|
115
115
|
|
116
116
|
|
117
117
|
<ol class='man-decor man-foot man foot'>
|
118
|
-
<li class='tl'>Chef 11.6.
|
119
|
-
<li class='tc'>
|
118
|
+
<li class='tl'>Chef 11.6.2</li>
|
119
|
+
<li class='tc'>October 2013</li>
|
120
120
|
<li class='tr'>knife-index(1)</li>
|
121
121
|
</ol>
|
122
122
|
|
@@ -227,11 +227,11 @@ run list, the correct syntax is "role[ROLE_NAME]"</p>
|
|
227
227
|
|
228
228
|
<h2 id="AUTHOR">AUTHOR</h2>
|
229
229
|
|
230
|
-
<p> Chef was written by Adam Jacob <a href="m&#
|
230
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> with many contributions from the community.</p>
|
231
231
|
|
232
232
|
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
233
233
|
|
234
|
-
<p> This manual page was written by Joshua Timberman <a href="mail&#
|
234
|
+
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
235
235
|
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
236
236
|
|
237
237
|
<h2 id="CHEF">CHEF</h2>
|
@@ -240,8 +240,8 @@ run list, the correct syntax is "role[ROLE_NAME]"</p>
|
|
240
240
|
|
241
241
|
|
242
242
|
<ol class='man-decor man-foot man foot'>
|
243
|
-
<li class='tl'>Chef 11.6.
|
244
|
-
<li class='tc'>
|
243
|
+
<li class='tl'>Chef 11.6.2</li>
|
244
|
+
<li class='tc'>October 2013</li>
|
245
245
|
<li class='tr'>knife-node(1)</li>
|
246
246
|
</ol>
|
247
247
|
|
@@ -177,11 +177,11 @@ run_list.</p>
|
|
177
177
|
|
178
178
|
<h2 id="AUTHOR">AUTHOR</h2>
|
179
179
|
|
180
|
-
<p> Chef was written by Adam Jacob <a href="m&#
|
180
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> with many contributions from the community.</p>
|
181
181
|
|
182
182
|
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
183
183
|
|
184
|
-
<p> This manual page was written by Joshua Timberman <a href="&#
|
184
|
+
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
185
185
|
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
186
186
|
|
187
187
|
<h2 id="CHEF">CHEF</h2>
|
@@ -190,8 +190,8 @@ run_list.</p>
|
|
190
190
|
|
191
191
|
|
192
192
|
<ol class='man-decor man-foot man foot'>
|
193
|
-
<li class='tl'>Chef 11.6.
|
194
|
-
<li class='tc'>
|
193
|
+
<li class='tl'>Chef 11.6.2</li>
|
194
|
+
<li class='tc'>October 2013</li>
|
195
195
|
<li class='tr'>knife-role(1)</li>
|
196
196
|
</ol>
|
197
197
|
|
@@ -265,11 +265,11 @@ www.example.com:</p>
|
|
265
265
|
|
266
266
|
<h2 id="AUTHOR">AUTHOR</h2>
|
267
267
|
|
268
|
-
<p> Chef was written by Adam Jacob <a href="m&#
|
268
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> with many contributions from the community.</p>
|
269
269
|
|
270
270
|
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
271
271
|
|
272
|
-
<p> This manual page was written by Joshua Timberman <a href="&#
|
272
|
+
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
273
273
|
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
274
274
|
|
275
275
|
<h2 id="CHEF">CHEF</h2>
|
@@ -278,8 +278,8 @@ www.example.com:</p>
|
|
278
278
|
|
279
279
|
|
280
280
|
<ol class='man-decor man-foot man foot'>
|
281
|
-
<li class='tl'>Chef 11.6.
|
282
|
-
<li class='tc'>
|
281
|
+
<li class='tl'>Chef 11.6.2</li>
|
282
|
+
<li class='tc'>October 2013</li>
|
283
283
|
<li class='tr'>knife-search(1)</li>
|
284
284
|
</ol>
|
285
285
|
|
@@ -133,11 +133,11 @@ option.</dd>
|
|
133
133
|
|
134
134
|
<h2 id="AUTHOR">AUTHOR</h2>
|
135
135
|
|
136
|
-
<p> Chef was written by Adam Jacob <a href="mai&#
|
136
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> with many contributions from the community.</p>
|
137
137
|
|
138
138
|
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
139
139
|
|
140
|
-
<p> This manual page was written by Joshua Timberman <a href="&#
|
140
|
+
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
141
141
|
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
142
142
|
|
143
143
|
<h2 id="CHEF">CHEF</h2>
|
@@ -146,8 +146,8 @@ option.</dd>
|
|
146
146
|
|
147
147
|
|
148
148
|
<ol class='man-decor man-foot man foot'>
|
149
|
-
<li class='tl'>Chef 11.6.
|
150
|
-
<li class='tc'>
|
149
|
+
<li class='tl'>Chef 11.6.2</li>
|
150
|
+
<li class='tc'>October 2013</li>
|
151
151
|
<li class='tr'>knife-ssh(1)</li>
|
152
152
|
</ol>
|
153
153
|
|
@@ -105,11 +105,11 @@ may not be publicly reachable.</p>
|
|
105
105
|
|
106
106
|
<h2 id="AUTHOR">AUTHOR</h2>
|
107
107
|
|
108
|
-
<p> Chef was written by Adam Jacob <a href="&#
|
108
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> with many contributions from the community.</p>
|
109
109
|
|
110
110
|
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
111
111
|
|
112
|
-
<p> This manual page was written by Joshua Timberman <a href="&#
|
112
|
+
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
113
113
|
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
114
114
|
|
115
115
|
<h2 id="CHEF">CHEF</h2>
|
@@ -118,8 +118,8 @@ may not be publicly reachable.</p>
|
|
118
118
|
|
119
119
|
|
120
120
|
<ol class='man-decor man-foot man foot'>
|
121
|
-
<li class='tl'>Chef 11.6.
|
122
|
-
<li class='tc'>
|
121
|
+
<li class='tl'>Chef 11.6.2</li>
|
122
|
+
<li class='tc'>October 2013</li>
|
123
123
|
<li class='tr'>knife-status(1)</li>
|
124
124
|
</ol>
|
125
125
|
|
@@ -114,11 +114,11 @@
|
|
114
114
|
|
115
115
|
<h2 id="AUTHOR">AUTHOR</h2>
|
116
116
|
|
117
|
-
<p> Chef was written by Adam Jacob <a href="&#
|
117
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> with many contributions from the community.</p>
|
118
118
|
|
119
119
|
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
120
120
|
|
121
|
-
<p> This manual page was written by Daniel DeLeo <a href="&#
|
121
|
+
<p> This manual page was written by Daniel DeLeo <a href="mailto:dan@opscode.com" data-bare-link="true">dan@opscode.com</a>.
|
122
122
|
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
123
123
|
|
124
124
|
<h2 id="CHEF">CHEF</h2>
|
@@ -127,8 +127,8 @@
|
|
127
127
|
|
128
128
|
|
129
129
|
<ol class='man-decor man-foot man foot'>
|
130
|
-
<li class='tl'>Chef 11.6.
|
131
|
-
<li class='tc'>
|
130
|
+
<li class='tl'>Chef 11.6.2</li>
|
131
|
+
<li class='tc'>October 2013</li>
|
132
132
|
<li class='tr'>knife-tag(1)</li>
|
133
133
|
</ol>
|
134
134
|
|
@@ -286,12 +286,12 @@ data editing entirely.</dd>
|
|
286
286
|
|
287
287
|
<h2 id="AUTHOR">AUTHOR</h2>
|
288
288
|
|
289
|
-
<p> Chef was written by Adam Jacob <a href="mai&#
|
289
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> of Opscode
|
290
290
|
(<a href="http://www.opscode.com" data-bare-link="true">http://www.opscode.com</a>), with contributions from the community.</p>
|
291
291
|
|
292
292
|
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
293
293
|
|
294
|
-
<p> This manual page was written by Joshua Timberman <a href="m&#
|
294
|
+
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.</p>
|
295
295
|
|
296
296
|
<h2 id="LICENSE">LICENSE</h2>
|
297
297
|
|
@@ -305,8 +305,8 @@ data editing entirely.</dd>
|
|
305
305
|
|
306
306
|
|
307
307
|
<ol class='man-decor man-foot man foot'>
|
308
|
-
<li class='tl'>Chef 11.6.
|
309
|
-
<li class='tc'>
|
308
|
+
<li class='tl'>Chef 11.6.2</li>
|
309
|
+
<li class='tc'>October 2013</li>
|
310
310
|
<li class='tr'>knife(1)</li>
|
311
311
|
</ol>
|
312
312
|
|
@@ -1,7 +1,7 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
2
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "CHEF\-SHELL" "1" "
|
4
|
+
.TH "CHEF\-SHELL" "1" "October 2013" "Chef 11.6.2" "Chef Manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBchef\-shell\fR \- Interactive Chef Console
|
@@ -1,7 +1,7 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
2
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "KNIFE\-BOOTSTRAP" "1" "
|
4
|
+
.TH "KNIFE\-BOOTSTRAP" "1" "October 2013" "Chef 11.6.2" "Chef Manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBknife\-bootstrap\fR \- Install Chef Client on a remote host
|
@@ -1,99 +0,0 @@
|
|
1
|
-
.\" generated with Ronn/v0.7.3
|
2
|
-
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
|
-
.
|
4
|
-
.TH "KNIFE\-CLIENT" "1" "July 2013" "Chef 11.6.0" "Chef Manual"
|
5
|
-
.
|
6
|
-
.SH "NAME"
|
7
|
-
\fBknife\-client\fR \- Manage Chef API Clients
|
8
|
-
.
|
9
|
-
.SH "SYNOPSIS"
|
10
|
-
\fBknife\fR \fBclient\fR \fIsub\-command\fR \fI(options)\fR
|
11
|
-
.
|
12
|
-
.SH "SUB\-COMMANDS"
|
13
|
-
Client subcommands follow a basic create, read, update, delete (CRUD) pattern\. The Following subcommands are available:
|
14
|
-
.
|
15
|
-
.SH "BULK DELETE"
|
16
|
-
\fBknife client bulk delete\fR \fIregex\fR \fI(options)\fR
|
17
|
-
.
|
18
|
-
.P
|
19
|
-
Delete clients where the client name matches the regular expression \fIregex\fR on the Chef Server\. The regular expression should be given as a quoted string, and not surrounded by forward slashes\.
|
20
|
-
.
|
21
|
-
.SH "CREATE"
|
22
|
-
\fBknife client create\fR \fIclient name\fR \fI(options)\fR
|
23
|
-
.
|
24
|
-
.TP
|
25
|
-
\fB\-a\fR, \fB\-\-admin\fR
|
26
|
-
Create the client as an admin
|
27
|
-
.
|
28
|
-
.TP
|
29
|
-
\fB\-f\fR, \fB\-\-file FILE\fR
|
30
|
-
Write the key to a file
|
31
|
-
.
|
32
|
-
.P
|
33
|
-
Create a new client\. This generates an RSA keypair\. The private key will be displayed on \fISTDOUT\fR or written to the named file\. The public half will be stored on the Server\. For \fIchef\-client\fR systems, the private key should be copied to the system as \fB/etc/chef/client\.pem\fR\.
|
34
|
-
.
|
35
|
-
.P
|
36
|
-
Admin clients should be created for users that will use \fIknife\fR to access the API as an administrator\. The private key will generally be copied to \fB~/\.chef/client\e_name\.pem\fR and referenced in the \fBknife\.rb\fR configuration file\.
|
37
|
-
.
|
38
|
-
.SH "DELETE"
|
39
|
-
\fBknife client delete\fR \fIclient name\fR \fI(options)\fR
|
40
|
-
.
|
41
|
-
.P
|
42
|
-
Deletes a registered client\.
|
43
|
-
.
|
44
|
-
.SH "EDIT"
|
45
|
-
\fBclient edit\fR \fIclient name\fR \fI(options)\fR
|
46
|
-
.
|
47
|
-
.P
|
48
|
-
Edit a registered client\.
|
49
|
-
.
|
50
|
-
.SH "LIST"
|
51
|
-
\fBclient list\fR \fI(options)\fR
|
52
|
-
.
|
53
|
-
.TP
|
54
|
-
\fB\-w\fR, \fB\-\-with\-uri\fR
|
55
|
-
Show corresponding URIs
|
56
|
-
.
|
57
|
-
.P
|
58
|
-
List all registered clients\.
|
59
|
-
.
|
60
|
-
.SH "REREGISTER"
|
61
|
-
\fBclient reregister\fR \fIclient name\fR \fI(options)\fR
|
62
|
-
.
|
63
|
-
.TP
|
64
|
-
\fB\-f\fR, \fB\-\-file FILE\fR
|
65
|
-
Write the key to a file
|
66
|
-
.
|
67
|
-
.P
|
68
|
-
Regenerate the RSA keypair for a client\. The public half will be stored on the server and the private key displayed on \fISTDOUT\fR or written to the named file\. This operation will invalidate the previous keypair used by the client, preventing it from authenticating with the Chef Server\. Use care when reregistering the validator client\.
|
69
|
-
.
|
70
|
-
.SH "SHOW"
|
71
|
-
\fBclient show\fR \fIclient name\fR \fI(options)\fR
|
72
|
-
.
|
73
|
-
.TP
|
74
|
-
\fB\-a\fR, \fB\-\-attribute ATTR\fR
|
75
|
-
Show only one attribute
|
76
|
-
.
|
77
|
-
.P
|
78
|
-
Show a client\. Output format is determined by the \-\-format option\.
|
79
|
-
.
|
80
|
-
.SH "DESCRIPTION"
|
81
|
-
Clients are identities used for communication with the Chef Server API, roughly equivalent to user accounts on the Chef Server, except that clients only communicate with the Chef Server API and are authenticated via request signatures\.
|
82
|
-
.
|
83
|
-
.P
|
84
|
-
In the typical case, there will be one client object on the server for each node, and the corresponding client and node will have identical names\.
|
85
|
-
.
|
86
|
-
.P
|
87
|
-
In the Chef authorization model, there is one special client, the "validator", which is authorized to create new non\-administrative clients but has minimal privileges otherwise\. This identity is used as a sort of "guest account" to create a client identity when initially setting up a host for management with Chef\.
|
88
|
-
.
|
89
|
-
.SH "SEE ALSO"
|
90
|
-
\fBknife\-node\fR(1)
|
91
|
-
.
|
92
|
-
.SH "AUTHOR"
|
93
|
-
Chef was written by Adam Jacob \fIadam@opscode\.com\fR with many contributions from the community\.
|
94
|
-
.
|
95
|
-
.SH "DOCUMENTATION"
|
96
|
-
This manual page was written by Joshua Timberman \fIjoshua@opscode\.com\fR\. Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2\.0 License\.
|
97
|
-
.
|
98
|
-
.SH "CHEF"
|
99
|
-
Knife is distributed with Chef\. \fIhttp://wiki\.opscode\.com/display/chef/Home\fR
|
@@ -1,7 +1,7 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
2
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "KNIFE\-CONFIGURE" "1" "
|
4
|
+
.TH "KNIFE\-CONFIGURE" "1" "October 2013" "Chef 11.6.2" "Chef Manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBknife\-configure\fR \- Generate configuration files for knife or Chef Client
|
@@ -1,7 +1,7 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
2
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "KNIFE\-COOKBOOK\-SITE" "1" "
|
4
|
+
.TH "KNIFE\-COOKBOOK\-SITE" "1" "October 2013" "Chef 11.6.2" "Chef Manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBknife\-cookbook\-site\fR \- Install and update open source cookbooks
|
@@ -1,7 +1,7 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
2
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "KNIFE\-COOKBOOK" "1" "
|
4
|
+
.TH "KNIFE\-COOKBOOK" "1" "October 2013" "Chef 11.6.2" "Chef Manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBknife\-cookbook\fR \- upload and manage chef cookbooks
|
@@ -1,7 +1,7 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
2
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "KNIFE\-DATA\-BAG" "1" "
|
4
|
+
.TH "KNIFE\-DATA\-BAG" "1" "October 2013" "Chef 11.6.2" "Chef Manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBknife\-data\-bag\fR \- Store arbitrary data on a Chef Server
|
@@ -1,168 +0,0 @@
|
|
1
|
-
.\" generated with Ronn/v0.7.3
|
2
|
-
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
|
-
.
|
4
|
-
.TH "KNIFE\-ENVIRONMENT" "1" "July 2013" "Chef 11.6.0" "Chef Manual"
|
5
|
-
.
|
6
|
-
.SH "NAME"
|
7
|
-
\fBknife\-environment\fR \- Define cookbook policies for the environments in your infrastructure
|
8
|
-
.
|
9
|
-
.SH "SYNOPSIS"
|
10
|
-
\fBknife\fR \fBenvironment\fR \fIsub\-command\fR \fI(options)\fR
|
11
|
-
.
|
12
|
-
.SH "SUBCOMMANDS"
|
13
|
-
Environment subcommands follow a basic create, read, update, delete (CRUD) pattern\. The following subcommands are available:
|
14
|
-
.
|
15
|
-
.SH "CREATE"
|
16
|
-
\fBknife environment create\fR \fIenvironment\fR \fI(options)\fR
|
17
|
-
.
|
18
|
-
.TP
|
19
|
-
\fB\-d\fR, \fB\-\-description DESCRIPTION\fR
|
20
|
-
The value of the description field\.
|
21
|
-
.
|
22
|
-
.P
|
23
|
-
Create a new environment object on the Chef Server\. The envrionment will be opened in the text editor for editing prior to creation if the \-n option is not present\.
|
24
|
-
.
|
25
|
-
.SH "DELETE"
|
26
|
-
\fBknife environment delete\fR \fIenvironment\fR \fI(options)\fR
|
27
|
-
.
|
28
|
-
.P
|
29
|
-
Destroy an environment on the Chef Server\. A prompt for confirmation will be displayed if the \-y options is not given\.
|
30
|
-
.
|
31
|
-
.SH "EDIT"
|
32
|
-
\fBknife environment edit\fR \fIenvironment\fR \fI(options)\fR
|
33
|
-
.
|
34
|
-
.P
|
35
|
-
Fetch \fIenvironment\fR and display it in the text editor for editing\. The environment will be saved to the Chef Server when the editing session exits\.
|
36
|
-
.
|
37
|
-
.SH "FROM FILE"
|
38
|
-
\fBknife environment from file\fR \fIfile\fR \fI(options)\fR
|
39
|
-
.
|
40
|
-
.P
|
41
|
-
Create or update an environment from the JSON or Ruby format \fIfile\fR\. See \fBformat\fR for the proper format of this file\.
|
42
|
-
.
|
43
|
-
.SH "LIST"
|
44
|
-
\fBknife environment list\fR \fI(options)\fR * \fB\-w\fR, \fB\-\-with\-uri\fR: Show the resource URI for each environment
|
45
|
-
.
|
46
|
-
.SH "SHOW"
|
47
|
-
\fBknife environment show\fR \fIenvironment\fR \fI(options)\fR
|
48
|
-
.
|
49
|
-
.SH "DESCRIPTION"
|
50
|
-
Environments provide a means to apply policies to hosts in your infrastructure based on business function\. For example, you may have a separate copy of your infrastructure called "dev" that runs the latest version of your application and should use the newest versions of your cookbooks when configuring systems, and a production instance of your infrastructure where you wish to update code and cookbooks in a more controlled fashion\. In Chef, this function is implemented with \fIenvironments\fR\.
|
51
|
-
.
|
52
|
-
.P
|
53
|
-
Environments contain two major components: a set of cookbook version constraints and environment attributes\.
|
54
|
-
.
|
55
|
-
.SH "SYNTAX"
|
56
|
-
A cookbook version constraint is comprised of a \fIcookbook name\fR and a \fIversion constraint\fR\. The \fIcookbook name\fR is the name of a cookbook in your system, and the \fIversion constraint\fR is a String describing the version(s) of that cookbook allowed in the environment\. Only one \fIversion constraint\fR is supported for a given \fIcookbook name\fR\.
|
57
|
-
.
|
58
|
-
.P
|
59
|
-
The exact syntax used to define a cookbook version constraint varies depending on whether you use the JSON format or the Ruby format\. In the JSON format, the cookbook version constraints for an environment are represented as a single JSON object, like this:
|
60
|
-
.
|
61
|
-
.IP "" 4
|
62
|
-
.
|
63
|
-
.nf
|
64
|
-
|
65
|
-
{"apache2": ">= 1\.5\.0"}
|
66
|
-
.
|
67
|
-
.fi
|
68
|
-
.
|
69
|
-
.IP "" 0
|
70
|
-
.
|
71
|
-
.P
|
72
|
-
In the Ruby format, the cookbook version contraints for an environment are represented as a Ruby Hash, like this:
|
73
|
-
.
|
74
|
-
.IP "" 4
|
75
|
-
.
|
76
|
-
.nf
|
77
|
-
|
78
|
-
{"apache2" => ">= 1\.5\.0"}
|
79
|
-
.
|
80
|
-
.fi
|
81
|
-
.
|
82
|
-
.IP "" 0
|
83
|
-
.
|
84
|
-
.P
|
85
|
-
A \fIversion number\fR is a String comprised of two or three digits separated by a dot (\.) character, or in other words, strings of the form "major\.minor" or "major\.minor\.patch"\. "1\.2" and "1\.2\.3" are examples of valid version numbers\. Version numbers containing more than three digits or alphabetic characters are not supported\.
|
86
|
-
.
|
87
|
-
.P
|
88
|
-
A \fIversion constraint\fR String is composed of an \fIoperator\fR and a \fIversion number\fR\. The following operators are available:
|
89
|
-
.
|
90
|
-
.TP
|
91
|
-
\fB= VERSION\fR
|
92
|
-
Equality\. Only the exact version specified may be used\.
|
93
|
-
.
|
94
|
-
.TP
|
95
|
-
\fB> VERSION\fR
|
96
|
-
Greater than\. Only versions greater than \fBVERSION\fR may be used\.
|
97
|
-
.
|
98
|
-
.TP
|
99
|
-
\fB>= VERSION\fR
|
100
|
-
Greater than or equal to\. Only versions equal to VERSION or greater may be used\.
|
101
|
-
.
|
102
|
-
.TP
|
103
|
-
\fB< VERSION\fR
|
104
|
-
Less than\. Only versions less than VERSION may be used\.
|
105
|
-
.
|
106
|
-
.TP
|
107
|
-
\fB<= VERSION\fR
|
108
|
-
Less than or equal to\. Only versions lesser or equal to VERSION may be used\.
|
109
|
-
.
|
110
|
-
.TP
|
111
|
-
\fB~> VERSION\fR
|
112
|
-
Pessimistic greater than\. Depending on the number of components in the given VERSION, the constraint will be optimistic about future minor or patch revisions only\. For example, \fB~> 1\.1\fR will match any version less than \fB2\.0\fR and greater than or equal to \fB1\.1\.0\fR, whereas \fB~> 2\.0\.5\fR will match any version less than \fB2\.1\.0\fR and greater than or equal to \fB2\.0\.5\fR\.
|
113
|
-
.
|
114
|
-
.SH "FORMAT"
|
115
|
-
The JSON format of an envioronment is as follows:
|
116
|
-
.
|
117
|
-
.IP "" 4
|
118
|
-
.
|
119
|
-
.nf
|
120
|
-
|
121
|
-
{
|
122
|
-
"name": "dev",
|
123
|
-
"description": "The development environment",
|
124
|
-
"cookbook_versions": {
|
125
|
-
"couchdb": "= 11\.0\.0"
|
126
|
-
},
|
127
|
-
"json_class": "Chef::Environment",
|
128
|
-
"chef_type": "environment",
|
129
|
-
"default_attributes": {
|
130
|
-
"apache2": { "listen_ports": [ "80", "443" ] }
|
131
|
-
},
|
132
|
-
"override_attributes": {
|
133
|
-
"aws_s3_bucket": "production"
|
134
|
-
}
|
135
|
-
}
|
136
|
-
.
|
137
|
-
.fi
|
138
|
-
.
|
139
|
-
.IP "" 0
|
140
|
-
.
|
141
|
-
.P
|
142
|
-
The Ruby format of an environment is as follows:
|
143
|
-
.
|
144
|
-
.IP "" 4
|
145
|
-
.
|
146
|
-
.nf
|
147
|
-
|
148
|
-
name "dev"
|
149
|
-
description "The development environment"
|
150
|
-
cookbook_versions "couchdb" => "= 11\.0\.0"
|
151
|
-
default_attributes "apache2" => { "listen_ports" => [ "80", "443" ] }
|
152
|
-
override_attributes "aws_s3_bucket" => "production"
|
153
|
-
.
|
154
|
-
.fi
|
155
|
-
.
|
156
|
-
.IP "" 0
|
157
|
-
.
|
158
|
-
.SH "SEE ALSO"
|
159
|
-
\fBknife\-node(1)\fR \fBknife\-cookbook(1)\fR \fBknife\-role(1)\fR \fIhttp://wiki\.opscode\.com/display/chef/Environments\fR \fIhttp://wiki\.opscode\.com/display/chef/Version+Constraints\fR
|
160
|
-
.
|
161
|
-
.SH "AUTHOR"
|
162
|
-
Chef was written by Adam Jacob \fIadam@opscode\.com\fR with many contributions from the community\.
|
163
|
-
.
|
164
|
-
.SH "DOCUMENTATION"
|
165
|
-
This manual page was written by Daniel DeLeo \fIdan@opscode\.com\fR\. Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2\.0 License\.
|
166
|
-
.
|
167
|
-
.SH "CHEF"
|
168
|
-
Knife is distributed with Chef\. \fIhttp://wiki\.opscode\.com/display/chef/Home\fR
|