berkshelf 7.0.7 → 7.0.8
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.
- checksums.yaml +4 -4
- data/Rakefile +1 -1
- data/berkshelf.gemspec +8 -9
- data/bin/berks +5 -0
- data/lib/berkshelf/cached_cookbook.rb +1 -1
- data/lib/berkshelf/chef_config_compat.rb +1 -0
- data/lib/berkshelf/chef_repo_universe.rb +2 -2
- data/lib/berkshelf/formatters/json.rb +3 -3
- data/lib/berkshelf/lockfile.rb +3 -3
- data/lib/berkshelf/uploader.rb +3 -3
- data/lib/berkshelf/version.rb +1 -1
- metadata +32 -186
- data/.github/lock.yml +0 -1
- data/.gitignore +0 -30
- data/.rubocop.yml +0 -12
- data/.travis.yml +0 -73
- data/CHANGELOG.legacy.md +0 -307
- data/CHANGELOG.md +0 -1589
- data/CONTRIBUTING.md +0 -68
- data/Gemfile.lock +0 -292
- data/PLUGINS.md +0 -25
- data/README.md +0 -72
- data/Thorfile +0 -61
- data/appveyor.yml +0 -31
- data/docs/berkshelf_for_newcomers.md +0 -64
- data/features/artifactory.feature +0 -70
- data/features/berksfile.feature +0 -46
- data/features/commands/apply.feature +0 -41
- data/features/commands/contingent.feature +0 -47
- data/features/commands/info.feature +0 -141
- data/features/commands/install.feature +0 -646
- data/features/commands/list.feature +0 -78
- data/features/commands/outdated.feature +0 -176
- data/features/commands/package.feature +0 -17
- data/features/commands/search.feature +0 -17
- data/features/commands/shelf/list.feature +0 -32
- data/features/commands/shelf/show.feature +0 -113
- data/features/commands/shelf/uninstall.feature +0 -96
- data/features/commands/show.feature +0 -83
- data/features/commands/update.feature +0 -142
- data/features/commands/upload.feature +0 -499
- data/features/commands/vendor.feature +0 -154
- data/features/commands/verify.feature +0 -29
- data/features/commands/viz.feature +0 -66
- data/features/community_site.feature +0 -37
- data/features/help.feature +0 -11
- data/features/json_formatter.feature +0 -158
- data/features/lifecycle.feature +0 -378
- data/features/lockfile.feature +0 -378
- data/features/step_definitions/berksfile_steps.rb +0 -54
- data/features/step_definitions/chef/config_steps.rb +0 -12
- data/features/step_definitions/chef_server_steps.rb +0 -60
- data/features/step_definitions/cli_steps.rb +0 -18
- data/features/step_definitions/config_steps.rb +0 -46
- data/features/step_definitions/environment_steps.rb +0 -11
- data/features/step_definitions/filesystem_steps.rb +0 -286
- data/features/step_definitions/gem_steps.rb +0 -13
- data/features/step_definitions/json_steps.rb +0 -29
- data/features/step_definitions/utility_steps.rb +0 -11
- data/features/support/aruba.rb +0 -12
- data/features/support/env.rb +0 -77
- data/spec/fixtures/cookbooks/example_cookbook/.gitignore +0 -2
- data/spec/fixtures/cookbooks/example_cookbook/.kitchen.yml +0 -26
data/CONTRIBUTING.md
DELETED
@@ -1,68 +0,0 @@
|
|
1
|
-
# Contributing
|
2
|
-
|
3
|
-
## Developing
|
4
|
-
|
5
|
-
If you'd like to submit a patch:
|
6
|
-
|
7
|
-
1. Fork the project.
|
8
|
-
2. Make your feature addition or bug fix.
|
9
|
-
3. Add [tests](#testing) for it. This is important so that it isn't broken in a
|
10
|
-
future version unintentionally.
|
11
|
-
4. Commit. **Do not touch any unrelated code, such as the gemspec or version.**
|
12
|
-
If you must change unrelated code, do it in a commit by itself, so that it
|
13
|
-
can be ignored.
|
14
|
-
5. Send a pull request.
|
15
|
-
|
16
|
-
## Testing
|
17
|
-
|
18
|
-
### Install prerequisites
|
19
|
-
|
20
|
-
Install git on your test system.
|
21
|
-
|
22
|
-
Install the latest version of [Bundler](http://gembundler.com)
|
23
|
-
|
24
|
-
$ gem install bundler
|
25
|
-
|
26
|
-
Clone the project
|
27
|
-
|
28
|
-
$ git clone git://github.com/berkshelf/berkshelf.git
|
29
|
-
|
30
|
-
and run:
|
31
|
-
|
32
|
-
$ cd berkshelf
|
33
|
-
$ bundle install
|
34
|
-
|
35
|
-
Bundler will install all gems and their dependencies required for testing and developing.
|
36
|
-
|
37
|
-
### Running unit (RSpec) and acceptance (Cucumber) tests
|
38
|
-
|
39
|
-
We use Chef Zero - an in-memory Chef Server for running tests. It is automatically managed by the Specs and Cukes. Run:
|
40
|
-
|
41
|
-
$ bundle exec guard start
|
42
|
-
|
43
|
-
or
|
44
|
-
|
45
|
-
$ bundle exec thor spec:ci
|
46
|
-
|
47
|
-
See [here](https://github.com/tdegrunt/vagrant-chef-server-bootstrap) for a
|
48
|
-
quick way to get a testing chef server up.
|
49
|
-
|
50
|
-
### Debugging Issues
|
51
|
-
By default, Berkshelf will only give you the top-level output from a failed command. If you're working deep inside the core, an error like:
|
52
|
-
|
53
|
-
Berkshelf Error: wrong number of arguments (2 for 1)
|
54
|
-
|
55
|
-
isn't exactly helpful...
|
56
|
-
|
57
|
-
Specify the `BERKSHELF_DEBUG` flag when running your command to see a full stack trace and other helpful debugging information.
|
58
|
-
|
59
|
-
## Releasing
|
60
|
-
|
61
|
-
Once you are ready to release Berkshelf, perform the following:
|
62
|
-
|
63
|
-
1. Update `CHANGELOG.md` with a new header indicating the version to be released
|
64
|
-
1. Examine the diff ([example](https://github.com/berkshelf/berkshelf/compare/v4.0.1...master)) between master and the previous version. Add all merged Pull Requests to the `CHANGELOG.md`
|
65
|
-
1. Update `version.rb` to the desired release version
|
66
|
-
1. Run `bundle update berkshelf`
|
67
|
-
1. Create a PR and review the `version.rb` changes and `CHANGELOG.md` changes
|
68
|
-
1. Once the PR is merged to master, run `rake release` on the master branch
|
data/Gemfile.lock
DELETED
@@ -1,292 +0,0 @@
|
|
1
|
-
GIT
|
2
|
-
remote: https://github.com/chef/chefstyle.git
|
3
|
-
revision: 5e596babac0e107170ce7c5cc706646bf609ab25
|
4
|
-
branch: master
|
5
|
-
specs:
|
6
|
-
chefstyle (0.11.0)
|
7
|
-
rubocop (= 0.55.0)
|
8
|
-
|
9
|
-
PATH
|
10
|
-
remote: .
|
11
|
-
specs:
|
12
|
-
berkshelf (7.0.7)
|
13
|
-
chef (>= 13.6.52)
|
14
|
-
chef-config
|
15
|
-
cleanroom (~> 1.0)
|
16
|
-
concurrent-ruby (~> 1.0)
|
17
|
-
minitar (>= 0.6)
|
18
|
-
mixlib-archive (~> 0.4)
|
19
|
-
mixlib-config (>= 2.2.5)
|
20
|
-
mixlib-shellout (~> 2.0)
|
21
|
-
octokit (~> 4.0)
|
22
|
-
retryable (~> 2.0)
|
23
|
-
solve (~> 4.0)
|
24
|
-
thor (>= 0.20)
|
25
|
-
|
26
|
-
GEM
|
27
|
-
remote: https://rubygems.org/
|
28
|
-
specs:
|
29
|
-
activesupport (5.2.1)
|
30
|
-
concurrent-ruby (~> 1.0, >= 1.0.2)
|
31
|
-
i18n (>= 0.7, < 2)
|
32
|
-
minitest (~> 5.1)
|
33
|
-
tzinfo (~> 1.1)
|
34
|
-
addressable (2.5.2)
|
35
|
-
public_suffix (>= 2.0.2, < 4.0)
|
36
|
-
aruba (0.14.6)
|
37
|
-
childprocess (>= 0.6.3, < 0.10.0)
|
38
|
-
contracts (~> 0.9)
|
39
|
-
cucumber (>= 1.3.19)
|
40
|
-
ffi (~> 1.9.10)
|
41
|
-
rspec-expectations (>= 2.99)
|
42
|
-
thor (~> 0.19)
|
43
|
-
ast (2.4.0)
|
44
|
-
backports (3.11.4)
|
45
|
-
builder (3.2.3)
|
46
|
-
chef (14.7.17)
|
47
|
-
addressable
|
48
|
-
bundler (>= 1.10)
|
49
|
-
chef-config (= 14.7.17)
|
50
|
-
chef-zero (>= 13.0)
|
51
|
-
diff-lcs (~> 1.2, >= 1.2.4)
|
52
|
-
erubis (~> 2.7)
|
53
|
-
ffi (~> 1.9, >= 1.9.25)
|
54
|
-
ffi-yajl (~> 2.2)
|
55
|
-
highline (~> 1.6, >= 1.6.9)
|
56
|
-
iniparse (~> 1.4)
|
57
|
-
mixlib-archive (~> 0.4)
|
58
|
-
mixlib-authentication (~> 2.1)
|
59
|
-
mixlib-cli (~> 1.7)
|
60
|
-
mixlib-log (~> 2.0, >= 2.0.3)
|
61
|
-
mixlib-shellout (~> 2.4)
|
62
|
-
net-sftp (~> 2.1, >= 2.1.2)
|
63
|
-
net-ssh (~> 4.2)
|
64
|
-
net-ssh-multi (~> 1.2, >= 1.2.1)
|
65
|
-
ohai (~> 14.0)
|
66
|
-
plist (~> 3.2)
|
67
|
-
proxifier (~> 1.0)
|
68
|
-
rspec-core (~> 3.5)
|
69
|
-
rspec-expectations (~> 3.5)
|
70
|
-
rspec-mocks (~> 3.5)
|
71
|
-
rspec_junit_formatter (~> 0.2.0)
|
72
|
-
serverspec (~> 2.7)
|
73
|
-
specinfra (~> 2.10)
|
74
|
-
syslog-logger (~> 1.6)
|
75
|
-
uuidtools (~> 2.1.5)
|
76
|
-
chef-config (14.7.17)
|
77
|
-
addressable
|
78
|
-
fuzzyurl
|
79
|
-
mixlib-config (>= 2.2.12, < 3.0)
|
80
|
-
mixlib-shellout (~> 2.0)
|
81
|
-
tomlrb (~> 1.2)
|
82
|
-
chef-zero (14.0.11)
|
83
|
-
ffi-yajl (~> 2.2)
|
84
|
-
hashie (>= 2.0, < 4.0)
|
85
|
-
mixlib-log (~> 2.0)
|
86
|
-
rack (~> 2.0, >= 2.0.6)
|
87
|
-
uuidtools (~> 2.1)
|
88
|
-
childprocess (0.9.0)
|
89
|
-
ffi (~> 1.0, >= 1.0.11)
|
90
|
-
cleanroom (1.0.0)
|
91
|
-
concurrent-ruby (1.1.3)
|
92
|
-
contracts (0.16.0)
|
93
|
-
crack (0.4.3)
|
94
|
-
safe_yaml (~> 1.0.0)
|
95
|
-
cucumber (3.1.0)
|
96
|
-
builder (>= 2.1.2)
|
97
|
-
cucumber-core (~> 3.1.0)
|
98
|
-
cucumber-expressions (~> 5.0.4)
|
99
|
-
cucumber-wire (~> 0.0.1)
|
100
|
-
diff-lcs (~> 1.3)
|
101
|
-
gherkin (~> 5.0)
|
102
|
-
multi_json (>= 1.7.5, < 2.0)
|
103
|
-
multi_test (>= 0.1.2)
|
104
|
-
cucumber-core (3.1.0)
|
105
|
-
backports (>= 3.8.0)
|
106
|
-
cucumber-tag_expressions (~> 1.1.0)
|
107
|
-
gherkin (>= 5.0.0)
|
108
|
-
cucumber-expressions (5.0.13)
|
109
|
-
cucumber-tag_expressions (1.1.1)
|
110
|
-
cucumber-wire (0.0.1)
|
111
|
-
dep-selector-libgecode (1.3.1)
|
112
|
-
dep_selector (1.0.6)
|
113
|
-
dep-selector-libgecode (~> 1.0)
|
114
|
-
ffi (~> 1.9)
|
115
|
-
diff-lcs (1.3)
|
116
|
-
domain_name (0.5.20180417)
|
117
|
-
unf (>= 0.0.5, < 1.0.0)
|
118
|
-
erubis (2.7.0)
|
119
|
-
faraday (0.15.3)
|
120
|
-
multipart-post (>= 1.2, < 3)
|
121
|
-
faraday-http-cache (2.0.0)
|
122
|
-
faraday (~> 0.8)
|
123
|
-
ffi (1.9.25)
|
124
|
-
ffi-yajl (2.3.1)
|
125
|
-
libyajl2 (~> 1.2)
|
126
|
-
fuubar (2.3.2)
|
127
|
-
rspec-core (~> 3.0)
|
128
|
-
ruby-progressbar (~> 1.4)
|
129
|
-
fuzzyurl (0.9.0)
|
130
|
-
gherkin (5.1.0)
|
131
|
-
github_changelog_generator (1.14.3)
|
132
|
-
activesupport
|
133
|
-
faraday-http-cache
|
134
|
-
multi_json
|
135
|
-
octokit (~> 4.6)
|
136
|
-
rainbow (>= 2.1)
|
137
|
-
rake (>= 10.0)
|
138
|
-
retriable (~> 2.1)
|
139
|
-
hashdiff (0.3.7)
|
140
|
-
hashie (3.6.0)
|
141
|
-
highline (1.7.10)
|
142
|
-
http (4.0.0)
|
143
|
-
addressable (~> 2.3)
|
144
|
-
http-cookie (~> 1.0)
|
145
|
-
http-form_data (~> 2.0)
|
146
|
-
http_parser.rb (~> 0.6.0)
|
147
|
-
http-cookie (1.0.3)
|
148
|
-
domain_name (~> 0.5)
|
149
|
-
http-form_data (2.1.1)
|
150
|
-
http_parser.rb (0.6.0)
|
151
|
-
i18n (1.1.1)
|
152
|
-
concurrent-ruby (~> 1.0)
|
153
|
-
iniparse (1.4.4)
|
154
|
-
ipaddress (0.8.3)
|
155
|
-
libyajl2 (1.2.0)
|
156
|
-
minitar (0.7)
|
157
|
-
minitest (5.11.3)
|
158
|
-
mixlib-archive (0.4.18)
|
159
|
-
mixlib-log
|
160
|
-
mixlib-authentication (2.1.1)
|
161
|
-
mixlib-cli (1.7.0)
|
162
|
-
mixlib-config (2.2.13)
|
163
|
-
tomlrb
|
164
|
-
mixlib-log (2.0.4)
|
165
|
-
mixlib-shellout (2.4.0)
|
166
|
-
molinillo (0.6.6)
|
167
|
-
multi_json (1.13.1)
|
168
|
-
multi_test (0.1.2)
|
169
|
-
multipart-post (2.0.0)
|
170
|
-
net-scp (1.2.1)
|
171
|
-
net-ssh (>= 2.6.5)
|
172
|
-
net-sftp (2.1.2)
|
173
|
-
net-ssh (>= 2.6.5)
|
174
|
-
net-ssh (4.2.0)
|
175
|
-
net-ssh-gateway (2.0.0)
|
176
|
-
net-ssh (>= 4.0.0)
|
177
|
-
net-ssh-multi (1.2.1)
|
178
|
-
net-ssh (>= 2.6.5)
|
179
|
-
net-ssh-gateway (>= 1.2.0)
|
180
|
-
net-telnet (0.1.1)
|
181
|
-
octokit (4.13.0)
|
182
|
-
sawyer (~> 0.8.0, >= 0.5.3)
|
183
|
-
ohai (14.6.2)
|
184
|
-
chef-config (>= 12.8, < 15)
|
185
|
-
ffi (~> 1.9)
|
186
|
-
ffi-yajl (~> 2.2)
|
187
|
-
ipaddress
|
188
|
-
mixlib-cli (>= 1.7.0)
|
189
|
-
mixlib-config (~> 2.0)
|
190
|
-
mixlib-log (~> 2.0, >= 2.0.1)
|
191
|
-
mixlib-shellout (~> 2.0)
|
192
|
-
plist (~> 3.1)
|
193
|
-
systemu (~> 2.6.4)
|
194
|
-
wmi-lite (~> 1.0)
|
195
|
-
parallel (1.12.1)
|
196
|
-
parser (2.5.3.0)
|
197
|
-
ast (~> 2.4.0)
|
198
|
-
plist (3.4.0)
|
199
|
-
powerpack (0.1.2)
|
200
|
-
proxifier (1.0.3)
|
201
|
-
public_suffix (3.0.3)
|
202
|
-
rack (2.0.6)
|
203
|
-
rainbow (3.0.0)
|
204
|
-
rake (12.3.1)
|
205
|
-
retriable (2.1.0)
|
206
|
-
retryable (2.0.4)
|
207
|
-
rspec (3.8.0)
|
208
|
-
rspec-core (~> 3.8.0)
|
209
|
-
rspec-expectations (~> 3.8.0)
|
210
|
-
rspec-mocks (~> 3.8.0)
|
211
|
-
rspec-core (3.8.0)
|
212
|
-
rspec-support (~> 3.8.0)
|
213
|
-
rspec-expectations (3.8.2)
|
214
|
-
diff-lcs (>= 1.2.0, < 2.0)
|
215
|
-
rspec-support (~> 3.8.0)
|
216
|
-
rspec-its (1.2.0)
|
217
|
-
rspec-core (>= 3.0.0)
|
218
|
-
rspec-expectations (>= 3.0.0)
|
219
|
-
rspec-mocks (3.8.0)
|
220
|
-
diff-lcs (>= 1.2.0, < 2.0)
|
221
|
-
rspec-support (~> 3.8.0)
|
222
|
-
rspec-support (3.8.0)
|
223
|
-
rspec_junit_formatter (0.2.3)
|
224
|
-
builder (< 4)
|
225
|
-
rspec-core (>= 2, < 4, != 2.12.0)
|
226
|
-
rubocop (0.55.0)
|
227
|
-
parallel (~> 1.10)
|
228
|
-
parser (>= 2.5)
|
229
|
-
powerpack (~> 0.1)
|
230
|
-
rainbow (>= 2.2.2, < 4.0)
|
231
|
-
ruby-progressbar (~> 1.7)
|
232
|
-
unicode-display_width (~> 1.0, >= 1.0.1)
|
233
|
-
ruby-progressbar (1.10.0)
|
234
|
-
safe_yaml (1.0.4)
|
235
|
-
sawyer (0.8.1)
|
236
|
-
addressable (>= 2.3.5, < 2.6)
|
237
|
-
faraday (~> 0.8, < 1.0)
|
238
|
-
semverse (2.0.0)
|
239
|
-
serverspec (2.41.3)
|
240
|
-
multi_json
|
241
|
-
rspec (~> 3.0)
|
242
|
-
rspec-its
|
243
|
-
specinfra (~> 2.72)
|
244
|
-
sfl (2.3)
|
245
|
-
solve (4.0.0)
|
246
|
-
molinillo (~> 0.6)
|
247
|
-
semverse (>= 1.1, < 3.0)
|
248
|
-
specinfra (2.76.3)
|
249
|
-
net-scp
|
250
|
-
net-ssh (>= 2.7)
|
251
|
-
net-telnet (= 0.1.1)
|
252
|
-
sfl
|
253
|
-
syslog-logger (1.6.8)
|
254
|
-
systemu (2.6.5)
|
255
|
-
thor (0.20.3)
|
256
|
-
thread_safe (0.3.6)
|
257
|
-
tomlrb (1.2.7)
|
258
|
-
tzinfo (1.2.5)
|
259
|
-
thread_safe (~> 0.1)
|
260
|
-
unf (0.1.4)
|
261
|
-
unf_ext
|
262
|
-
unf_ext (0.0.7.5)
|
263
|
-
unicode-display_width (1.4.0)
|
264
|
-
uuidtools (2.1.5)
|
265
|
-
webmock (3.4.2)
|
266
|
-
addressable (>= 2.3.6)
|
267
|
-
crack (>= 0.3.2)
|
268
|
-
hashdiff
|
269
|
-
wmi-lite (1.0.0)
|
270
|
-
yard (0.9.16)
|
271
|
-
|
272
|
-
PLATFORMS
|
273
|
-
ruby
|
274
|
-
|
275
|
-
DEPENDENCIES
|
276
|
-
aruba (>= 0.10.0)
|
277
|
-
berkshelf!
|
278
|
-
chef-zero (>= 4.0)
|
279
|
-
chefstyle!
|
280
|
-
cucumber-expressions (= 5.0.13)
|
281
|
-
dep_selector (>= 1.0)
|
282
|
-
fuubar (>= 2.0)
|
283
|
-
github_changelog_generator
|
284
|
-
http (>= 0.9.8)
|
285
|
-
rake (>= 10.1)
|
286
|
-
rspec (>= 3.0)
|
287
|
-
rspec-its (>= 1.2)
|
288
|
-
webmock (>= 1.11)
|
289
|
-
yard (>= 0.8)
|
290
|
-
|
291
|
-
BUNDLED WITH
|
292
|
-
1.16.3
|
data/PLUGINS.md
DELETED
@@ -1,25 +0,0 @@
|
|
1
|
-
Berkshelf Plugins
|
2
|
-
=================
|
3
|
-
This is a list of community-contributed plugins for Berkshelf. A few notes:
|
4
|
-
|
5
|
-
- Please do not open issues regarding a community plugin on Berkshelf. Create the issue on the plugin first please.
|
6
|
-
- Plugins are listed in alphabetical order for consistency.
|
7
|
-
|
8
|
-
Plugins
|
9
|
-
-------
|
10
|
-
- [berkshelf-bzr](https://github.com/berkshelf/berkshelf-bzr) - Add support for downloading cookbooks from Bazaar locations.
|
11
|
-
- [berkshelf-hg](https://github.com/berkshelf/berkshelf-hg) - Add support for downloading cookbooks from Mercurial locations.
|
12
|
-
- [vagrant-berkshelf](https://github.com/berkshelf/vagrant-berkshelf) - A Vagrant plugin to add Berkshelf integration to the Chef provisioners.
|
13
|
-
|
14
|
-
I want to add my plugin!
|
15
|
-
------------------------
|
16
|
-
1. Plugins should be prefixed with `berkshelf-` for consistency.
|
17
|
-
1. Create your plugin on github - be sure to include tests. We will most likely not list a plugin that is untested.
|
18
|
-
1. Fork the Berkshelf project on github.
|
19
|
-
1. Edit this file, adding your plugin. All plugins must be on github. The format for a plugin is:
|
20
|
-
|
21
|
-
[Linked Project Name](#) - A short description of the plugin, what it does, why it exists, etc. ([Optional Link to Plugin Website](#))
|
22
|
-
|
23
|
-
For example:
|
24
|
-
|
25
|
-
[berkshelf-myface](https://github.com/berkshelf/berkshelf-myface) - A plugin to add myface support to Berkshelf.
|
data/README.md
DELETED
@@ -1,72 +0,0 @@
|
|
1
|
-
# Berkshelf
|
2
|
-
[][gem]
|
3
|
-
[][travis]
|
4
|
-
|
5
|
-
[gem]: https://rubygems.org/gems/berkshelf
|
6
|
-
[travis]: https://travis-ci.org/berkshelf/berkshelf
|
7
|
-
|
8
|
-
Manage a Cookbook or an Application's Cookbook dependencies
|
9
|
-
|
10
|
-
## Installation
|
11
|
-
|
12
|
-
Berkshelf is now included as part of the [Chef-DK](https://downloads.chef.io/chef-dk/). This is fastest, easiest, and the recommended installation method for getting up and running with Berkshelf.
|
13
|
-
|
14
|
-
> note: You may need to uninstall the Berkshelf gem especially if you are using a Ruby version manager you may need to uninstall all Berkshelf gems from each Ruby installation.
|
15
|
-
|
16
|
-
### From Rubygems
|
17
|
-
|
18
|
-
If you are a developer or you prefer to install from Rubygems, we've got you covered.
|
19
|
-
|
20
|
-
Add Berkshelf to your repository's `Gemfile`:
|
21
|
-
|
22
|
-
```ruby
|
23
|
-
gem 'berkshelf'
|
24
|
-
```
|
25
|
-
|
26
|
-
Or run it as a standalone:
|
27
|
-
|
28
|
-
```shell
|
29
|
-
$ gem install berkshelf
|
30
|
-
```
|
31
|
-
|
32
|
-
## Usage
|
33
|
-
|
34
|
-
See [docs.chef.io](https://docs.chef.io/berkshelf.html) for up-to-date usage instructions.
|
35
|
-
|
36
|
-
## CLI Usage
|
37
|
-
|
38
|
-
Berkshelf is intended to be used as a CLI tool. It is not intended to be used as a library. Other ruby code should shell out to the command line tool to use it.
|
39
|
-
|
40
|
-
## Supported Platforms
|
41
|
-
|
42
|
-
Berkshelf is tested and supported on Ruby 2.3 and 2.4.
|
43
|
-
|
44
|
-
## Configuration
|
45
|
-
|
46
|
-
Berkshelf will search in specific locations for a configuration file. In order:
|
47
|
-
|
48
|
-
$PWD/.berkshelf/config.json
|
49
|
-
~/.berkshelf/config.json
|
50
|
-
|
51
|
-
You are encouraged to keep project-specific configuration in the `$PWD/.berkshelf` directory. A default configuration file is generated for you, but you can update the values to suit your needs.
|
52
|
-
|
53
|
-
## Shell Completion
|
54
|
-
|
55
|
-
- [Bash](https://github.com/berkshelf/berkshelf-bash-plugin)
|
56
|
-
- [ZSH](https://github.com/berkshelf/berkshelf-zsh-plugin)
|
57
|
-
|
58
|
-
## Plugins
|
59
|
-
|
60
|
-
Please see [Plugins page](https://github.com/berkshelf/berkshelf/blob/master/PLUGINS.md) for more information.
|
61
|
-
|
62
|
-
## Getting Help
|
63
|
-
|
64
|
-
* If you have an issue: report it on the [issue tracker](https://github.com/berkshelf/berkshelf/issues)
|
65
|
-
* If you have a question: visit the #chef or #berkshelf channel on irc.freenode.net
|
66
|
-
|
67
|
-
## Authors
|
68
|
-
|
69
|
-
Thank you to all of our [Contributors](https://github.com/berkshelf/berkshelf/graphs/contributors), testers, and users.
|
70
|
-
|
71
|
-
If you'd like to contribute, please see our [contribution guidelines](https://github.com/berkshelf/berkshelf/blob/master/CONTRIBUTING.md) first.
|
72
|
-
|