Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


ruby_build (48) Versions 2.1.5

Manages the ruby-build framework and its installed rubies. A LWRP is also defined.

cookbook 'ruby_build', '= 2.1.5', :supermarket
cookbook 'ruby_build', '= 2.1.5'
knife supermarket install ruby_build
knife supermarket download ruby_build
Quality 83%

ruby-build Chef Cookbook

Cookbook Version
Build Status


Manages the ruby-build framework and its installed Rubies, through custom resources.


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 or come chat with us on the Chef Community Slack in #sous-chefs.


It is for use in standalone mode. If you wish to use ruby-build with rbenv, please use the rbenv cookbook.



  • Chef 15+

Supported Platforms

  • Ubuntu 16.04+
  • MacOS
  • debian 8+
  • FreeBSD 9+
  • RedHat 6+


# metadata.rb
depends 'ruby_build'
# default.rb
ruby_build_install ''

ruby_build_definition '2.6.0'

# build 2.6.0 with a patch that lives in your cookbook's files/default dir
ruby_build_definition '2.6.0' do
  patch 'foobar.patch'


License and Author

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Dependent cookbooks

yum-epel >= 0.0.0
yum-centos >= 0.0.0
homebrew >= 0.0.0

Contingent cookbooks

aws-codedeploy-agent Applicable Versions
chruby Applicable Versions
errbit-server Applicable Versions
gitlab Applicable Versions
gitlab-shell Applicable Versions
gitlabhq Applicable Versions
ish Applicable Versions
minimart Applicable Versions
mw_application Applicable Versions
myusa Applicable Versions
noosfero Applicable Versions
polyglot Applicable Versions
redmine2 Applicable Versions
ruby_pkg Applicable Versions
ruby_rbenv Applicable Versions
sensu_admin Applicable Versions
server-base Applicable Versions
simple_passenger Applicable Versions
ut_workstation Applicable Versions


All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

2.1.5 - 2021-11-22

  • Retry when cloning the ruby-build code repository

2.1.4 - 2021-08-30

  • Standardise files with files in sous-chefs/repo-management

2.1.3 - 2021-06-01

  • Standardise files with files in sous-chefs/repo-management

2.1.2 - 2020-12-02

  • resolved cookstyle error: libraries/package_deps.rb:8:5 convention: Layout/EmptyLineBetweenDefs

2.1.1 (2020-09-16)

  • resolved cookstyle error: spec/libraries/cruby_spec.rb:6:7 refactor: ChefCorrectness/IncorrectLibraryInjection
  • Cookstyle Bot Auto Corrections with Cookstyle 6.16.8

2.1.0 (2020-06-17)

  • Fix package_deps being passed too many arguments
  • Fix switching to master when we're already on master
  • Add MacOS testing

  • fix broken environment property (needs a Hash, was set to String)

  • update documentation pages with new custom resource name ruby_build_definition

  • make the automatic addition of the Ruby version to the prefix an option

  • allow users to use the old ruby_build_ruby resource name, for compatibility

  • do not assume that users are running Chef 15.3.x and can use unified_mode

  • add requested feature: patch

2.0.0 (2020-04-21)

  • Remove support for JRuby, it requires an out of support Java version
  • Convert to a custom resource
  • Move test from bats to Inspec
  • Add support for Amazon Linux
  • Add support for Ubuntu 18.04

1.3.0 (2020-03-05)

  • Add debian-10 platform to test kitchen configurations
  • Migrate to github actions
  • Fix CircleCI testing, bring it up to Sous-Chefs standards
  • Fix Markdown
  • Fix YAML
  • Use platform? helper in the attributes file
  • Remove the unnecessary long_description field in metadata.rb
  • Fix libgdbm package name in attributes for debian 10
  • Fix libgdbm package name in attributes for Ubuntu 19.04

1.2.0 (2019-01-23)

  • Add debian-10 platform to test kitchen configurations
  • Migrate to github actions
  • Remove recipes
  • Add ruby_build_install resource
  • Add ruby_build_definition resource
  • Add unit testing

