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


gem_installation (3) Versions 1.1.1

Installs ruby gems and their dependencies

cookbook 'gem_installation', '= 1.1.1', :supermarket
cookbook 'gem_installation', '= 1.1.1'
knife supermarket install gem_installation
knife supermarket download gem_installation
Quality 0%


Provides a set of LWRPs to install ruby gems and/or their package dependencies, before or during convergence.

If you are sick and tired of manually installing libxml2-dev and libxslt-dev, this cookbook is dedicated to you.

Does not install the rubygems binary.

You probably don't want to use this, it's not well done and semi abandoned, but I haven't found a better solution yet.

Update notes from previous versions

  • You must include the gem_installation::default recipe now. This is the sad result of some internal rejiggering


Currently, the prerequisites are hardcoded in libraries/gem_installation.rb

While a solution utilizing a dependency solver would be great, for now this is much better than nothing, and the LWRP interface is unlikely to change anyway.


Ubuntu and Debian. Check .kitchen.yml for the exact versions tested.


# Set up everything this cookbook needs
include_recipe "gem_installation::default"

# Install fog before convergence so you can use it in your chef recipes
gem_installation "fog"

# Install fog during convergence
gem_installation "nokogiri" do
  action :install

# Install the nokogiri dependencies during convergence (e.g. because you deploy a Ruby application that has nokogiri in it's bundle).
# Note: does not install nokogiri itself, only the dependencies
gem_installation_dependencies "nokogiri" 

# Install fog dependencies before convergence (e.g. because you include a third party cookbook that will install fog as a chef_gem).
# Once again, the fog gem itself is not installed
gem_installation_dependencies "fog" do
  action :install_before_convergence



Installs the deep_merge gem, which this cookbook depends on.

Also includes build-essential, so you're able to build native extensions.


Currently, no attributes are used by this cookbook.

Resources / Providers

Note that the default actions for the two LWRPs are the opposite of each other.

While this is inconsistent, it reflects the expected use cases.


Deals with gem installation, including dependencies


Attribute Description Type Default
gem_name Name of the gem to install String name
compile_time Same as the compile_time flag on chef_gem resource. Only works with :install_before_convergence action Boolean true


Name Description Default
install_before_convergence Installs the named gem as a chef_gem yes
install Installs the named gem using gem_package


Install only gem dependencies, not the gems themselves.


Attribute Description Type Default
gem_name Dependencies of this gem will be installed String name


Name Description Default
install Installs prerequisites during convergence yes
install_before_convergence Installs prerequisites before convergence

1.1.1 (2015-04-28)


  • Fix "duplicate definition" warning, thanks to dblessing
  • RuboCop

1.1.0 (2015-04-28)


  • No more compile_time warning spam in default recipe
  • Now adheres to the "new" build-essential naming conventions
  • Fix old supermarket location in Berksfile

New features

  • Add compile_time flag for gems installed before convergence

1.0.0 (2013-04-09)

New features

  • Now installs build-essential at compile time

Foodcritic Metric

1.1.1 failed this metric

FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/c12c3d0254dfcc36c386fa3c/gem_installation/recipes/default.rb:2
FC009: Resource attribute not recognised: /tmp/cook/c12c3d0254dfcc36c386fa3c/gem_installation/providers/default.rb:17
FC009: Resource attribute not recognised: /tmp/cook/c12c3d0254dfcc36c386fa3c/gem_installation/recipes/default.rb:9