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,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-bootstrap(1) - Install Chef Client on a remote host</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="#EXAMPLES">EXAMPLES</a>
66
- <a href="#BUGS">BUGS</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-bootstrap(1)</li>
75
- <li class='tc'>Chef Manual</li>
76
- <li class='tr'>knife-bootstrap(1)</li>
77
- </ol>
78
-
79
- <h2 id="NAME">NAME</h2>
80
- <p class="man-name">
81
- <code>knife-bootstrap</code> - <span class="man-whatis">Install Chef Client on a remote host</span>
82
- </p>
83
-
84
- <h2 id="SYNOPSIS">SYNOPSIS</h2>
85
-
86
- <p><strong>knife</strong> <strong>bootstrap</strong> <em>(options)</em></p>
87
-
88
- <dl>
89
- <dt><code>-i</code>, <code>--identity-file IDENTITY_FILE</code></dt><dd>The SSH identity file used for authentication</dd>
90
- <dt><code>-N</code>, <code>--node-name NAME</code></dt><dd>The Chef node name for your new node</dd>
91
- <dt><code>-P</code>, <code>--ssh-password PASSWORD</code></dt><dd>The ssh password</dd>
92
- <dt><code>-x</code>, <code>--ssh-user USERNAME</code></dt><dd>The ssh username</dd>
93
- <dt><code>-p</code>, <code>--ssh-port PORT</code></dt><dd>The ssh port</dd>
94
- <dt><code>--bootstrap-version VERSION</code></dt><dd>The version of Chef to install</dd>
95
- <dt><code>--bootstrap-proxy PROXY_URL</code></dt><dd><code>The proxy server for the node being bootstrapped</code></dd>
96
- <dt><code>--prerelease</code></dt><dd>Install pre-release Chef gems</dd>
97
- <dt><code>-r</code>, <code>--run-list RUN_LIST</code></dt><dd>Comma separated list of roles/recipes to apply</dd>
98
- <dt><code>--template-file TEMPLATE</code></dt><dd>Full path to location of template to use</dd>
99
- <dt class="flush"><code>--sudo</code></dt><dd>Execute the bootstrap via sudo</dd>
100
- <dt><code>-d</code>, <code>--distro DISTRO</code></dt><dd>Bootstrap a distro using a template</dd>
101
- <dt><code>--[no-]host-key-verify</code></dt><dd>Enable host key verification, which is the default behavior.</dd>
102
- <dt><code>--hint HINT_NAME[=HINT_FILE]</code></dt><dd>Provide the name of a hint (with option JSON file) to set for use by
103
- Ohai plugins.</dd>
104
- </dl>
105
-
106
-
107
- <h2 id="DESCRIPTION">DESCRIPTION</h2>
108
-
109
- <p>Performs a Chef Bootstrap on the target node. The goal of the bootstrap
110
- is to get Chef installed on the target system so it can run Chef Client
111
- with a Chef Server. The main assumption is a baseline OS installation
112
- exists. This sub-command is used internally by some cloud computing
113
- plugins.</p>
114
-
115
- <p>The bootstrap sub-command supports supplying a template to perform the
116
- bootstrap steps. If the distro is not specified (via <code>-d</code> or <code>--distro</code>
117
- option), an Ubuntu 10.04 host bootstrapped with RubyGems is assumed. The
118
- <strong>DISTRO</strong> value corresponds to the base filename of the template, in
119
- other words <code>DISTRO</code>.erb. A template file can be specified with the
120
- <code>--template-file</code> option in which case the <strong>DISTRO</strong> is not used. The
121
- sub-command looks in the following locations for the template to use:</p>
122
-
123
- <ul>
124
- <li><code>bootstrap</code> directory in the installed Chef Knife library.</li>
125
- <li><code>bootstrap</code> directory in the <code>$PWD/.chef</code>.</li>
126
- <li><code>bootstrap</code> directory in the users <code>$HOME/.chef</code>.</li>
127
- </ul>
128
-
129
-
130
- <p>The default bootstrap templates are scripts that get copied to the
131
- target node (FQDN). The following distros are supported:</p>
132
-
133
- <ul>
134
- <li>centos5-gems</li>
135
- <li>fedora13-gems</li>
136
- <li>ubuntu10.04-gems</li>
137
- <li>ubuntu10.04-apt</li>
138
- </ul>
139
-
140
-
141
- <p>The gems installations will use RubyGems 1.3.6 and Chef installed as a
142
- gem. The apt installation will use the Opscode APT repository.</p>
143
-
144
- <p>In addition to handling the software installation, these bootstrap
145
- templates do the following:</p>
146
-
147
- <ul>
148
- <li>Write the validation.pem per the local knife configuration.</li>
149
- <li>Write a default config file for Chef (<code>/etc/chef/client.rb</code>) using values from the <code>knife.rb</code>.</li>
150
- <li>Create a JSON attributes file containing the specified run list and run Chef.</li>
151
- </ul>
152
-
153
-
154
- <p>In the case of the RubyGems, the <code>client.rb</code> will be written from
155
- scratch with a minimal set of values; see <strong>EXAMPLES</strong>. In the case of
156
- APT Package installation, <code>client.rb</code> will have the
157
- <code>validation_client_name</code> appended if it is not set to <code>chef-validator</code>
158
- (default config value), and the <code>node_name</code> will be added if
159
- <code>chef_node_name</code> option is specified.</p>
160
-
161
- <p>When this is complete, the bootstrapped node will have:</p>
162
-
163
- <ul>
164
- <li>Latest Chef version installed from RubyGems or APT Packages from Opscode. This may be a later version than the local system.</li>
165
- <li>Be validated with the configured Chef Server.</li>
166
- <li>Have run Chef with its default run list if one is specfied.</li>
167
- </ul>
168
-
169
-
170
- <p>Additional custom bootstrap templates can be created and stored in
171
- <code>.chef/bootstrap/DISTRO.erb</code>, replacing <strong>DISTRO</strong> with the value passed
172
- with the <code>-d</code> or <code>--distro</code> option. See <strong>EXAMPLES</strong> for more
173
- information.</p>
174
-
175
- <h2 id="EXAMPLES">EXAMPLES</h2>
176
-
177
- <p>Setting up a custom bootstrap is fairly straightforward. Create a
178
- <code>.chef/bootstrap</code> directory in your Chef Repository or in
179
- <code>$HOME/.chef/bootstrap</code>. Then create the ERB template file.</p>
180
-
181
- <pre><code>mkdir ~/.chef/bootstrap
182
- vi ~/.chef/bootstrap/debian5.0-apt.erb
183
- </code></pre>
184
-
185
- <p>For example, to create a new bootstrap template that should be used when
186
- setting up a new Debian node. Edit the template to run the commands, set
187
- up the validation certificate and the client configuration file, and
188
- finally to run chef-client on completion. The bootstrap template can be
189
- called with:</p>
190
-
191
- <pre><code>knife bootstrap mynode.example.com --template-file ~/.chef/bootstrap/debian5.0-apt.erb
192
- </code></pre>
193
-
194
- <p>Or,</p>
195
-
196
- <pre><code>knife bootstrap mynode.example.com --distro debian5.0-apt
197
- </code></pre>
198
-
199
- <p>The <code>--distro</code> parameter will automatically look in the
200
- <code>~/.chef/bootstrap</code> directory for a file named <code>debian5.0-apt.erb</code>.</p>
201
-
202
- <p>Templates provided by the Chef installation are located in
203
- <code>BASEDIR/lib/chef/knife/bootstrap/*.erb</code>, where <em>BASEDIR</em> is the
204
- location where the package or Gem installed the Chef client libraries.</p>
205
-
206
- <h2 id="BUGS">BUGS</h2>
207
-
208
- <p><code>knife bootstrap</code> is not capable of bootstrapping multiple hosts in
209
- parallel.</p>
210
-
211
- <p>The bootstrap script is passed as an argument to <span class="man-ref">sh<span class="s">(1)</span></span> on the remote
212
- system, so sensitive information contained in the script will be visible
213
- to other users via the process list using tools such as <span class="man-ref">ps<span class="s">(1)</span></span>.</p>
214
-
215
- <h2 id="SEE-ALSO">SEE ALSO</h2>
216
-
217
- <p> <strong>knife-ssh</strong>(1)</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;&#x69;&#108;&#116;&#x6f;&#58;&#97;&#100;&#97;&#x6d;&#64;&#x6f;&#x70;&#115;&#99;&#111;&#100;&#x65;&#46;&#x63;&#x6f;&#x6d;">&#97;&#x64;&#97;&#109;&#x40;&#111;&#x70;&#115;&#x63;&#111;&#x64;&#101;&#46;&#99;&#111;&#x6d;</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;&#x61;&#105;&#108;&#116;&#x6f;&#58;&#106;&#111;&#x73;&#104;&#117;&#97;&#x40;&#x6f;&#112;&#115;&#x63;&#111;&#x64;&#101;&#46;&#x63;&#x6f;&#109;">&#106;&#x6f;&#x73;&#104;&#117;&#97;&#64;&#x6f;&#112;&#x73;&#x63;&#x6f;&#x64;&#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-bootstrap(1)</li>
237
- </ol>
238
-
239
- </div>
240
- </body>
241
- </html>
@@ -1,219 +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-client(1) - Manage Chef API Clients</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="#BULK-DELETE">BULK DELETE</a>
66
- <a href="#CREATE">CREATE</a>
67
- <a href="#DELETE">DELETE</a>
68
- <a href="#EDIT">EDIT</a>
69
- <a href="#LIST">LIST</a>
70
- <a href="#REREGISTER">REREGISTER</a>
71
- <a href="#SHOW">SHOW</a>
72
- <a href="#DESCRIPTION">DESCRIPTION</a>
73
- <a href="#SEE-ALSO">SEE ALSO</a>
74
- <a href="#AUTHOR">AUTHOR</a>
75
- <a href="#DOCUMENTATION">DOCUMENTATION</a>
76
- <a href="#CHEF">CHEF</a>
77
- </div>
78
-
79
- <ol class='man-decor man-head man head'>
80
- <li class='tl'>knife-client(1)</li>
81
- <li class='tc'>Chef Manual</li>
82
- <li class='tr'>knife-client(1)</li>
83
- </ol>
84
-
85
- <h2 id="NAME">NAME</h2>
86
- <p class="man-name">
87
- <code>knife-client</code> - <span class="man-whatis">Manage Chef API Clients</span>
88
- </p>
89
-
90
- <h2 id="SYNOPSIS">SYNOPSIS</h2>
91
-
92
- <p><strong>knife</strong> <strong>client</strong> <em>sub-command</em> <em>(options)</em></p>
93
-
94
- <h2 id="SUB-COMMANDS">SUB-COMMANDS</h2>
95
-
96
- <p>Client subcommands follow a basic create, read, update, delete (CRUD)
97
- pattern. The Following subcommands are available:</p>
98
-
99
- <h2 id="BULK-DELETE">BULK DELETE</h2>
100
-
101
- <p><strong>knife client bulk delete</strong> <em>regex</em> <em>(options)</em></p>
102
-
103
- <p>Delete clients where the client name matches the regular expression
104
- <em>regex</em> on the Chef Server. The regular expression should be given as a
105
- quoted string, and not surrounded by forward slashes.</p>
106
-
107
- <h2 id="CREATE">CREATE</h2>
108
-
109
- <p><strong>knife client create</strong> <em>client name</em> <em>(options)</em></p>
110
-
111
- <dl>
112
- <dt><code>-a</code>, <code>--admin </code></dt><dd>Create the client as an admin</dd>
113
- <dt><code>-f</code>, <code>--file FILE</code></dt><dd>Write the key to a file</dd>
114
- </dl>
115
-
116
-
117
- <p>Create a new client. This generates an RSA keypair. The private key will
118
- be displayed on <em>STDOUT</em> or written to the named file. The public half
119
- will be stored on the Server. For <em>chef-client</em> systems, the private key
120
- should be copied to the system as <code>/etc/chef/client.pem</code>.</p>
121
-
122
- <p>Admin clients should be created for users that will use <em>knife</em> to
123
- access the API as an administrator. The private key will generally be
124
- copied to <code>~/.chef/client\_name.pem</code> and referenced in the <code>knife.rb</code>
125
- configuration file.</p>
126
-
127
- <h2 id="DELETE">DELETE</h2>
128
-
129
- <p><strong>knife client delete</strong> <em>client name</em> <em>(options)</em></p>
130
-
131
- <p>Deletes a registered client.</p>
132
-
133
- <h2 id="EDIT">EDIT</h2>
134
-
135
- <p><strong>client edit</strong> <em>client name</em> <em>(options)</em></p>
136
-
137
- <p>Edit a registered client.</p>
138
-
139
- <h2 id="LIST">LIST</h2>
140
-
141
- <p><strong>client list</strong> <em>(options)</em></p>
142
-
143
- <dl>
144
- <dt><code>-w</code>, <code>--with-uri</code></dt><dd> Show corresponding URIs</dd>
145
- </dl>
146
-
147
-
148
- <p>List all registered clients.</p>
149
-
150
- <h2 id="REREGISTER">REREGISTER</h2>
151
-
152
- <p><strong>client reregister</strong> <em>client name</em> <em>(options)</em></p>
153
-
154
- <dl>
155
- <dt><code>-f</code>, <code>--file FILE</code></dt><dd>Write the key to a file</dd>
156
- </dl>
157
-
158
-
159
- <p>Regenerate the RSA keypair for a client. The public half will be stored
160
- on the server and the private key displayed on <em>STDOUT</em> or written to
161
- the named file. This operation will invalidate the previous keypair used
162
- by the client, preventing it from authenticating with the Chef Server.
163
- Use care when reregistering the validator client.</p>
164
-
165
- <h2 id="SHOW">SHOW</h2>
166
-
167
- <p><strong>client show</strong> <em>client name</em> <em>(options)</em></p>
168
-
169
- <dl>
170
- <dt><code>-a</code>, <code>--attribute ATTR</code></dt><dd>Show only one attribute</dd>
171
- </dl>
172
-
173
-
174
- <p>Show a client. Output format is determined by the --format option.</p>
175
-
176
- <h2 id="DESCRIPTION">DESCRIPTION</h2>
177
-
178
- <p>Clients are identities used for communication with the Chef Server API,
179
- roughly equivalent to user accounts on the Chef Server, except that
180
- clients only communicate with the Chef Server API and are authenticated
181
- via request signatures.</p>
182
-
183
- <p>In the typical case, there will be one client object on the server for
184
- each node, and the corresponding client and node will have identical
185
- names.</p>
186
-
187
- <p>In the Chef authorization model, there is one special client, the
188
- "validator", which is authorized to create new non-administrative
189
- clients but has minimal privileges otherwise. This identity is used as a
190
- sort of "guest account" to create a client identity when initially
191
- setting up a host for management with Chef.</p>
192
-
193
- <h2 id="SEE-ALSO">SEE ALSO</h2>
194
-
195
- <p> <strong>knife-node</strong>(1)</p>
196
-
197
- <h2 id="AUTHOR">AUTHOR</h2>
198
-
199
- <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>
200
-
201
- <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
202
-
203
- <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>.
204
- Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
205
-
206
- <h2 id="CHEF">CHEF</h2>
207
-
208
- <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>
209
-
210
-
211
- <ol class='man-decor man-foot man foot'>
212
- <li class='tl'>Chef 10.16.0.rc.1</li>
213
- <li class='tc'>October 2012</li>
214
- <li class='tr'>knife-client(1)</li>
215
- </ol>
216
-
217
- </div>
218
- </body>
219
- </html>