1.1.0 (2017-04-07)

  • Maintenance of this cookbook has been moved to the Sous Chefs organization -
  • Switched git installation to the git cookbook
  • Sped up converge times by using multi-package installs when available
  • Added Chefspec matchers
  • Removed a duplicate package that was causing warnings on Chef 12 / failures on Chef 13
  • Ensured that multi-package installs would continue on Amazon Linux with Chef 13
  • Removed some fragile and unnecessary code that checked to see if we were on Chef 12+
  • Switched testing to Delivery local mode and removed all test gems from the Gemfile.
  • Added a skeleton Chefspec test suite
  • Updated to more modern Ruby versions to test with

1.0.0 (2016-07-18)

  • This cookbook has been moved under the chef-rbenv Github organization to allow for additional committers and further maintenance
  • The cookbook now requires Chef 12 due to the use of multi-package installations
  • Existing lists of package dependencies have been updated to match those on the ruby-build wiki. This removes several runtime dependencies such as readline, zlib, and subversion
  • Added support for installing Rubinius dependencies when installing Rubinius
  • Added dependency installation on OS X machines
  • Added support for FreeBSD
  • Added a dependency on yum-epel when on RHEL
  • Added Travis CI integration testing using kitchen-dokken and inspec
  • Added cookstyle for Ruby linting and resolved all warnings
  • Updated the ruby-build Github URL to the new location
  • Switched package dependency logic to use platform_family which supports additional derivative distros
  • Add source_url, issues_url, and chef_version metadata to metadata.rb
  • Updated the LWRP to use use_inline_resources for proper update notifications
  • Added a Chef 11+ style default_action to the LWRP
  • Updated attribute file to use default instead of node.set which avoids deprecation warnings
  • Updated the Berksfile to use Supermarket
  • Updated the Gemfile with the latest testing dependencies
  • Added the Apache 2.0 license file
  • Updated readme to remove HTML tables that don't render in Supermarket
  • Swapped the Rakefile for the standard Chef Rakefile

0.8.0 (2013-05-22)

  • Pull request #8: Remove libyaml-devel pkg dependency for Red Hat family platforms. (@fnichol)
  • Pull request #9: Use the HTTPS clone URL. (@adammck)
  • Pull request #10: Use old-form notifies to support AWS OpsWorks. (@tsabat)
  • Issue #7: Install Git package(s) only if Git is not previously installed. (@fnichol, @ChrisLundquist)
  • Convert project from Jamie to Test Kitchen. (@fnichol)

0.7.2 (2012-12-31)

  • Fix missing package dependencies for C Ruby versions on RHEL family. (@fnichol)
  • Print Ruby build time to :info logger (formerly :debug). (@fnichol)
  • Add integration tests for commonly installed Ruby versions. (@fnichol)

0.7.0 (2012-11-21)

  • Add environment attr to ruby_build_ruby. This allows for adding custom compilation flags, as well as newer ruby-build environment variables, such as RUBY_BUILD_MIRROR_URL. (@fnichol)
  • Update foodcritic configuration and update .travis.yml. (@fnichol)
  • Update Installation section of README (welcome Berkshelf). (@fnichol)

0.6.2 (2012-05-03)

  • Fix ruby_build_ruby LWRP now notifies when updated (FC017). (@fnichol)
  • Fix Add plaform equivalents in default attrs (FC024). (@fnichol)
  • Fix JRuby requires make package on Ubuntu/Debian. (@fnichol)
  • Ensure Chef::Config[:file_cache_path] exists in solo mode. (@fnichol)
  • Add TravisCI to run Foodcritic linter. (@fnichol)
  • Reorganize README with section links. (@fnichol)

0.6.0 (2011-12-10)

The initial release.

Collaborator Number Metric

2.1.5 passed this metric

Contributing File Metric

2.1.5 passed this metric

Foodcritic Metric

2.1.5 failed this metric

FC108: Resource should not define a property named 'name': ruby_build/resources/homebrew_update.rb:22
FC108: Resource should not define a property named 'name': ruby_build/resources/install.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

2.1.5 passed this metric

Testing File Metric

2.1.5 passed this metric

Version Tag Metric

2.1.5 passed this metric