microwave 1.0.2 → 1.0.3
Sign up to get free protection for your applications and to get access to all the features.
- data/Rakefile +4 -4
- data/bin/chef-solo +2 -0
- data/spec/spec_helper.rb +2 -0
- data/spec/unit/checksum/storage/filesystem_spec.rb +4 -4
- data/spec/unit/config_spec.rb +7 -4
- data/spec/unit/data_bag_spec.rb +11 -11
- data/spec/unit/formatters/error_inspectors/compile_error_inspector_spec.rb +8 -8
- data/spec/unit/formatters/error_inspectors/resource_failure_inspector_spec.rb +5 -5
- metadata +10 -124
- data/distro/README +0 -2
- data/distro/arch/etc/conf.d/chef-client.conf +0 -5
- data/distro/arch/etc/conf.d/chef-expander.conf +0 -8
- data/distro/arch/etc/conf.d/chef-server-webui.conf +0 -10
- data/distro/arch/etc/conf.d/chef-server.conf +0 -10
- data/distro/arch/etc/conf.d/chef-solr.conf +0 -8
- data/distro/arch/etc/rc.d/chef-client +0 -90
- data/distro/arch/etc/rc.d/chef-expander +0 -78
- data/distro/arch/etc/rc.d/chef-server +0 -78
- data/distro/arch/etc/rc.d/chef-server-webui +0 -78
- data/distro/arch/etc/rc.d/chef-solr +0 -78
- data/distro/common/html/chef-client.8.html +0 -145
- data/distro/common/html/chef-expander.8.html +0 -164
- data/distro/common/html/chef-expanderctl.8.html +0 -146
- data/distro/common/html/chef-server-webui.8.html +0 -185
- data/distro/common/html/chef-server.8.html +0 -182
- data/distro/common/html/chef-solo.8.html +0 -191
- data/distro/common/html/chef-solr.8.html +0 -165
- data/distro/common/html/knife-bootstrap.1.html +0 -241
- data/distro/common/html/knife-client.1.html +0 -219
- data/distro/common/html/knife-configure.1.html +0 -170
- data/distro/common/html/knife-cookbook-site.1.html +0 -241
- data/distro/common/html/knife-cookbook.1.html +0 -384
- data/distro/common/html/knife-data-bag.1.html +0 -238
- data/distro/common/html/knife-environment.1.html +0 -267
- data/distro/common/html/knife-exec.1.html +0 -134
- data/distro/common/html/knife-index.1.html +0 -125
- data/distro/common/html/knife-node.1.html +0 -250
- data/distro/common/html/knife-recipe.1.html +0 -92
- data/distro/common/html/knife-role.1.html +0 -200
- data/distro/common/html/knife-search.1.html +0 -288
- data/distro/common/html/knife-ssh.1.html +0 -156
- data/distro/common/html/knife-status.1.html +0 -128
- data/distro/common/html/knife-tag.1.html +0 -137
- data/distro/common/html/knife.1.html +0 -320
- data/distro/common/html/shef.1.html +0 -283
- data/distro/common/man/man1/knife-bootstrap.1 +0 -201
- data/distro/common/man/man1/knife-client.1 +0 -99
- data/distro/common/man/man1/knife-configure.1 +0 -88
- data/distro/common/man/man1/knife-cookbook-site.1 +0 -145
- data/distro/common/man/man1/knife-cookbook.1 +0 -345
- data/distro/common/man/man1/knife-data-bag.1 +0 -136
- data/distro/common/man/man1/knife-environment.1 +0 -178
- data/distro/common/man/man1/knife-exec.1 +0 -46
- data/distro/common/man/man1/knife-index.1 +0 -29
- data/distro/common/man/man1/knife-node.1 +0 -134
- data/distro/common/man/man1/knife-role.1 +0 -88
- data/distro/common/man/man1/knife-search.1 +0 -280
- data/distro/common/man/man1/knife-ssh.1 +0 -79
- data/distro/common/man/man1/knife-status.1 +0 -29
- data/distro/common/man/man1/knife-tag.1 +0 -43
- data/distro/common/man/man1/knife.1 +0 -288
- data/distro/common/man/man1/shef.1 +0 -256
- data/distro/common/man/man8/chef-client.8 +0 -104
- data/distro/common/man/man8/chef-expander.8 +0 -97
- data/distro/common/man/man8/chef-expanderctl.8 +0 -62
- data/distro/common/man/man8/chef-server-webui.8 +0 -155
- data/distro/common/man/man8/chef-server.8 +0 -147
- data/distro/common/man/man8/chef-solo.8 +0 -158
- data/distro/common/man/man8/chef-solr.8 +0 -122
- data/distro/common/markdown/README +0 -3
- data/distro/common/markdown/man1/knife-bootstrap.mkd +0 -141
- data/distro/common/markdown/man1/knife-client.mkd +0 -103
- data/distro/common/markdown/man1/knife-configure.mkd +0 -70
- data/distro/common/markdown/man1/knife-cookbook-site.mkd +0 -123
- data/distro/common/markdown/man1/knife-cookbook.mkd +0 -263
- data/distro/common/markdown/man1/knife-data-bag.mkd +0 -121
- data/distro/common/markdown/man1/knife-environment.mkd +0 -151
- data/distro/common/markdown/man1/knife-exec.mkd +0 -37
- data/distro/common/markdown/man1/knife-index.mkd +0 -30
- data/distro/common/markdown/man1/knife-node.mkd +0 -130
- data/distro/common/markdown/man1/knife-role.mkd +0 -85
- data/distro/common/markdown/man1/knife-search.mkd +0 -180
- data/distro/common/markdown/man1/knife-ssh.mkd +0 -69
- data/distro/common/markdown/man1/knife-status.mkd +0 -36
- data/distro/common/markdown/man1/knife-tag.mkd +0 -39
- data/distro/common/markdown/man1/knife.mkd +0 -218
- data/distro/common/markdown/man1/shef.mkd +0 -189
- data/distro/common/markdown/man8/chef-client.mkd +0 -74
- data/distro/common/markdown/man8/chef-expander.mkd +0 -82
- data/distro/common/markdown/man8/chef-expanderctl.mkd +0 -58
- data/distro/common/markdown/man8/chef-server-webui.mkd +0 -121
- data/distro/common/markdown/man8/chef-server.mkd +0 -121
- data/distro/common/markdown/man8/chef-solo.mkd +0 -107
- data/distro/common/markdown/man8/chef-solr.mkd +0 -89
- data/distro/debian/etc/default/chef-client +0 -4
- data/distro/debian/etc/default/chef-expander +0 -8
- data/distro/debian/etc/default/chef-server +0 -9
- data/distro/debian/etc/default/chef-server-webui +0 -9
- data/distro/debian/etc/default/chef-solr +0 -8
- data/distro/debian/etc/init.d/chef-client +0 -210
- data/distro/debian/etc/init.d/chef-expander +0 -176
- data/distro/debian/etc/init.d/chef-server +0 -122
- data/distro/debian/etc/init.d/chef-server-webui +0 -123
- data/distro/debian/etc/init.d/chef-solr +0 -176
- data/distro/debian/etc/init/chef-client.conf +0 -17
- data/distro/debian/etc/init/chef-expander.conf +0 -17
- data/distro/debian/etc/init/chef-server-webui.conf +0 -17
- data/distro/debian/etc/init/chef-server.conf +0 -17
- data/distro/debian/etc/init/chef-solr.conf +0 -17
- data/distro/redhat/etc/init.d/chef-client +0 -121
- data/distro/redhat/etc/init.d/chef-expander +0 -104
- data/distro/redhat/etc/init.d/chef-server +0 -112
- data/distro/redhat/etc/init.d/chef-server-webui +0 -112
- data/distro/redhat/etc/init.d/chef-solr +0 -104
- data/distro/redhat/etc/logrotate.d/chef-client +0 -8
- data/distro/redhat/etc/logrotate.d/chef-expander +0 -8
- data/distro/redhat/etc/logrotate.d/chef-server +0 -8
- data/distro/redhat/etc/logrotate.d/chef-server-webui +0 -8
- data/distro/redhat/etc/logrotate.d/chef-solr +0 -8
- data/distro/redhat/etc/sysconfig/chef-client +0 -15
- data/distro/redhat/etc/sysconfig/chef-expander +0 -7
- data/distro/redhat/etc/sysconfig/chef-server +0 -14
- data/distro/redhat/etc/sysconfig/chef-server-webui +0 -14
- data/distro/redhat/etc/sysconfig/chef-solr +0 -8
- data/distro/windows/service_manager.rb +0 -164
@@ -1,170 +0,0 @@
|
|
1
|
-
<!DOCTYPE html>
|
2
|
-
<html>
|
3
|
-
<head>
|
4
|
-
<meta http-equiv='content-type' value='text/html;charset=utf8'>
|
5
|
-
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
|
6
|
-
<title>knife-configure(1) - Generate configuration files for knife or Chef Client</title>
|
7
|
-
<style type='text/css' media='all'>
|
8
|
-
/* style: man */
|
9
|
-
body#manpage {margin:0}
|
10
|
-
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
|
11
|
-
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
|
12
|
-
.mp h2 {margin:10px 0 0 0}
|
13
|
-
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
|
14
|
-
.mp h3 {margin:0 0 0 4ex}
|
15
|
-
.mp dt {margin:0;clear:left}
|
16
|
-
.mp dt.flush {float:left;width:8ex}
|
17
|
-
.mp dd {margin:0 0 0 9ex}
|
18
|
-
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
|
19
|
-
.mp pre {margin-bottom:20px}
|
20
|
-
.mp pre+h2,.mp pre+h3 {margin-top:22px}
|
21
|
-
.mp h2+pre,.mp h3+pre {margin-top:5px}
|
22
|
-
.mp img {display:block;margin:auto}
|
23
|
-
.mp h1.man-title {display:none}
|
24
|
-
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
|
25
|
-
.mp h2 {font-size:16px;line-height:1.25}
|
26
|
-
.mp h1 {font-size:20px;line-height:2}
|
27
|
-
.mp {text-align:justify;background:#fff}
|
28
|
-
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
|
29
|
-
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
|
30
|
-
.mp u {text-decoration:underline}
|
31
|
-
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
|
32
|
-
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
|
33
|
-
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
|
34
|
-
.mp b.man-ref {font-weight:normal;color:#434241}
|
35
|
-
.mp pre {padding:0 4ex}
|
36
|
-
.mp pre code {font-weight:normal;color:#434241}
|
37
|
-
.mp h2+pre,h3+pre {padding-left:0}
|
38
|
-
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
|
39
|
-
ol.man-decor {width:100%}
|
40
|
-
ol.man-decor li.tl {text-align:left}
|
41
|
-
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
|
42
|
-
ol.man-decor li.tr {text-align:right;float:right}
|
43
|
-
</style>
|
44
|
-
<style type='text/css' media='all'>
|
45
|
-
/* style: toc */
|
46
|
-
.man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
|
47
|
-
.man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
|
48
|
-
.man-navigation a:hover {color:#111;text-decoration:underline}
|
49
|
-
</style>
|
50
|
-
</head>
|
51
|
-
<!--
|
52
|
-
The following styles are deprecated and will be removed at some point:
|
53
|
-
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
|
54
|
-
|
55
|
-
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
|
56
|
-
.man-navigation should be used instead.
|
57
|
-
-->
|
58
|
-
<body id='manpage'>
|
59
|
-
<div class='mp' id='man'>
|
60
|
-
|
61
|
-
<div class='man-navigation' style='display:none'>
|
62
|
-
<a href="#NAME">NAME</a>
|
63
|
-
<a href="#SYNOPSIS">SYNOPSIS</a>
|
64
|
-
<a href="#DESCRIPTION">DESCRIPTION</a>
|
65
|
-
<a href="#CONFIGURE-SUBCOMMANDS">CONFIGURE SUBCOMMANDS</a>
|
66
|
-
<a href="#EXAMPLES">EXAMPLES</a>
|
67
|
-
<a href="#SEE-ALSO">SEE ALSO</a>
|
68
|
-
<a href="#AUTHOR">AUTHOR</a>
|
69
|
-
<a href="#DOCUMENTATION">DOCUMENTATION</a>
|
70
|
-
<a href="#CHEF">CHEF</a>
|
71
|
-
</div>
|
72
|
-
|
73
|
-
<ol class='man-decor man-head man head'>
|
74
|
-
<li class='tl'>knife-configure(1)</li>
|
75
|
-
<li class='tc'>Chef Manual</li>
|
76
|
-
<li class='tr'>knife-configure(1)</li>
|
77
|
-
</ol>
|
78
|
-
|
79
|
-
<h2 id="NAME">NAME</h2>
|
80
|
-
<p class="man-name">
|
81
|
-
<code>knife-configure</code> - <span class="man-whatis">Generate configuration files for knife or Chef Client</span>
|
82
|
-
</p>
|
83
|
-
|
84
|
-
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
85
|
-
|
86
|
-
<p><strong>knife</strong> <strong>configure</strong> [client] <em>(options)</em></p>
|
87
|
-
|
88
|
-
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
89
|
-
|
90
|
-
<p>Generates a knife.rb configuration file interactively. When given the
|
91
|
-
--initial option, also creates a new administrative user.</p>
|
92
|
-
|
93
|
-
<h2 id="CONFIGURE-SUBCOMMANDS">CONFIGURE SUBCOMMANDS</h2>
|
94
|
-
|
95
|
-
<p><strong>knife configure</strong> <em>(options)</em></p>
|
96
|
-
|
97
|
-
<dl>
|
98
|
-
<dt><code>-i</code>, <code>--initial</code></dt><dd>Create an initial API Client</dd>
|
99
|
-
<dt><code>-r</code>, <code>--repository REPO</code></dt><dd>The path to your chef-repo</dd>
|
100
|
-
</dl>
|
101
|
-
|
102
|
-
|
103
|
-
<p>Create a configuration file for knife. This will prompt for values to
|
104
|
-
enter into the file. Default values are listed in square brackets if no
|
105
|
-
other entry is typed. See <strong>knife</strong>(1) for a description of
|
106
|
-
configuration options.</p>
|
107
|
-
|
108
|
-
<p><strong>knife configure client</strong> <em>directory</em></p>
|
109
|
-
|
110
|
-
<p>Read the <em>knife.rb</em> config file and generate a config file suitable for
|
111
|
-
use in <em>/etc/chef/client.rb</em> and copy the validation certificate into
|
112
|
-
the specified <em>directory</em>.</p>
|
113
|
-
|
114
|
-
<h2 id="EXAMPLES">EXAMPLES</h2>
|
115
|
-
|
116
|
-
<ul>
|
117
|
-
<li><p>On a freshly installed Chef Server, use <em>knife configure -i</em> to
|
118
|
-
create an administrator and knife configuration file. Leave the
|
119
|
-
field blank to accept the default value. On most systems, the
|
120
|
-
default values are acceptable.</p>
|
121
|
-
|
122
|
-
<p>user@host$ knife configure -i<br />
|
123
|
-
Please enter the chef server URL: [http://localhost:4000]<br />
|
124
|
-
Please enter a clientname for the new client: [username]<br />
|
125
|
-
Please enter the existing admin clientname: [chef-webui]<br />
|
126
|
-
Please enter the location of the existing admin client's private key: [/etc/chef/webui.pem]<br />
|
127
|
-
Please enter the validation clientname: [chef-validator]<br />
|
128
|
-
Please enter the location of the validation key: [/etc/chef/validation.pem]<br />
|
129
|
-
Please enter the path to a chef repository (or leave blank):<br />
|
130
|
-
Creating initial API user...<br />
|
131
|
-
Created (or updated) client[username]<br />
|
132
|
-
Configuration file written to /home/username/.chef/knife.rb</p>
|
133
|
-
|
134
|
-
<p>This creates a new administrator client named <em>username</em>, writes
|
135
|
-
a configuration file to <em>/home/username/.chef/knife.rb</em>, and the
|
136
|
-
private key to <em>/home/username/.chef/username.pem</em>. The
|
137
|
-
configuration file and private key may be copied to another system
|
138
|
-
to facilitate administration of the Chef Server from a remote
|
139
|
-
system. Depending on the value given for the Chef Server URL, you
|
140
|
-
may need to modify that setting after copying to a remote host.</p></li>
|
141
|
-
</ul>
|
142
|
-
|
143
|
-
|
144
|
-
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
145
|
-
|
146
|
-
<p> <strong>knife</strong>(1) <strong>knife-client</strong>(1)</p>
|
147
|
-
|
148
|
-
<h2 id="AUTHOR">AUTHOR</h2>
|
149
|
-
|
150
|
-
<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>
|
151
|
-
|
152
|
-
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
153
|
-
|
154
|
-
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
155
|
-
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
156
|
-
|
157
|
-
<h2 id="CHEF">CHEF</h2>
|
158
|
-
|
159
|
-
<p> Knife is distributed with Chef. <a href="http://wiki.opscode.com/display/chef/Home" data-bare-link="true">http://wiki.opscode.com/display/chef/Home</a></p>
|
160
|
-
|
161
|
-
|
162
|
-
<ol class='man-decor man-foot man foot'>
|
163
|
-
<li class='tl'>Chef 10.16.0.rc.1</li>
|
164
|
-
<li class='tc'>October 2012</li>
|
165
|
-
<li class='tr'>knife-configure(1)</li>
|
166
|
-
</ol>
|
167
|
-
|
168
|
-
</div>
|
169
|
-
</body>
|
170
|
-
</html>
|
@@ -1,241 +0,0 @@
|
|
1
|
-
<!DOCTYPE html>
|
2
|
-
<html>
|
3
|
-
<head>
|
4
|
-
<meta http-equiv='content-type' value='text/html;charset=utf8'>
|
5
|
-
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
|
6
|
-
<title>knife-cookbook-site(1) - Install and update open source cookbooks</title>
|
7
|
-
<style type='text/css' media='all'>
|
8
|
-
/* style: man */
|
9
|
-
body#manpage {margin:0}
|
10
|
-
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
|
11
|
-
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
|
12
|
-
.mp h2 {margin:10px 0 0 0}
|
13
|
-
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
|
14
|
-
.mp h3 {margin:0 0 0 4ex}
|
15
|
-
.mp dt {margin:0;clear:left}
|
16
|
-
.mp dt.flush {float:left;width:8ex}
|
17
|
-
.mp dd {margin:0 0 0 9ex}
|
18
|
-
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
|
19
|
-
.mp pre {margin-bottom:20px}
|
20
|
-
.mp pre+h2,.mp pre+h3 {margin-top:22px}
|
21
|
-
.mp h2+pre,.mp h3+pre {margin-top:5px}
|
22
|
-
.mp img {display:block;margin:auto}
|
23
|
-
.mp h1.man-title {display:none}
|
24
|
-
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
|
25
|
-
.mp h2 {font-size:16px;line-height:1.25}
|
26
|
-
.mp h1 {font-size:20px;line-height:2}
|
27
|
-
.mp {text-align:justify;background:#fff}
|
28
|
-
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
|
29
|
-
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
|
30
|
-
.mp u {text-decoration:underline}
|
31
|
-
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
|
32
|
-
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
|
33
|
-
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
|
34
|
-
.mp b.man-ref {font-weight:normal;color:#434241}
|
35
|
-
.mp pre {padding:0 4ex}
|
36
|
-
.mp pre code {font-weight:normal;color:#434241}
|
37
|
-
.mp h2+pre,h3+pre {padding-left:0}
|
38
|
-
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
|
39
|
-
ol.man-decor {width:100%}
|
40
|
-
ol.man-decor li.tl {text-align:left}
|
41
|
-
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
|
42
|
-
ol.man-decor li.tr {text-align:right;float:right}
|
43
|
-
</style>
|
44
|
-
<style type='text/css' media='all'>
|
45
|
-
/* style: toc */
|
46
|
-
.man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
|
47
|
-
.man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
|
48
|
-
.man-navigation a:hover {color:#111;text-decoration:underline}
|
49
|
-
</style>
|
50
|
-
</head>
|
51
|
-
<!--
|
52
|
-
The following styles are deprecated and will be removed at some point:
|
53
|
-
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
|
54
|
-
|
55
|
-
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
|
56
|
-
.man-navigation should be used instead.
|
57
|
-
-->
|
58
|
-
<body id='manpage'>
|
59
|
-
<div class='mp' id='man'>
|
60
|
-
|
61
|
-
<div class='man-navigation' style='display:none'>
|
62
|
-
<a href="#NAME">NAME</a>
|
63
|
-
<a href="#SYNOPSIS">SYNOPSIS</a>
|
64
|
-
<a href="#COOKBOOK-SITE-SUB-COMMANDS">COOKBOOK SITE SUB-COMMANDS</a>
|
65
|
-
<a href="#INSTALL">INSTALL</a>
|
66
|
-
<a href="#DOWNLOAD">DOWNLOAD</a>
|
67
|
-
<a href="#LIST">LIST</a>
|
68
|
-
<a href="#SEARCH">SEARCH</a>
|
69
|
-
<a href="#SHARE">SHARE</a>
|
70
|
-
<a href="#UNSHARE">UNSHARE</a>
|
71
|
-
<a href="#SHOW">SHOW</a>
|
72
|
-
<a href="#DESCRIPTION">DESCRIPTION</a>
|
73
|
-
<a href="#EXAMPLES">EXAMPLES</a>
|
74
|
-
<a href="#SEE-ALSO">SEE ALSO</a>
|
75
|
-
<a href="#AUTHOR">AUTHOR</a>
|
76
|
-
<a href="#DOCUMENTATION">DOCUMENTATION</a>
|
77
|
-
<a href="#CHEF">CHEF</a>
|
78
|
-
</div>
|
79
|
-
|
80
|
-
<ol class='man-decor man-head man head'>
|
81
|
-
<li class='tl'>knife-cookbook-site(1)</li>
|
82
|
-
<li class='tc'>Chef Manual</li>
|
83
|
-
<li class='tr'>knife-cookbook-site(1)</li>
|
84
|
-
</ol>
|
85
|
-
|
86
|
-
<h2 id="NAME">NAME</h2>
|
87
|
-
<p class="man-name">
|
88
|
-
<code>knife-cookbook-site</code> - <span class="man-whatis">Install and update open source cookbooks</span>
|
89
|
-
</p>
|
90
|
-
|
91
|
-
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
92
|
-
|
93
|
-
<p><strong>knife</strong> <strong>cookbook site</strong> <em>sub-command</em> <em>(options)</em></p>
|
94
|
-
|
95
|
-
<h2 id="COOKBOOK-SITE-SUB-COMMANDS">COOKBOOK SITE SUB-COMMANDS</h2>
|
96
|
-
|
97
|
-
<p><code>knife cookbook site</code> provides the following subcommands:</p>
|
98
|
-
|
99
|
-
<h2 id="INSTALL">INSTALL</h2>
|
100
|
-
|
101
|
-
<p><strong>cookbook site install COOKBOOK [VERSION]</strong> <em>(options)</em></p>
|
102
|
-
|
103
|
-
<dl>
|
104
|
-
<dt><code>-D</code>, <code>--skip-dependencies</code></dt><dd>Skip automatic installation of dependencies.</dd>
|
105
|
-
<dt><code>-o</code>, <code>--cookbook-path PATH</code></dt><dd>Install cookbooks to PATH</dd>
|
106
|
-
<dt><code>-B</code>, <code>--branch BRANCH</code></dt><dd>Default branch to work with [defaults to master]</dd>
|
107
|
-
</dl>
|
108
|
-
|
109
|
-
|
110
|
-
<p>Uses <span class="man-ref">git<span class="s">(1)</span></span> version control in conjunction with the cookbook site to
|
111
|
-
install community contributed cookbooks to your local cookbook
|
112
|
-
repository. Running <code>knife cookbook site install</code> does the following:</p>
|
113
|
-
|
114
|
-
<ol>
|
115
|
-
<li>A new "pristine copy" branch is created in git for tracking the
|
116
|
-
upstream;</li>
|
117
|
-
<li>All existing cookbooks are removed from the branch;</li>
|
118
|
-
<li>The cookbook is downloaded from the cookbook site in tarball form;</li>
|
119
|
-
<li>The downloaded cookbook is untarred, and its contents commited via git;</li>
|
120
|
-
<li>The pristine copy branch is merged into the master branch.</li>
|
121
|
-
</ol>
|
122
|
-
|
123
|
-
|
124
|
-
<p>By installing cookbook with this process, you can locally modify the
|
125
|
-
upstream cookbook in your master branch and let git maintain your
|
126
|
-
changes as a separate patch. When an updated upstream version becomes
|
127
|
-
available, you will be able to merge the upstream changes while
|
128
|
-
maintaining your local modifications.</p>
|
129
|
-
|
130
|
-
<p>Unless <em>--skip-dependencies</em> is specified, the process is applied recursively to all the
|
131
|
-
cookbooks <em>COOKBOOK</em> depends on (via metadata <em>dependencies</em>).</p>
|
132
|
-
|
133
|
-
<h2 id="DOWNLOAD">DOWNLOAD</h2>
|
134
|
-
|
135
|
-
<p><strong>knife cookbook site download COOKBOOK [VERSION]</strong> <em>(options)</em></p>
|
136
|
-
|
137
|
-
<dl>
|
138
|
-
<dt><code>-f</code>, <code>--file FILE</code></dt><dd>The filename to write to</dd>
|
139
|
-
<dt class="flush"><code>--force</code></dt><dd>Force download deprecated cookbook</dd>
|
140
|
-
</dl>
|
141
|
-
|
142
|
-
|
143
|
-
<p>Downloads a specific cookbook from the Community site, optionally
|
144
|
-
specifying a certain version.</p>
|
145
|
-
|
146
|
-
<h2 id="LIST">LIST</h2>
|
147
|
-
|
148
|
-
<p><strong>knife cookbook site list</strong> <em>(options)</em></p>
|
149
|
-
|
150
|
-
<dl>
|
151
|
-
<dt><code>-w</code>, <code>--with-uri</code></dt><dd>Show corresponding URIs</dd>
|
152
|
-
</dl>
|
153
|
-
|
154
|
-
|
155
|
-
<p>Lists available cookbooks from the Community site.</p>
|
156
|
-
|
157
|
-
<h2 id="SEARCH">SEARCH</h2>
|
158
|
-
|
159
|
-
<p><strong>knife cookbook site search QUERY</strong> <em>(options)</em></p>
|
160
|
-
|
161
|
-
<p>Searches for available cookbooks matching the specified query.</p>
|
162
|
-
|
163
|
-
<h2 id="SHARE">SHARE</h2>
|
164
|
-
|
165
|
-
<p><strong>knife cookbook site share COOKBOOK CATEGORY</strong> <em>(options)</em></p>
|
166
|
-
|
167
|
-
<dl>
|
168
|
-
<dt><code>-k</code>, <code>--key KEY</code></dt><dd>API Client Key</dd>
|
169
|
-
<dt><code>-u</code>, <code>--user USER</code></dt><dd>API Client Username</dd>
|
170
|
-
<dt><code>-o</code>, <code>--cookbook-path PATH:PATH</code></dt><dd>A colon-separated path to look for cookbooks in</dd>
|
171
|
-
</dl>
|
172
|
-
|
173
|
-
|
174
|
-
<p>Uploads the specified cookbook using the given category to the Opscode
|
175
|
-
cookbooks site. Requires a login user and certificate for the Opscode
|
176
|
-
Cookbooks site. By default, knife will use the username and API key
|
177
|
-
you've configured in your configuration file; otherwise you must
|
178
|
-
explicitly set these values on the command line or use an alternate
|
179
|
-
configuration file.</p>
|
180
|
-
|
181
|
-
<h2 id="UNSHARE">UNSHARE</h2>
|
182
|
-
|
183
|
-
<p><strong>knife cookbook site unshare COOKBOOK</strong></p>
|
184
|
-
|
185
|
-
<p>Stops sharing the specified cookbook on the Opscode cookbooks site.</p>
|
186
|
-
|
187
|
-
<h2 id="SHOW">SHOW</h2>
|
188
|
-
|
189
|
-
<p><strong>knife cookbook site show COOKBOOK [VERSION]</strong> <em>(options)</em></p>
|
190
|
-
|
191
|
-
<p>Shows information from the site about a particular cookbook.</p>
|
192
|
-
|
193
|
-
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
194
|
-
|
195
|
-
<p>The cookbook site, <a data-bare-link="true" href="http://community.opscode.com/">http://community.opscode.com/</a>, is a cookbook
|
196
|
-
distribution service operated by Opscode. This service provides users
|
197
|
-
with a central location to publish cookbooks for sharing with other
|
198
|
-
community members.</p>
|
199
|
-
|
200
|
-
<p><code>knife cookbook site</code> commands provide an interface to the cookbook
|
201
|
-
site's HTTP API. For commands that read data from the API, no account is
|
202
|
-
required. In order to upload cookbooks using the <code>knife cookbook site
|
203
|
-
share</code> command, you must create an account on the cookbook site and
|
204
|
-
configure your credentials via command line option or in your knife
|
205
|
-
configuration file.</p>
|
206
|
-
|
207
|
-
<h2 id="EXAMPLES">EXAMPLES</h2>
|
208
|
-
|
209
|
-
<p>Uploading cookbooks to the Opscode cookbooks site:</p>
|
210
|
-
|
211
|
-
<pre><code>knife cookbook site share example Other -k ~/.chef/USERNAME.pem -u USERNAME
|
212
|
-
</code></pre>
|
213
|
-
|
214
|
-
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
215
|
-
|
216
|
-
<p> <strong><span class="man-ref">knife-cookbook<span class="s">(1)</span></span></strong>
|
217
|
-
<a data-bare-link="true" href="http://community.opscode.com/cookbooks">http://community.opscode.com/cookbooks</a></p>
|
218
|
-
|
219
|
-
<h2 id="AUTHOR">AUTHOR</h2>
|
220
|
-
|
221
|
-
<p> Chef was written by Adam Jacob <a data-bare-link="true" href="mailto:adam@opscode.com">adam@opscode.com</a> with many contributions from the community.</p>
|
222
|
-
|
223
|
-
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
224
|
-
|
225
|
-
<p> This manual page was written by Joshua Timberman <a data-bare-link="true" href="mailto:joshua@opscode.com">joshua@opscode.com</a>.
|
226
|
-
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
227
|
-
|
228
|
-
<h2 id="CHEF">CHEF</h2>
|
229
|
-
|
230
|
-
<p> Knife is distributed with Chef. <a data-bare-link="true" href="http://wiki.opscode.com/display/chef/Home">http://wiki.opscode.com/display/chef/Home</a></p>
|
231
|
-
|
232
|
-
|
233
|
-
<ol class='man-decor man-foot man foot'>
|
234
|
-
<li class='tl'>Chef 10.16.0.rc.1</li>
|
235
|
-
<li class='tc'>October 2012</li>
|
236
|
-
<li class='tr'>knife-cookbook-site(1)</li>
|
237
|
-
</ol>
|
238
|
-
|
239
|
-
</div>
|
240
|
-
</body>
|
241
|
-
</html>
|
@@ -1,384 +0,0 @@
|
|
1
|
-
<!DOCTYPE html>
|
2
|
-
<html>
|
3
|
-
<head>
|
4
|
-
<meta http-equiv='content-type' value='text/html;charset=utf8'>
|
5
|
-
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
|
6
|
-
<title>knife-cookbook(1) - upload and manage chef cookbooks</title>
|
7
|
-
<style type='text/css' media='all'>
|
8
|
-
/* style: man */
|
9
|
-
body#manpage {margin:0}
|
10
|
-
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
|
11
|
-
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
|
12
|
-
.mp h2 {margin:10px 0 0 0}
|
13
|
-
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
|
14
|
-
.mp h3 {margin:0 0 0 4ex}
|
15
|
-
.mp dt {margin:0;clear:left}
|
16
|
-
.mp dt.flush {float:left;width:8ex}
|
17
|
-
.mp dd {margin:0 0 0 9ex}
|
18
|
-
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
|
19
|
-
.mp pre {margin-bottom:20px}
|
20
|
-
.mp pre+h2,.mp pre+h3 {margin-top:22px}
|
21
|
-
.mp h2+pre,.mp h3+pre {margin-top:5px}
|
22
|
-
.mp img {display:block;margin:auto}
|
23
|
-
.mp h1.man-title {display:none}
|
24
|
-
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
|
25
|
-
.mp h2 {font-size:16px;line-height:1.25}
|
26
|
-
.mp h1 {font-size:20px;line-height:2}
|
27
|
-
.mp {text-align:justify;background:#fff}
|
28
|
-
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
|
29
|
-
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
|
30
|
-
.mp u {text-decoration:underline}
|
31
|
-
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
|
32
|
-
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
|
33
|
-
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
|
34
|
-
.mp b.man-ref {font-weight:normal;color:#434241}
|
35
|
-
.mp pre {padding:0 4ex}
|
36
|
-
.mp pre code {font-weight:normal;color:#434241}
|
37
|
-
.mp h2+pre,h3+pre {padding-left:0}
|
38
|
-
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
|
39
|
-
ol.man-decor {width:100%}
|
40
|
-
ol.man-decor li.tl {text-align:left}
|
41
|
-
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
|
42
|
-
ol.man-decor li.tr {text-align:right;float:right}
|
43
|
-
</style>
|
44
|
-
<style type='text/css' media='all'>
|
45
|
-
/* style: toc */
|
46
|
-
.man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
|
47
|
-
.man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
|
48
|
-
.man-navigation a:hover {color:#111;text-decoration:underline}
|
49
|
-
</style>
|
50
|
-
</head>
|
51
|
-
<!--
|
52
|
-
The following styles are deprecated and will be removed at some point:
|
53
|
-
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
|
54
|
-
|
55
|
-
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
|
56
|
-
.man-navigation should be used instead.
|
57
|
-
-->
|
58
|
-
<body id='manpage'>
|
59
|
-
<div class='mp' id='man'>
|
60
|
-
|
61
|
-
<div class='man-navigation' style='display:none'>
|
62
|
-
<a href="#NAME">NAME</a>
|
63
|
-
<a href="#SYNOPSIS">SYNOPSIS</a>
|
64
|
-
<a href="#SUB-COMMANDS">SUB-COMMANDS</a>
|
65
|
-
<a href="#LIST">LIST</a>
|
66
|
-
<a href="#SHOW">SHOW</a>
|
67
|
-
<a href="#UPLOAD">UPLOAD</a>
|
68
|
-
<a href="#DOWNLOAD">DOWNLOAD</a>
|
69
|
-
<a href="#DELETE">DELETE</a>
|
70
|
-
<a href="#BULK-DELETE">BULK DELETE</a>
|
71
|
-
<a href="#COOKBOOK-CREATE">COOKBOOK CREATE</a>
|
72
|
-
<a href="#METADATA">METADATA</a>
|
73
|
-
<a href="#METADATA-FROM-FILE">METADATA FROM FILE</a>
|
74
|
-
<a href="#TEST">TEST</a>
|
75
|
-
<a href="#RECIPE-LIST">RECIPE LIST</a>
|
76
|
-
<a href="#DESCRIPTION">DESCRIPTION</a>
|
77
|
-
<a href="#SEE-ALSO">SEE ALSO</a>
|
78
|
-
<a href="#AUTHOR">AUTHOR</a>
|
79
|
-
<a href="#DOCUMENTATION">DOCUMENTATION</a>
|
80
|
-
<a href="#CHEF">CHEF</a>
|
81
|
-
</div>
|
82
|
-
|
83
|
-
<ol class='man-decor man-head man head'>
|
84
|
-
<li class='tl'>knife-cookbook(1)</li>
|
85
|
-
<li class='tc'>Chef Manual</li>
|
86
|
-
<li class='tr'>knife-cookbook(1)</li>
|
87
|
-
</ol>
|
88
|
-
|
89
|
-
<h2 id="NAME">NAME</h2>
|
90
|
-
<p class="man-name">
|
91
|
-
<code>knife-cookbook</code> - <span class="man-whatis">upload and manage chef cookbooks</span>
|
92
|
-
</p>
|
93
|
-
|
94
|
-
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
95
|
-
|
96
|
-
<p><strong>knife</strong> <strong>cookbook</strong> <em>sub-command</em> <em>(options)</em></p>
|
97
|
-
|
98
|
-
<h2 id="SUB-COMMANDS">SUB-COMMANDS</h2>
|
99
|
-
|
100
|
-
<p><code>knife cookbook</code> supports the following sub commands:</p>
|
101
|
-
|
102
|
-
<h2 id="LIST">LIST</h2>
|
103
|
-
|
104
|
-
<p><strong>knife cookbook list</strong> <em>(options)</em></p>
|
105
|
-
|
106
|
-
<dl>
|
107
|
-
<dt><code>-a</code>, <code>--all</code></dt><dd>show all versions of a cookbook instead of just the most recent</dd>
|
108
|
-
<dt><code>-w</code>, <code>--with-uri</code></dt><dd>show corresponding uris</dd>
|
109
|
-
</dl>
|
110
|
-
|
111
|
-
|
112
|
-
<p>Lists the cookbooks available on the Chef server.</p>
|
113
|
-
|
114
|
-
<h2 id="SHOW">SHOW</h2>
|
115
|
-
|
116
|
-
<p><strong>knife cookbook show cookbook [version] [part] [filename]</strong> <em>(options)</em></p>
|
117
|
-
|
118
|
-
<dl>
|
119
|
-
<dt><code>-f</code>, <code>--fqdn fqdn </code></dt><dd>the fqdn of the host to see the file for</dd>
|
120
|
-
<dt><code>-p</code>, <code>--platform platform </code></dt><dd>the platform to see the file for</dd>
|
121
|
-
<dt><code>-v</code>, <code>--platform-version version</code></dt><dd>the platform version to see the file for</dd>
|
122
|
-
<dt><code>-w</code>, <code>--with-uri</code></dt><dd>Show corresponding URIs</dd>
|
123
|
-
</dl>
|
124
|
-
|
125
|
-
|
126
|
-
<p>show a particular part of a <em>cookbook</em> for the specified <em>version</em>. <em>part</em> can be one of:</p>
|
127
|
-
|
128
|
-
<ul>
|
129
|
-
<li><em>attributes</em></li>
|
130
|
-
<li><em>definitions</em></li>
|
131
|
-
<li><em>files</em></li>
|
132
|
-
<li><em>libraries</em></li>
|
133
|
-
<li><em>providers</em></li>
|
134
|
-
<li><em>recipes</em></li>
|
135
|
-
<li><em>resources</em></li>
|
136
|
-
<li><em>templates</em></li>
|
137
|
-
</ul>
|
138
|
-
|
139
|
-
|
140
|
-
<h2 id="UPLOAD">UPLOAD</h2>
|
141
|
-
|
142
|
-
<p><strong>knife cookbook upload [cookbooks...]</strong> <em>(options)</em></p>
|
143
|
-
|
144
|
-
<dl>
|
145
|
-
<dt><code>-a</code>, <code>--all</code></dt><dd>upload all cookbooks, rather than just a single cookbook</dd>
|
146
|
-
<dt><code>-o</code>, <code>--cookbook-path path:path</code></dt><dd>a colon-separated path to look for cookbooks in</dd>
|
147
|
-
<dt><code>-d</code>, <code>--upload-dependencies</code></dt><dd>Uploads additional cookbooks that this cookbook lists in as
|
148
|
-
dependencies in its metadata.</dd>
|
149
|
-
<dt><code>-E</code>, <code>--environment ENVIRONMENT</code></dt><dd>An <em>ENVIRONMENT</em> to apply the uploaded cookbooks to. Specifying this
|
150
|
-
option will cause knife to edit the <em>ENVIRONMENT</em> to place a strict
|
151
|
-
version constraint on the cookbook version(s) uploaded.</dd>
|
152
|
-
<dt><code>--freeze</code></dt><dd>Sets the frozen flag on the uploaded cookbook(s) Any future attempt
|
153
|
-
to modify the cookbook without changing the version number will
|
154
|
-
return an error unless --force is specified.</dd>
|
155
|
-
<dt class="flush"><code>--force</code></dt><dd>Overrides the frozen flag on a cookbook, allowing you to overwrite a
|
156
|
-
cookbook version that has previously been uploaded with the --freeze
|
157
|
-
option.</dd>
|
158
|
-
</dl>
|
159
|
-
|
160
|
-
|
161
|
-
<p>Uploads one or more cookbooks from your local cookbook repository(ies)
|
162
|
-
to the Chef Server. Only files that don't yet exist on the server will
|
163
|
-
be uploaded.</p>
|
164
|
-
|
165
|
-
<p>As the command parses the name args as 1..n cookbook names:</p>
|
166
|
-
|
167
|
-
<pre><code>`knife cookbook upload COOKBOOK COOKBOOK ...`
|
168
|
-
</code></pre>
|
169
|
-
|
170
|
-
<p>works for one to many cookbooks.</p>
|
171
|
-
|
172
|
-
<h2 id="DOWNLOAD">DOWNLOAD</h2>
|
173
|
-
|
174
|
-
<p><strong>knife cookbook download cookbook [version]</strong> <em>(options)</em></p>
|
175
|
-
|
176
|
-
<dl>
|
177
|
-
<dt><code>-d</code>, <code>--dir download_directory</code></dt><dd>the directory to download the cookbook into</dd>
|
178
|
-
<dt><code>-f</code>, <code>--force</code></dt><dd>overwrite an existing directory with the download</dd>
|
179
|
-
<dt><code>-n</code>, <code>--latest</code></dt><dd>download the latest version of the cookbook</dd>
|
180
|
-
</dl>
|
181
|
-
|
182
|
-
|
183
|
-
<p>download a cookbook from the chef server. if no version is specified and
|
184
|
-
only one version exists on the server, that version will be downloaded.
|
185
|
-
if no version is specified and multiple versions are available on the
|
186
|
-
server, you will be prompted for a version to download.</p>
|
187
|
-
|
188
|
-
<h2 id="DELETE">DELETE</h2>
|
189
|
-
|
190
|
-
<p><strong>knife cookbook delete cookbook [version]</strong> <em>(options)</em></p>
|
191
|
-
|
192
|
-
<dl>
|
193
|
-
<dt><code>-a</code>, <code>--all</code></dt><dd>delete all versions</dd>
|
194
|
-
<dt><code>-p</code>, <code>--purge</code></dt><dd>purge files from backing store. this will disable any cookbook that contains any of the same files as the cookbook being purged.</dd>
|
195
|
-
</dl>
|
196
|
-
|
197
|
-
|
198
|
-
<p>delete the specified <em>version</em> of the named <em>cookbook</em>. if no version is
|
199
|
-
specified, and only one version exists on the server, that version will
|
200
|
-
be deleted. if multiple versions are available on the server, you will
|
201
|
-
be prompted for a version to delete.</p>
|
202
|
-
|
203
|
-
<h2 id="BULK-DELETE">BULK DELETE</h2>
|
204
|
-
|
205
|
-
<p><strong>knife cookbook bulk delete regex</strong> <em>(options)</em></p>
|
206
|
-
|
207
|
-
<dl>
|
208
|
-
<dt><code>-p</code>, <code>--purge</code></dt><dd>purge files from backing store. this will disable any cookbook that
|
209
|
-
contains any of the same files as the cookbook being purged.</dd>
|
210
|
-
</dl>
|
211
|
-
|
212
|
-
|
213
|
-
<p>delete cookbooks on the chef server based on a regular expression. the
|
214
|
-
regular expression (<em>regex</em>) should be in quotes, not in //'s.</p>
|
215
|
-
|
216
|
-
<h2 id="COOKBOOK-CREATE">COOKBOOK CREATE</h2>
|
217
|
-
|
218
|
-
<p><strong>knife cookbook create cookbook</strong> <em>(options)</em></p>
|
219
|
-
|
220
|
-
<dl>
|
221
|
-
<dt><code>-o</code>, <code>--cookbook-path path</code></dt><dd>the directory where the cookbook will be created</dd>
|
222
|
-
<dt><code>-r</code>, <code>--readme-format format</code></dt><dd>format of the readme file md, mkd, txt, rdoc</dd>
|
223
|
-
<dt><code>-c</code>, <code>--copyright copyright</code></dt><dd>name of copyright holder</dd>
|
224
|
-
<dt><code>-i</code>, <code>--license license</code></dt><dd>license for cookbook, apachev2 or none</dd>
|
225
|
-
<dt><code>-e</code>, <code>--email email</code></dt><dd>email address of cookbook maintainer</dd>
|
226
|
-
</dl>
|
227
|
-
|
228
|
-
|
229
|
-
<p>this is a helper command that creates a new cookbook directory in the
|
230
|
-
<code>cookbook_path</code>. the following directories and files are created for the
|
231
|
-
named cookbook.</p>
|
232
|
-
|
233
|
-
<ul>
|
234
|
-
<li>cookbook/attributes</li>
|
235
|
-
<li>cookbook/definitions</li>
|
236
|
-
<li>cookbook/files/default</li>
|
237
|
-
<li>cookbook/libraries</li>
|
238
|
-
<li>cookbook/metadata.rb</li>
|
239
|
-
<li>cookbook/providers</li>
|
240
|
-
<li>cookbook/readme.md</li>
|
241
|
-
<li>cookbook/recipes/default.rb</li>
|
242
|
-
<li>cookbook/resources</li>
|
243
|
-
<li>cookbook/templates/default</li>
|
244
|
-
</ul>
|
245
|
-
|
246
|
-
|
247
|
-
<p>supported readme formats are 'md' (default), 'mkd', 'txt', 'rdoc'. the
|
248
|
-
readme file will be written with the specified extension and a set of
|
249
|
-
helpful starting headers.</p>
|
250
|
-
|
251
|
-
<p>specify <code>-c</code> or <code>--copyright</code> with the name of the copyright holder as
|
252
|
-
your name or your company/organization name in a quoted string. if this
|
253
|
-
value is not specified an all-caps string <code>your_company_name</code> is used
|
254
|
-
which can be easily changed with find/replace.</p>
|
255
|
-
|
256
|
-
<p>specify <code>-i</code> or <code>--license</code> with the license that the cookbook is
|
257
|
-
distributed under for sharing with other people or posting to the
|
258
|
-
opscode cookbooks site. be aware of the licenses of files you put inside
|
259
|
-
the cookbook and follow any restrictions they describe. when using
|
260
|
-
<code>none</code> (default) or <code>apachev2</code>, comment header text and metadata file
|
261
|
-
are pre-filled. the <code>none</code> license will be treated as
|
262
|
-
non-redistributable.</p>
|
263
|
-
|
264
|
-
<p>specify <code>-e</code> or <code>--email</code> with the email address of the cookbook's
|
265
|
-
maintainer. if this value is not specified, an all-caps string
|
266
|
-
<code>your_email</code> is used which can easily be changed with find/replace.</p>
|
267
|
-
|
268
|
-
<p>the cookbook copyright, license, email and readme_format settings can be filled in the
|
269
|
-
<code>knife.rb</code>, for example with default values:</p>
|
270
|
-
|
271
|
-
<pre><code>cookbook_copyright "your_company_name"
|
272
|
-
cookbook_license "none"
|
273
|
-
cookbook_email "your_email"
|
274
|
-
readme_format "md"
|
275
|
-
</code></pre>
|
276
|
-
|
277
|
-
<h2 id="METADATA">METADATA</h2>
|
278
|
-
|
279
|
-
<p><strong>knife cookbook metadata cookbook</strong> <em>(options)</em></p>
|
280
|
-
|
281
|
-
<dl>
|
282
|
-
<dt><code>-a</code>, <code>--all</code></dt><dd>generate metadata for all cookbooks, rather than just a single cookbook</dd>
|
283
|
-
<dt><code>-o</code>, <code>--cookbook-path path:path</code></dt><dd>a colon-separated path to look for cookbooks in</dd>
|
284
|
-
</dl>
|
285
|
-
|
286
|
-
|
287
|
-
<p>generate cookbook metadata for the named <em>cookbook</em>. the <em>path</em> used here specifies where the cookbooks directory is located and corresponds to the <code>cookbook_path</code> configuration option.</p>
|
288
|
-
|
289
|
-
<h2 id="METADATA-FROM-FILE">METADATA FROM FILE</h2>
|
290
|
-
|
291
|
-
<p><strong>knife cookbook metadata from file</strong> <em>(options)</em></p>
|
292
|
-
|
293
|
-
<p>load the cookbook metadata from a specified file.</p>
|
294
|
-
|
295
|
-
<h2 id="TEST">TEST</h2>
|
296
|
-
|
297
|
-
<p><strong>knife cookbook test [cookbooks...]</strong> <em>(options)</em></p>
|
298
|
-
|
299
|
-
<dl>
|
300
|
-
<dt><code>-a</code>, <code>--all</code></dt><dd>test all cookbooks, rather than just a single cookbook</dd>
|
301
|
-
<dt><code>-o</code>, <code>--cookbook-path path:path</code></dt><dd>a colon-separated path to look for cookbooks in</dd>
|
302
|
-
</dl>
|
303
|
-
|
304
|
-
|
305
|
-
<p>test the specified cookbooks for syntax errors. this uses the built-in
|
306
|
-
ruby syntax checking option for files in the cookbook ending in <code>.rb</code>,
|
307
|
-
and the erb syntax check for files ending in <code>.erb</code> (templates).</p>
|
308
|
-
|
309
|
-
<h2 id="RECIPE-LIST">RECIPE LIST</h2>
|
310
|
-
|
311
|
-
<p><strong>knife recipe list [PATTERN]</strong></p>
|
312
|
-
|
313
|
-
<p>List available recipes from the server. Specify <em>PATTERN</em> as a regular
|
314
|
-
expression to limit the results.</p>
|
315
|
-
|
316
|
-
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
317
|
-
|
318
|
-
<p>Cookbooks are the fundamental unit of distribution in Chef. They
|
319
|
-
encapsulate all recipes of resources and assets used to configure a
|
320
|
-
particular aspect of the infrastructure. The following sub-commands can
|
321
|
-
be used to manipulate the cookbooks stored on the Chef Server.</p>
|
322
|
-
|
323
|
-
<p>On disk, cookbooks are directories with a defined structure. The
|
324
|
-
following directories may appear within a cookbook:</p>
|
325
|
-
|
326
|
-
<dl>
|
327
|
-
<dt>COOKBOOK/attributes/</dt><dd>Ruby files that define default parameters to be used in recipes</dd>
|
328
|
-
<dt>COOKBOOK/definitions/</dt><dd>Ruby files that contain <em>resource definitions</em></dd>
|
329
|
-
<dt>COOKBOOK/files/SPECIFICITY</dt><dd>Files of arbitrary type. These files may be downloaded by
|
330
|
-
<span class="man-ref">chef-client<span class="s">(8)</span></span> when configuring a host.</dd>
|
331
|
-
<dt>COOKBOOK/libraries/</dt><dd>Ruby files that contain library code needed for recipes</dd>
|
332
|
-
<dt>COOKBOOK/providers/</dt><dd>Ruby files that contain Lightweight Provider definitions</dd>
|
333
|
-
<dt>COOKBOOK/recipes/</dt><dd>Ruby files that use Chef's recipe DSL to describe the desired
|
334
|
-
configuration of a system</dd>
|
335
|
-
<dt>COOKBOOK/resources/</dt><dd>Ruby files that contain Lightweight Resource definitions</dd>
|
336
|
-
<dt>COOKBOOK/templates/SPECIFICITY</dt><dd>ERuby (ERb) template files. These are referenced by <em>recipes</em> and
|
337
|
-
evaluated to dynamically generate configuration files.</dd>
|
338
|
-
</dl>
|
339
|
-
|
340
|
-
|
341
|
-
<p><strong>SPECIFICITY</strong> is a feature of <em>files</em> and <em>templates</em> that allow you
|
342
|
-
to specify alternate files to be used on a specific OS platform or host.
|
343
|
-
The default specificity setting is <em>default</em>, that is files in
|
344
|
-
<code>COOKBOOK/files/default</code> will be used when a more specific copy is not
|
345
|
-
available. Further documentation for this feature is available on the
|
346
|
-
Chef wiki: <a href="http://wiki.opscode.com/display/chef/File+Distribution#FileDistribution-FileSpecificity" data-bare-link="true">http://wiki.opscode.com/display/chef/File+Distribution#FileDistribution-FileSpecificity</a></p>
|
347
|
-
|
348
|
-
<p>Cookbooks also contain a metadata file that defines various properties
|
349
|
-
of the cookbook. The most important of these are the <em>version</em> and the
|
350
|
-
<em>dependencies</em>. The <em>version</em> is used in combination with environments
|
351
|
-
to select which copy of a given cookbook is distributed to a node. The
|
352
|
-
<em>dependencies</em> are used by the server to determine which additional
|
353
|
-
cookbooks must be distributed to a given host when it requires a
|
354
|
-
cookbook.</p>
|
355
|
-
|
356
|
-
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
357
|
-
|
358
|
-
<p> <strong><span class="man-ref">knife-environment<span class="s">(1)</span></span></strong> <strong><span class="man-ref">knife-cookbook-site<span class="s">(1)</span></span></strong>
|
359
|
-
<a href="http://wiki.opscode.com/display/chef/Cookbooks" data-bare-link="true">http://wiki.opscode.com/display/chef/Cookbooks</a>
|
360
|
-
<a href="http://wiki.opscode.com/display/chef/Metadata" data-bare-link="true">http://wiki.opscode.com/display/chef/Metadata</a></p>
|
361
|
-
|
362
|
-
<h2 id="AUTHOR">AUTHOR</h2>
|
363
|
-
|
364
|
-
<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>
|
365
|
-
|
366
|
-
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
367
|
-
|
368
|
-
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
369
|
-
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
370
|
-
|
371
|
-
<h2 id="CHEF">CHEF</h2>
|
372
|
-
|
373
|
-
<p> Knife is distributed with Chef. <a href="http://wiki.opscode.com/display/chef/Home" data-bare-link="true">http://wiki.opscode.com/display/chef/Home</a></p>
|
374
|
-
|
375
|
-
|
376
|
-
<ol class='man-decor man-foot man foot'>
|
377
|
-
<li class='tl'>Chef 10.16.0.rc.1</li>
|
378
|
-
<li class='tc'>October 2012</li>
|
379
|
-
<li class='tr'>knife-cookbook(1)</li>
|
380
|
-
</ol>
|
381
|
-
|
382
|
-
</div>
|
383
|
-
</body>
|
384
|
-
</html>
|