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


build-gcc (2) Versions 0.1.0

Installs/Configures build-gcc

cookbook 'build-gcc', '= 0.1.0', :supermarket
cookbook 'build-gcc', '= 0.1.0'
knife supermarket install build-gcc
knife supermarket download build-gcc
Quality 17%

build-essential Cookbook

Cookbook Version Build Status

Installs packages required for compiling C software from source. Use this cookbook if you wish to compile C programs, or install RubyGems with native extensions. Contains a resource, 'build_essential', as as well as a default recipe that simply calls that same resource.

Note: The functionality of this cookbook is now built into Chef 14+ in the build_essential resource. This cookbook is no longer being maintained and all future changes will be done directly in the chef-client. We highly recommend you update your chef-client to the latest release and if possible migrate to using the build_essential resources instead of the recipe in this cookbook.



  • Debian/Ubuntu
  • RHEL/CentOS/Scientific/Amazon/Oracle
  • openSUSE / SUSE Enterprise Linux
  • SmartOS
  • Fedora
  • Mac OS X 10.9+
  • FreeBSD


  • Chef 12.7+


  • seven_zip
  • mingw

Note for Debian platform family: On Debian platform-family systems, it is recommended that apt-get update be run, to ensure that the package cache is updated. It's not in the scope of this cookbook to do that, as it can create a duplicate resource. We recommend using the apt cookbook to do this.


Attribute Default Description
node['build-essential']['compile_time'] false Execute resources at compile time
node['build-essential']['msys2']['path'] #{ENV['SYSTEMDRIVE']\\msys2 Destination for msys2 build tool chain (Windows only)


Recipe Usage

The recipe simply calls the build_essential resource, but it ideal for adding to roles or node run lists.

Include the build-essential recipe in your run list:

knife node run_list add NODE "recipe[build-essential::default]"

or add the build-essential recipe as a dependency and include it from inside another cookbook:

include_recipe 'build-essential::default'

Gems with C extensions

