berkshelf 7.0.7 → 7.0.8
Sign up to get free protection for your applications and to get access to all the features.
- 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 Version](https://img.shields.io/gem/v/berkshelf.svg)][gem]
|
3
|
-
[![Build Status](https://img.shields.io/travis/berkshelf/berkshelf.svg)][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
|
-
|