microwave 1.0.2 → 1.0.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (125) hide show
  1. data/Rakefile +4 -4
  2. data/bin/chef-solo +2 -0
  3. data/spec/spec_helper.rb +2 -0
  4. data/spec/unit/checksum/storage/filesystem_spec.rb +4 -4
  5. data/spec/unit/config_spec.rb +7 -4
  6. data/spec/unit/data_bag_spec.rb +11 -11
  7. data/spec/unit/formatters/error_inspectors/compile_error_inspector_spec.rb +8 -8
  8. data/spec/unit/formatters/error_inspectors/resource_failure_inspector_spec.rb +5 -5
  9. metadata +10 -124
  10. data/distro/README +0 -2
  11. data/distro/arch/etc/conf.d/chef-client.conf +0 -5
  12. data/distro/arch/etc/conf.d/chef-expander.conf +0 -8
  13. data/distro/arch/etc/conf.d/chef-server-webui.conf +0 -10
  14. data/distro/arch/etc/conf.d/chef-server.conf +0 -10
  15. data/distro/arch/etc/conf.d/chef-solr.conf +0 -8
  16. data/distro/arch/etc/rc.d/chef-client +0 -90
  17. data/distro/arch/etc/rc.d/chef-expander +0 -78
  18. data/distro/arch/etc/rc.d/chef-server +0 -78
  19. data/distro/arch/etc/rc.d/chef-server-webui +0 -78
  20. data/distro/arch/etc/rc.d/chef-solr +0 -78
  21. data/distro/common/html/chef-client.8.html +0 -145
  22. data/distro/common/html/chef-expander.8.html +0 -164
  23. data/distro/common/html/chef-expanderctl.8.html +0 -146
  24. data/distro/common/html/chef-server-webui.8.html +0 -185
  25. data/distro/common/html/chef-server.8.html +0 -182
  26. data/distro/common/html/chef-solo.8.html +0 -191
  27. data/distro/common/html/chef-solr.8.html +0 -165
  28. data/distro/common/html/knife-bootstrap.1.html +0 -241
  29. data/distro/common/html/knife-client.1.html +0 -219
  30. data/distro/common/html/knife-configure.1.html +0 -170
  31. data/distro/common/html/knife-cookbook-site.1.html +0 -241
  32. data/distro/common/html/knife-cookbook.1.html +0 -384
  33. data/distro/common/html/knife-data-bag.1.html +0 -238
  34. data/distro/common/html/knife-environment.1.html +0 -267
  35. data/distro/common/html/knife-exec.1.html +0 -134
  36. data/distro/common/html/knife-index.1.html +0 -125
  37. data/distro/common/html/knife-node.1.html +0 -250
  38. data/distro/common/html/knife-recipe.1.html +0 -92
  39. data/distro/common/html/knife-role.1.html +0 -200
  40. data/distro/common/html/knife-search.1.html +0 -288
  41. data/distro/common/html/knife-ssh.1.html +0 -156
  42. data/distro/common/html/knife-status.1.html +0 -128
  43. data/distro/common/html/knife-tag.1.html +0 -137
  44. data/distro/common/html/knife.1.html +0 -320
  45. data/distro/common/html/shef.1.html +0 -283
  46. data/distro/common/man/man1/knife-bootstrap.1 +0 -201
  47. data/distro/common/man/man1/knife-client.1 +0 -99
  48. data/distro/common/man/man1/knife-configure.1 +0 -88
  49. data/distro/common/man/man1/knife-cookbook-site.1 +0 -145
  50. data/distro/common/man/man1/knife-cookbook.1 +0 -345
  51. data/distro/common/man/man1/knife-data-bag.1 +0 -136
  52. data/distro/common/man/man1/knife-environment.1 +0 -178
  53. data/distro/common/man/man1/knife-exec.1 +0 -46
  54. data/distro/common/man/man1/knife-index.1 +0 -29
  55. data/distro/common/man/man1/knife-node.1 +0 -134
  56. data/distro/common/man/man1/knife-role.1 +0 -88
  57. data/distro/common/man/man1/knife-search.1 +0 -280
  58. data/distro/common/man/man1/knife-ssh.1 +0 -79
  59. data/distro/common/man/man1/knife-status.1 +0 -29
  60. data/distro/common/man/man1/knife-tag.1 +0 -43
  61. data/distro/common/man/man1/knife.1 +0 -288
  62. data/distro/common/man/man1/shef.1 +0 -256
  63. data/distro/common/man/man8/chef-client.8 +0 -104
  64. data/distro/common/man/man8/chef-expander.8 +0 -97
  65. data/distro/common/man/man8/chef-expanderctl.8 +0 -62
  66. data/distro/common/man/man8/chef-server-webui.8 +0 -155
  67. data/distro/common/man/man8/chef-server.8 +0 -147
  68. data/distro/common/man/man8/chef-solo.8 +0 -158
  69. data/distro/common/man/man8/chef-solr.8 +0 -122
  70. data/distro/common/markdown/README +0 -3
  71. data/distro/common/markdown/man1/knife-bootstrap.mkd +0 -141
  72. data/distro/common/markdown/man1/knife-client.mkd +0 -103
  73. data/distro/common/markdown/man1/knife-configure.mkd +0 -70
  74. data/distro/common/markdown/man1/knife-cookbook-site.mkd +0 -123
  75. data/distro/common/markdown/man1/knife-cookbook.mkd +0 -263
  76. data/distro/common/markdown/man1/knife-data-bag.mkd +0 -121
  77. data/distro/common/markdown/man1/knife-environment.mkd +0 -151
  78. data/distro/common/markdown/man1/knife-exec.mkd +0 -37
  79. data/distro/common/markdown/man1/knife-index.mkd +0 -30
  80. data/distro/common/markdown/man1/knife-node.mkd +0 -130
  81. data/distro/common/markdown/man1/knife-role.mkd +0 -85
  82. data/distro/common/markdown/man1/knife-search.mkd +0 -180
  83. data/distro/common/markdown/man1/knife-ssh.mkd +0 -69
  84. data/distro/common/markdown/man1/knife-status.mkd +0 -36
  85. data/distro/common/markdown/man1/knife-tag.mkd +0 -39
  86. data/distro/common/markdown/man1/knife.mkd +0 -218
  87. data/distro/common/markdown/man1/shef.mkd +0 -189
  88. data/distro/common/markdown/man8/chef-client.mkd +0 -74
  89. data/distro/common/markdown/man8/chef-expander.mkd +0 -82
  90. data/distro/common/markdown/man8/chef-expanderctl.mkd +0 -58
  91. data/distro/common/markdown/man8/chef-server-webui.mkd +0 -121
  92. data/distro/common/markdown/man8/chef-server.mkd +0 -121
  93. data/distro/common/markdown/man8/chef-solo.mkd +0 -107
  94. data/distro/common/markdown/man8/chef-solr.mkd +0 -89
  95. data/distro/debian/etc/default/chef-client +0 -4
  96. data/distro/debian/etc/default/chef-expander +0 -8
  97. data/distro/debian/etc/default/chef-server +0 -9
  98. data/distro/debian/etc/default/chef-server-webui +0 -9
  99. data/distro/debian/etc/default/chef-solr +0 -8
  100. data/distro/debian/etc/init.d/chef-client +0 -210
  101. data/distro/debian/etc/init.d/chef-expander +0 -176
  102. data/distro/debian/etc/init.d/chef-server +0 -122
  103. data/distro/debian/etc/init.d/chef-server-webui +0 -123
  104. data/distro/debian/etc/init.d/chef-solr +0 -176
  105. data/distro/debian/etc/init/chef-client.conf +0 -17
  106. data/distro/debian/etc/init/chef-expander.conf +0 -17
  107. data/distro/debian/etc/init/chef-server-webui.conf +0 -17
  108. data/distro/debian/etc/init/chef-server.conf +0 -17
  109. data/distro/debian/etc/init/chef-solr.conf +0 -17
  110. data/distro/redhat/etc/init.d/chef-client +0 -121
  111. data/distro/redhat/etc/init.d/chef-expander +0 -104
  112. data/distro/redhat/etc/init.d/chef-server +0 -112
  113. data/distro/redhat/etc/init.d/chef-server-webui +0 -112
  114. data/distro/redhat/etc/init.d/chef-solr +0 -104
  115. data/distro/redhat/etc/logrotate.d/chef-client +0 -8
  116. data/distro/redhat/etc/logrotate.d/chef-expander +0 -8
  117. data/distro/redhat/etc/logrotate.d/chef-server +0 -8
  118. data/distro/redhat/etc/logrotate.d/chef-server-webui +0 -8
  119. data/distro/redhat/etc/logrotate.d/chef-solr +0 -8
  120. data/distro/redhat/etc/sysconfig/chef-client +0 -15
  121. data/distro/redhat/etc/sysconfig/chef-expander +0 -7
  122. data/distro/redhat/etc/sysconfig/chef-server +0 -14
  123. data/distro/redhat/etc/sysconfig/chef-server-webui +0 -14
  124. data/distro/redhat/etc/sysconfig/chef-solr +0 -8
  125. 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="&#x6d;&#x61;&#105;&#x6c;&#x74;&#111;&#x3a;&#97;&#x64;&#x61;&#x6d;&#x40;&#111;&#x70;&#x73;&#99;&#111;&#x64;&#x65;&#x2e;&#99;&#111;&#x6d;" data-bare-link="true">&#x61;&#x64;&#97;&#109;&#x40;&#111;&#112;&#115;&#99;&#x6f;&#100;&#x65;&#46;&#x63;&#x6f;&#109;</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="&#109;&#97;&#105;&#x6c;&#x74;&#x6f;&#x3a;&#x6a;&#x6f;&#115;&#104;&#117;&#x61;&#x40;&#x6f;&#112;&#115;&#99;&#x6f;&#x64;&#101;&#x2e;&#99;&#111;&#109;" data-bare-link="true">&#106;&#111;&#115;&#x68;&#x75;&#97;&#x40;&#x6f;&#112;&#x73;&#99;&#x6f;&#100;&#101;&#x2e;&#99;&#111;&#x6d;</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="&#x6d;&#x61;&#105;&#x6c;&#x74;&#111;&#x3a;&#97;&#x64;&#x61;&#x6d;&#x40;&#111;&#x70;&#x73;&#99;&#111;&#x64;&#x65;&#x2e;&#99;&#111;&#x6d;">&#x61;&#x64;&#97;&#109;&#x40;&#111;&#112;&#115;&#99;&#x6f;&#100;&#x65;&#46;&#x63;&#x6f;&#109;</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="&#109;&#97;&#105;&#x6c;&#x74;&#x6f;&#x3a;&#x6a;&#x6f;&#115;&#104;&#117;&#x61;&#x40;&#x6f;&#112;&#115;&#99;&#x6f;&#x64;&#101;&#x2e;&#99;&#111;&#109;">&#106;&#111;&#115;&#x68;&#x75;&#97;&#x40;&#x6f;&#112;&#x73;&#99;&#x6f;&#100;&#101;&#x2e;&#99;&#111;&#x6d;</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="&#x6d;&#97;&#105;&#108;&#x74;&#x6f;&#58;&#x61;&#100;&#97;&#x6d;&#x40;&#111;&#112;&#115;&#99;&#111;&#100;&#101;&#x2e;&#99;&#111;&#109;" data-bare-link="true">&#97;&#x64;&#x61;&#109;&#x40;&#x6f;&#x70;&#115;&#99;&#111;&#x64;&#101;&#x2e;&#99;&#111;&#x6d;</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="&#109;&#97;&#105;&#x6c;&#116;&#x6f;&#58;&#x6a;&#x6f;&#115;&#x68;&#117;&#x61;&#64;&#x6f;&#x70;&#x73;&#99;&#111;&#x64;&#x65;&#x2e;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#106;&#x6f;&#x73;&#104;&#x75;&#97;&#x40;&#x6f;&#112;&#115;&#99;&#x6f;&#100;&#x65;&#x2e;&#x63;&#111;&#x6d;</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>