Project

berkshelf

0.28

Dependency Management

A long-lived project that still receives updates
berkshelfchef/berkshelfHomepageDocumentationSource CodeBug Tracker
Manages a Chef cookbook's dependencies
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Popularity
Downloads
5,998,053
Stars
0
Forks
1
Watchers
0
 Releases
Current version
8.0.1
Total releases
150
First release
2012-06-21
Latest release
2022-05-19
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
1
Merged Pull Requests
3
Pull Request Acceptance Rate
75%
 Development
Primary Language
Ruby
Licenses
Apache-2.0
Average date of last 50 commits
2021-09-14
Reverse Dependencies
78

 Dependencies

Runtime

chef
>= 15.7.32
chef-config
>= 0
cleanroom
~> 1.0
concurrent-ruby
~> 1.0
minitar
>= 0.6
mixlib-archive
>= 1.1.4, < 2.0
mixlib-config
>= 2.2.5
mixlib-shellout
>= 2.0, < 4.0
octokit
~> 4.0
retryable
>= 2.0, < 4.0
solve
~> 4.0
thor
>= 0.20
 Project Readme

Berkshelf

Gem Version Matrix Testing

Manage Chef Infra cookbooks and cookbook dependencies

Warning

Berkshelf is effectively deprecated. There is no ongoing maintenance and triage of issues. No active work is being done on bugfixes. The only work being done is to maintain it so that it continues to ship and run in its existing state.

Existing users should strongly consider migrating to Policyfiles and new users should avoid using Berkshelf.

Installation

Berkshelf is now included as part of the Chef Workstation. This is fastest, easiest, and the recommended installation method for getting up and running with Berkshelf.

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.

From Rubygems

If you are a developer or you prefer to install from Rubygems, we've got you covered.

Add Berkshelf to your repository's Gemfile:

gem 'berkshelf'

Or run it as a standalone:

$ gem install berkshelf

Usage

See docs.chef.io for up-to-date usage instructions.

CLI Usage

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.

Supported Platforms

Berkshelf is tested and supported on Ruby 2.4 and later.

Configuration

Berkshelf will search in specific locations for a configuration file. In order:

$PWD/.berkshelf/config.json
~/.berkshelf/config.json

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.

Shell Completion

Plugins

Please see Plugins page for more information.

Getting Help

  • If you have an issue: report it on the issue tracker
  • If you have a question: visit the #chef or #berkshelf channel on irc.freenode.net

Authors

Thank you to all of our Contributors, testers, and users.

If you'd like to contribute, please see our contribution guidelines first.