Chef ruby_rbenv Cookbook

Description

Manages [rbenv][rbenv_site] and its installed Rubies.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

Chef

This cookbook requires Chef 13.0+.

NOTE: Some Chef versions (>= 16 and < 16.4.41) have a bug in the git resource causing some failures (see #289). If you experience any troubles please try a more recent version of Chef 16.

Platform

• Debian derivatives
• Fedora
• macOS (not currently tested)
• RHEL derivatives (RHEL, CentOS, Amazon Linux, Oracle, Scientific Linux)
• openSUSE and openSUSE leap

Resources

• rbenv_gem
• rbenv_global
• rbenv_plugin
• rbenv_rehash
• rbenv_ruby
• rbenv_script
• rbenv_system_install
• rbenv_user_install

Usage

Example installations are provided in test/fixtures/cookbooks/test/recipes/.

A rbenv_system_install or rbenv_user_install is required to be set so that rbenv knows which version you want to use, and is installed on the system.

System wide installations of rbenv are supported by this cookbook, but discouraged by the rbenv maintainer, see [these][rbenv_issue_38] [two][rbenv_issue_306] issues in the rbenv repository.

System-Wide macOS Installation Note

This cookbook takes advantage of managing profile fragments in an /etc/profile.d directory, common on most Unix-flavored platforms. Unfortunately, macOS does not support this idiom out of the box, so you may need to [modify][mac_profile_d] your user profile.

Development

• Source hosted at [GitHub][repo]
• Report issues/Questions/Feature requests on [GitHub Issues][issues]

Pull requests are very welcome! Make sure your patches are well tested.

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

http://www.apache.org/licenses/LICENSE-2.0