For RubyGems that include native C extensions you wish to use with Chef, you should do the following.

  • Set the compile_time attribute to true in your wrapper cookbook or role:
   # Wrapper attribute
   default['build-essential']['compile_time'] = true
   # Role
     'build-essential' => {
       'compile_time' => true
  • Ensure that the C libraries, which include files and other assorted "dev"

type packages, are installed in the compile phase after the build-essential

recipe is executed. For example:

   include_recipe 'build-essential::default'

   package('mypackage-devel') { action :nothing }.run_action(:install)
  • Use the chef_gem resource in your recipe to install the gem with the native


   chef_gem 'gem-with-native-extension'

Resource Usage

The cookbook includes a resource 'build_essential' that can be included in your cookbook to install the necessary build-essential packages

Simple package installation during the client run:

build_essential 'some name you choose'

Package installation during the compile phase:

build_essential 'some name you choose' do
  compile_time false


This cookbook is maintained by Chef's Community Cookbook Engineering team. Our goal is to improve cookbook quality and to aid the community in contributing to cookbooks. To learn more about our team, process, and design goals see our team documentation. To learn more about contributing to cookbooks like this see our contributing documentation, or if you have general questions about this cookbook come chat with us in #cookbok-engineering on the Chef Community Slack


Copyright: 2009-2016, Chef Software, Inc.

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

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

build-essential >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

build-essential Cookbook CHANGELOG

This file is used to list changes made in each version of the build-essential cookbook.

8.2.1 (2018-09-04)

  • Add a note that this cookbook is no longer maintained as the build_essential resource was moved directly into the chef-client making this cookbook no longer necessary.

8.2.0 (2018-08-28)

  • Simplify the if installed logic for macos
  • Remove support for FreeBSD < 10 which is VERY much EOL
  • Avoid ChefSpec deprecation warnings
  • Avoid deprecation warnings in Chef 14.3+ by not loading resources already in Chef

8.1.1 (2018-03-17)

  • Make sure we install the last available xcode command line tool package so we get the latest version

8.1.0 (2018-03-17)

  • Support Amazon Linux 2.0
  • Remove the ChefSpec matchers which are autogenerated now in recent ChefDK releaeses. If your specs fail because of this you need to update to a more recent ChefDK release.
  • Swap Debian 7 testing for Amazon 2 & Ubuntu 18.04 testing since Debian 7 is EOL in May

8.0.4 (2017-11-29)

  • Install gcc-c and gcc-c++ for solaris 11
  • Fix dokken's amazonlinux configuration
  • Update chef dependency in metadata.rb to Chef 12.7
  • Clean up testing

8.0.3 (2017-05-30)

  • Fix solaris metadata in metadata.rb
  • Remove mac_os_x_server from metata as it's not a platform

8.0.2 (2017-05-06)

  • Remove buggy action_class.class_eval usage

8.0.1 (2017-04-14)

  • Test with local delivery and not Rake
  • Ensure compatibility with Chef 12.5
  • Update apache2 license string
  • Ensure compatibility with Amazon Linux on Chef 13

8.0.0 (2017-02-14)

  • Require 12.5 or later and remove compat_resource cookbook dependency

7.0.3 (2016-12-22)

  • Require the latest compat_resource
  • Cookstyle fixes

7.0.2 (2016-11-07)

  • Fix softwareupdate issue from -v to --verbose

7.0.1 (2016-10-06)

  • Install gcc 4.8 on SUSE < 12

7.0.0 (2016-09-30)

  • Remove support for OS X < 10.9 and add support for OS X 10.12
  • Refactor the xcode installer resource as a custom resource that does not require updates for each new OS X update
  • Use a test recipe with apt_update to avoid needing apt

6.0.6 (2016-09-19)

  • Remove chef 11 compatibility in the metadata
  • Solaris 11 needs both make and gnu make

6.0.5 (2016-09-07)

  • Testing updates
  • Require the latest compat_resource

6.0.4 (2016-08-19)

  • Install CLTools from dmg with -allowUntrusted on old OSX
  • Switch to cookstyle for ruby linting
  • Add OS X hosts to the kitchen config
  • Remove chefdk included gems from the Gemfile
  • Better handle kitchen failures in the Rakefile
  • Perform all unit/linting in a single travis job

v6.0.3 (2016-07-26)

  • Fix how gcc version specified for Solaris 11

v6.0.2 (2016-07-22)

  • Properly warn on Solaris 10
  • Specify the verson of gcc to install on Solaris 11

v6.0.1 (2016-07-19)

  • Clarify that this cookbook actually required Chef 12.1 or later not 12.0 or later
  • Add chef_version metadata

v6.0.0 (2016-06-03)

This cookbook now uses the new msys2 based compiler toolchain on windows. Both 32-bit DW2 and 64-bit SEH based toolchains are available based on the gcc 5.3x series compiler. By default these are located in C:\msys2\mingw32 and C:\msys2\mingw64

v5.0.0 (2016-06-03)

The cookbook now ships with a 12.5+ style custom resource 'build_essential' which performs the same work that the existing default.rb recipe. The default.rb recipe has been converted to consume that resource to provide backwards compatibility for users that use build-essential::default in their run lists or cookbooks. In converting to this custom resource support for EOL omnios has been removed and warning messages for Solaris 10 users have been removed. See the readme for usage information on the new resource.

v4.0.0 (2016-05-12)

Breaking change

This cookbook now requires Chef 12 or later as it includes the new mingw cookbook for installing Windows compilers. Mingw includes 12.5 style custom resources, which will fail to compile on Chef 11. If you are not running Chef 12 you'll need to pin to 3.x in your environment.

v3.2.0 (2016-03-25)

This version backs out a change in the 3.0 release which attempted to install the version of kernel-devel for the current running kernel on RHEL systems. This change had several unintended consequences and we believe the best solution is to back to change out until a better solution for the original problem is developed. Several of the issues could be resolved by code updates to build-essential, but not all, which complicates rolling forward vs. a roll back. The change caused issues which Chefspec runs on cookbooks where build-essential is a dependency as Fauxhai, used by Chefspec, does not mock out node['virtualization']. Fauxhai is being updated to mock out node['virtualization'], but we'd like to make sure a ChefDK release ships with this new Fauxhai before depending on that change.

v3.1.0 (2016-03-23)

  • Install GCC 4.8 if running on OmniOS >= 151008

v3.0.0 (2016-03-23)

  • Install GCC 4.9 on FreeBSD < 10
  • Install the version of kernel-devel that matches the running Kernel on RHEL
  • Remove suggests 'pkgutil' from the metadata as suggests does nothing
  • Properly warn the user that build-essential does not support Solaris 10 instead of just silently continuing on
  • Updated specs to run against more recent OS releases
  • Removed the warning for OmniOS users from the Readme as the upstream issue has been resolved
  • Switch from 7-zip to seven_zip cookbook as 7-zip has been deprecated
  • Add 7-zip to the system path on Windows hosts so the recipe will work out of the box
  • Switch from the deprecated 7-zip cookbook to seven_zip

v2.4.0 (2016-03-21)

  • Add gettext package to RHEL / FreeBSD to match other platforms
  • Fix OS X version detection logic to properly detect OS X 10.10 and 10.11

v2.3.1 (2016-02-18)

  • Restore Chef 11 compatibility and add Travis / Test Kitchen testing for Chef 11

v2.3.0 (2016-02-17)

  • Add mingw/msys based build tools for Windows

v2.2.4 (2015-10-06)

  • Add patch package on Fedora systems
  • Add additional platforms to Kitchen CI
  • Use Chef standard Rubocop file and resolve several issues
  • Update contributing and testing docs
  • Update Gemfile with the latest testing and development deps
  • Add and maintainers.toml files
  • Add chefignore file to limit the files uploaded to the Chef server
  • Add source_url and issues_url metadata for Supermarket

v2.2.3 (2015-04-15)

  • Don't install omnibus-build-essential on Solaris 10 - We decided it's easier to use the old GCC that ships with Solaris 10.
  • Use ChefDK for all Travis testing.

v2.2.2 (2015-03-27)

  • Update Solar 10's omnibus-build-essential to 0.0.5

v2.2.1 (2015-03-23)

  • Install GNU Patch on Solaris 11

v2.2.0 (2015-03-18)

  • [solaris] Differentiate between Solaris 10 and 11
  • [solaris] Add ucb compat package
  • [solaris] Solaris 10 build essential setup
  • Fix metadata to use a string instead of a bool (see #56, #57)

v2.1.3 (2014-11-18)

  • Update metadata for supported versions of OS X (10.7+) as noted from
  • v2.0.0 previously (#38)
  • Clarify requirement to have apt package cache updated in README. (#41)
  • Fix Xcode CLI installation on OS X (#50)

v2.1.2 (2014-10-14)

  • Mac OS X 10.10 Yosemite support

v2.1.0 (2014-10-14)

  • Use fully-qualified names when installing FreeBSD package

v2.0.6 (2014-08-11)

  • Use the resource form of remote_file to prevent context issues

v2.0.4 (2014-06-06)

  • [COOK-4661] added patch package to _rhel recipe

v2.0.2 (2014-05-02)

  • Updated documentation about older Chef versions
  • Added new SVG badges to the README
  • Fix a bug where potentially_at_compile_time fails on non-resources

v2.0.0 (2014-03-13)

  • Updated tested harnesses to use latest ecosystem tools
  • Added support for FreeBSD
  • Added support for installing XCode Command Line Tools on OSX (10.7, 10.8, 10.9)
  • Created a DSL method for wrapping compile_time vs runtime execution
  • Install additional developement tools on some platforms
  • Add nicer log and warning messages with helpful information

Potentially Breaking Changes

  • Dropped support for OSX 10.6
  • OSX no longer downloads OSX GCC and uses XCode CLI tools instead
  • build_essential -> build-essential in node attributes
  • compiletime -> compile_time in node attributes
  • Cookbook version 2.x no longer supports Chef 10.x

v1.4.4 (2014-02-27)

  • [COOK-4245] Wrong package name used for developer tools on OS X 10.9



  • COOK-3318 - Use Mixlib::ShellOut instead of Chef::ShellOut

New Feature



This version splits up the default recipe into recipes included based on the node's platform_family.

  • [COOK-2505] - backport omnibus builder improvements


  • [COOK-2272] - Complete platform_family conversion in build-essential


  • [COOK-2069] - build-essential will install osx-gcc-installer when XCode is present


  • [COOK-1895] - support smartos


  • Add test-kitchen support (source repo only)
  • [COOK-1677] - build-essential cookbook support for OpenSuse and SLES
  • [COOK-1718] - build-essential cookbook metadata should include scientific
  • [COOK-1768] - The apt-get update in build-essentials needs to be renamed


  • [COOK-1620] - support OS X 10.8


  • [COOK-1098] - support amazon linux
  • [COOK-1149] - support Mac OS X
  • [COOK-1296] - allow for compile-time installation of packages through an attribute (see README)


  • [COOK-1098] - Add Amazon Linux platform support
  • [COOK-1149] - Add OS X platform support

Collaborator Number Metric

0.1.0 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

0.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Foodcritic Metric

0.1.0 failed this metric

FC064: Ensure issues_url is set in metadata: build-gcc/metadata.rb:1
FC065: Ensure source_url is set in metadata: build-gcc/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: build-gcc/metadata.rb:1
Run with Foodcritic Version 14.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

0.1.0 passed this metric

Testing File Metric

0.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

0.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must include a tag that matches this cookbook version number