microwave 1.0.2 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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,238 +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-data-bag(1) - Store arbitrary data on a Chef Server</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="#DATA-BAG-SUB-COMMANDS">DATA BAG SUB-COMMANDS</a>
66
- <a href="#CREATE">CREATE</a>
67
- <a href="#DELETE">DELETE</a>
68
- <a href="#EDIT">EDIT</a>
69
- <a href="#FROM-FILE">FROM FILE</a>
70
- <a href="#LIST">LIST</a>
71
- <a href="#SHOW">SHOW</a>
72
- <a href="#ENCRYPTION-SUPPORT">ENCRYPTION SUPPORT</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-data-bag(1)</li>
81
- <li class='tc'>Chef Manual</li>
82
- <li class='tr'>knife-data-bag(1)</li>
83
- </ol>
84
-
85
- <h2 id="NAME">NAME</h2>
86
- <p class="man-name">
87
- <code>knife-data-bag</code> - <span class="man-whatis">Store arbitrary data on a Chef Server</span>
88
- </p>
89
-
90
- <h2 id="SYNOPSIS">SYNOPSIS</h2>
91
-
92
- <p><strong>knife</strong> <strong>data bag</strong> <em>sub-command</em> <em>(options)</em></p>
93
-
94
- <h2 id="DESCRIPTION">DESCRIPTION</h2>
95
-
96
- <p>Data bags are stores of arbitrary JSON data. Each data bag is a
97
- collection that may contain many items. Data Bag Items are indexed by
98
- the Chef Server and can be searched via <strong>knife-search</strong>(1).</p>
99
-
100
- <p>Data bags are available to all nodes configured by <strong>chef-client</strong>(8),
101
- and are therefore a convenient mechanism to store global information,
102
- such as lists of administrative accounts that should be configured on
103
- all hosts.</p>
104
-
105
- <h2 id="DATA-BAG-SUB-COMMANDS">DATA BAG SUB-COMMANDS</h2>
106
-
107
- <h2 id="CREATE">CREATE</h2>
108
-
109
- <p><strong>knife data bag create</strong> <em>bag name</em> [item id] <em>(options)</em></p>
110
-
111
- <dl>
112
- <dt><code>-s</code>, <code>--secret SECRET</code></dt><dd>A secret key used to encrypt the data bag item. See <strong>encryption support</strong> below.</dd>
113
- <dt><code>--secret-file SECRET_FILE</code></dt><dd>The path to a file containing the secret key to be used to encrypt
114
- the data bag item.</dd>
115
- </dl>
116
-
117
-
118
- <p>If <em>item id</em> is given, creates a new, empty data bag item and opens it for
119
- editing in your editor. The data bag will be created if it does not
120
- exist.</p>
121
-
122
- <p>If <em>item id</em> is not given, the data bag will be created.</p>
123
-
124
- <h2 id="DELETE">DELETE</h2>
125
-
126
- <p><strong>knife data bag delete</strong> <em>bag name</em> [item id] <em>(options)</em></p>
127
-
128
- <p>Delete a data bag, or an item from a data bag.</p>
129
-
130
- <h2 id="EDIT">EDIT</h2>
131
-
132
- <p><strong>knife data bag edit</strong> <em>bag name</em> <em>item id</em> <em>(options)</em></p>
133
-
134
- <dl>
135
- <dt><code>-s</code>, <code>--secret SECRET</code></dt><dd>A secret key used to encrypt the data bag item. See <strong>encryption support</strong> below.</dd>
136
- <dt><code>--secret-file SECRET_FILE</code></dt><dd>The path to a file containing the secret key to be used to encrypt
137
- the data bag item.</dd>
138
- </dl>
139
-
140
-
141
- <p>Edit an item in a data bag.</p>
142
-
143
- <h2 id="FROM-FILE">FROM FILE</h2>
144
-
145
- <p><strong>knife data bag from file</strong> <em>bag name</em> <em>file</em> <em>(options)</em></p>
146
-
147
- <p><strong>knife data bag from file</strong> <em>bag name</em> <em>file1</em> <em>file2</em> <em>file3</em> <em>(options)</em></p>
148
-
149
- <p><strong>knife data bag from file</strong> <em>bag name</em> <em>folder</em> <em>(options)</em></p>
150
-
151
- <dl>
152
- <dt><code>-s</code>, <code>--secret SECRET</code></dt><dd>A secret key used to encrypt the data bag item. See <strong>encryption support</strong> below.</dd>
153
- <dt><code>--secret-file SECRET_FILE</code></dt><dd>The path to a file containing the secret key to be used to encrypt
154
- the data bag item.</dd>
155
- </dl>
156
-
157
-
158
- <p>Load a data bag item from a JSON file. If <em>file</em> is a relative or
159
- absolute path to the file, that file will be used. Otherwise, the <em>file</em>
160
- parameter is treated as the base name of a data bag file in a Chef
161
- repository, and <code>knife</code> will search for the file in
162
- <code>./data_bags/bag_name/file</code>. For example <code>knife data bag from file users
163
- dan.json</code> would attempt to load the file <code>./data_bags/users/dan.json</code>.</p>
164
-
165
- <h2 id="LIST">LIST</h2>
166
-
167
- <p><strong>knife data bag list</strong> <em>(options)</em></p>
168
-
169
- <dl>
170
- <dt><code>-w</code>, <code>--with-uri</code></dt><dd>Show corresponding URIs</dd>
171
- </dl>
172
-
173
-
174
- <p>Lists the data bags that exist on the Chef Server.</p>
175
-
176
- <h2 id="SHOW">SHOW</h2>
177
-
178
- <p><strong>knife data bag show BAG [ITEM]</strong> <em>(options)</em></p>
179
-
180
- <dl>
181
- <dt><code>-s</code>, <code>--secret SECRET</code></dt><dd>A secret key used to encrypt the data bag item. See <strong>encryption support</strong> below.</dd>
182
- <dt><code>--secret-file SECRET_FILE</code></dt><dd>The path to a file containing the secret key to be used to encrypt
183
- the data bag item.</dd>
184
- </dl>
185
-
186
-
187
- <p>Show a specific data bag or an item in a data bag. The output will be
188
- formatted according to the --format option.</p>
189
-
190
- <h2 id="ENCRYPTION-SUPPORT">ENCRYPTION SUPPORT</h2>
191
-
192
- <p>Data Bag Items may be encrypted to keep their contents secret. This may
193
- be desireable when storing sensitive information such as database
194
- passwords, API keys, etc.</p>
195
-
196
- <p>Data Bag Item encryption uses the AES-256 CBC symmetric key algorithm.</p>
197
-
198
- <p><strong>CAVEATS:</strong> Keys are not encrypted; only values are encrypted. The "id"
199
- of a Data Bag Item is not encrypted, since it is used by Chef Server to
200
- store the item in its database. For example, given the following data bag item:</p>
201
-
202
- <pre><code>{"id": "important_passwords", "secret_password": "opensesame"}
203
- </code></pre>
204
-
205
- <p>The key "secret_password" will be visible to an evesdropper, but the
206
- value "opensesame" will be protected. Both the key "id" and its value
207
- "important_passwords" will be visible to an evesdropper.</p>
208
-
209
- <p>Chef Server does not provide a secure mechanism for distributing
210
- encryption keys.</p>
211
-
212
- <h2 id="SEE-ALSO">SEE ALSO</h2>
213
-
214
- <p> <strong>knife-search</strong>(1)</p>
215
-
216
- <h2 id="AUTHOR">AUTHOR</h2>
217
-
218
- <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>
219
-
220
- <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
221
-
222
- <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>.
223
- Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
224
-
225
- <h2 id="CHEF">CHEF</h2>
226
-
227
- <p> Knife is distributed with Chef. http://wiki.opscode.com/display/chef/Home</p>
228
-
229
-
230
- <ol class='man-decor man-foot man foot'>
231
- <li class='tl'>Chef 10.16.0.rc.1</li>
232
- <li class='tc'>October 2012</li>
233
- <li class='tr'>knife-data-bag(1)</li>
234
- </ol>
235
-
236
- </div>
237
- </body>
238
- </html>
@@ -1,267 +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-environment(1) - Define cookbook policies for the environments in your infrastructure</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="#SUBCOMMANDS">SUBCOMMANDS</a>
65
- <a href="#CREATE">CREATE</a>
66
- <a href="#DELETE">DELETE</a>
67
- <a href="#EDIT">EDIT</a>
68
- <a href="#FROM-FILE">FROM FILE</a>
69
- <a href="#LIST">LIST</a>
70
- <a href="#SHOW">SHOW</a>
71
- <a href="#DESCRIPTION">DESCRIPTION</a>
72
- <a href="#SYNTAX">SYNTAX</a>
73
- <a href="#FORMAT">FORMAT</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-environment(1)</li>
82
- <li class='tc'>Chef Manual</li>
83
- <li class='tr'>knife-environment(1)</li>
84
- </ol>
85
-
86
- <h2 id="NAME">NAME</h2>
87
- <p class="man-name">
88
- <code>knife-environment</code> - <span class="man-whatis">Define cookbook policies for the environments in your infrastructure</span>
89
- </p>
90
-
91
- <h2 id="SYNOPSIS">SYNOPSIS</h2>
92
-
93
- <p><strong>knife</strong> <strong>environment</strong> <em>sub-command</em> <em>(options)</em></p>
94
-
95
- <h2 id="SUBCOMMANDS">SUBCOMMANDS</h2>
96
-
97
- <p>Environment subcommands follow a basic create, read, update, delete
98
- (CRUD) pattern. The following subcommands are available:</p>
99
-
100
- <h2 id="CREATE">CREATE</h2>
101
-
102
- <p><strong>knife environment create</strong> <em>environment</em> <em>(options)</em></p>
103
-
104
- <dl>
105
- <dt><code>-d</code>, <code>--description DESCRIPTION</code></dt><dd>The value of the description field.</dd>
106
- </dl>
107
-
108
-
109
- <p>Create a new environment object on the Chef Server. The envrionment will
110
- be opened in the text editor for editing prior to creation if the -n
111
- option is not present.</p>
112
-
113
- <h2 id="DELETE">DELETE</h2>
114
-
115
- <p><strong>knife environment delete</strong> <em>environment</em> <em>(options)</em></p>
116
-
117
- <p>Destroy an environment on the Chef Server. A prompt for confirmation
118
- will be displayed if the -y options is not given.</p>
119
-
120
- <h2 id="EDIT">EDIT</h2>
121
-
122
- <p><strong>knife environment edit</strong> <em>environment</em> <em>(options)</em></p>
123
-
124
- <p>Fetch <em>environment</em> and display it in the text editor for editing. The
125
- environment will be saved to the Chef Server when the editing session
126
- exits.</p>
127
-
128
- <h2 id="FROM-FILE">FROM FILE</h2>
129
-
130
- <p><strong>knife environment from file</strong> <em>file</em> <em>(options)</em></p>
131
-
132
- <p>Create or update an environment from the JSON or Ruby format <em>file</em>. See
133
- <strong>format</strong> for the proper format of this file.</p>
134
-
135
- <h2 id="LIST">LIST</h2>
136
-
137
- <p><strong>knife environment list</strong> <em>(options)</em>
138
- * <code>-w</code>, <code>--with-uri</code>:</p>
139
-
140
- <pre><code>Show the resource URI for each environment
141
- </code></pre>
142
-
143
- <h2 id="SHOW">SHOW</h2>
144
-
145
- <p><strong>knife environment show</strong> <em>environment</em> <em>(options)</em></p>
146
-
147
- <h2 id="DESCRIPTION">DESCRIPTION</h2>
148
-
149
- <p>Environments provide a means to apply policies to hosts in your
150
- infrastructure based on business function. For example, you may have a
151
- separate copy of your infrastructure called "dev" that runs the latest
152
- version of your application and should use the newest versions of your
153
- cookbooks when configuring systems, and a production instance of your
154
- infrastructure where you wish to update code and cookbooks in a more
155
- controlled fashion. In Chef, this function is implemented with
156
- <em>environments</em>.</p>
157
-
158
- <p>Environments contain two major components: a set of cookbook version
159
- constraints and environment attributes.</p>
160
-
161
- <h2 id="SYNTAX">SYNTAX</h2>
162
-
163
- <p>A cookbook version constraint is comprised of a <em>cookbook name</em> and a
164
- <em>version constraint</em>. The <em>cookbook name</em> is the name of a cookbook in
165
- your system, and the <em>version constraint</em> is a String describing the
166
- version(s) of that cookbook allowed in the environment. Only one
167
- <em>version constraint</em> is supported for a given <em>cookbook name</em>.</p>
168
-
169
- <p>The exact syntax used to define a cookbook version constraint varies
170
- depending on whether you use the JSON format or the Ruby format. In the
171
- JSON format, the cookbook version constraints for an environment are
172
- represented as a single JSON object, like this:</p>
173
-
174
- <pre><code>{"apache2": "&gt;= 1.5.0"}
175
- </code></pre>
176
-
177
- <p>In the Ruby format, the cookbook version contraints for an environment
178
- are represented as a Ruby Hash, like this:</p>
179
-
180
- <pre><code>{"apache2" =&gt; "&gt;= 1.5.0"}
181
- </code></pre>
182
-
183
- <p>A <em>version number</em> is a String comprised of two or three digits
184
- separated by a dot (.) character, or in other words, strings of the form
185
- "major.minor" or "major.minor.patch". "1.2" and "1.2.3" are examples of
186
- valid version numbers. Version numbers containing more than three digits
187
- or alphabetic characters are not supported.</p>
188
-
189
- <p>A <em>version constraint</em> String is composed of an <em>operator</em> and a
190
- <em>version number</em>. The following operators are available:</p>
191
-
192
- <dl>
193
- <dt><code>= VERSION</code></dt><dd>Equality. Only the exact version specified may be used.</dd>
194
- <dt><code>&gt; VERSION</code></dt><dd>Greater than. Only versions greater than <code>VERSION</code> may be used.</dd>
195
- <dt><code>&gt;= VERSION</code></dt><dd>Greater than or equal to. Only versions equal to VERSION or greater
196
- may be used.</dd>
197
- <dt><code>&lt; VERSION</code></dt><dd>Less than. Only versions less than VERSION may be used.</dd>
198
- <dt><code>&lt;= VERSION</code></dt><dd>Less than or equal to. Only versions lesser or equal to VERSION may
199
- be used.</dd>
200
- <dt><code>~&gt; VERSION</code></dt><dd>Pessimistic greater than. Depending on the number of components in
201
- the given VERSION, the constraint will be optimistic about future
202
- minor or patch revisions only. For example, <code>~&gt; 1.1</code> will match any
203
- version less than <code>2.0</code> and greater than or equal to <code>1.1.0</code>,
204
- whereas <code>~&gt; 2.0.5</code> will match any version less than <code>2.1.0</code> and
205
- greater than or equal to <code>2.0.5</code>.</dd>
206
- </dl>
207
-
208
-
209
- <h2 id="FORMAT">FORMAT</h2>
210
-
211
- <p>The JSON format of an envioronment is as follows:</p>
212
-
213
- <pre><code>{
214
- "name": "dev",
215
- "description": "The development environment",
216
- "cookbook_versions": {
217
- "couchdb": "= 11.0.0"
218
- },
219
- "json_class": "Chef::Environment",
220
- "chef_type": "environment",
221
- "default_attributes": {
222
- "apache2": { "listen_ports": [ "80", "443" ] }
223
- },
224
- "override_attributes": {
225
- "aws_s3_bucket": "production"
226
- }
227
- }
228
- </code></pre>
229
-
230
- <p>The Ruby format of an environment is as follows:</p>
231
-
232
- <pre><code>name "dev"
233
- description "The development environment"
234
- cookbook_versions "couchdb" =&gt; "= 11.0.0"
235
- default_attributes "apache2" =&gt; { "listen_ports" =&gt; [ "80", "443" ] }
236
- override_attributes "aws_s3_bucket" =&gt; "production"
237
- </code></pre>
238
-
239
- <h2 id="SEE-ALSO">SEE ALSO</h2>
240
-
241
- <p> <strong><span class="man-ref">knife-node<span class="s">(1)</span></span></strong> <strong><span class="man-ref">knife-cookbook<span class="s">(1)</span></span></strong> <strong><span class="man-ref">knife-role<span class="s">(1)</span></span></strong>
242
- <a href="http://wiki.opscode.com/display/chef/Environments" data-bare-link="true">http://wiki.opscode.com/display/chef/Environments</a>
243
- <a href="http://wiki.opscode.com/display/chef/Version+Constraints" data-bare-link="true">http://wiki.opscode.com/display/chef/Version+Constraints</a></p>
244
-
245
- <h2 id="AUTHOR">AUTHOR</h2>
246
-
247
- <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>
248
-
249
- <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
250
-
251
- <p> This manual page was written by Daniel DeLeo <a href="&#109;&#97;&#105;&#x6c;&#116;&#x6f;&#58;&#x64;&#x61;&#110;&#x40;&#111;&#x70;&#115;&#x63;&#x6f;&#x64;&#101;&#46;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#x64;&#x61;&#x6e;&#64;&#x6f;&#x70;&#115;&#x63;&#111;&#x64;&#x65;&#46;&#99;&#111;&#x6d;</a>.
252
- Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
253
-
254
- <h2 id="CHEF">CHEF</h2>
255
-
256
- <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>
257
-
258
-
259
- <ol class='man-decor man-foot man foot'>
260
- <li class='tl'>Chef 10.16.0.rc.1</li>
261
- <li class='tc'>October 2012</li>
262
- <li class='tr'>knife-environment(1)</li>
263
- </ol>
264
-
265
- </div>
266
- </body>
267
- </html>