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

The mysql_chef_gem cookbook has been deprecated

Author provided reason for deprecation:

The mysql_chef_gem cookbook has been deprecated and is no longer being maintained by its authors. Use of the mysql_chef_gem cookbook is no longer recommended.


mysql_chef_gem (8) Versions 4.0.2

Provides the mysql_chef_gem resource

cookbook 'mysql_chef_gem', '~> 4.0.2', :supermarket
cookbook 'mysql_chef_gem', '~> 4.0.2'
knife supermarket install mysql_chef_gem
knife supermarket download mysql_chef_gem
Quality 17%

mysql Chef Gem Installer Cookbook

Build Status Cookbook Version

mysql_chef_gem is a library cookbook that provides an LWRP for use in recipes. It provides a wrapper around chef_gem called mysql_chef_gem that eases the installation process, collecting the prerequisites and side-stepping the compilation phase arms race.


This cookbook is concerned with the installation of the mysql Rubygem into Chef's gem path. Installation into other Ruby environments, or installation of related gems such as mysql2 are outside the scope of this cookbook. For installing the mysql2 gem see



The following platforms have been tested with Test Kitchen and are known to work.

|                                      | 5.0 | 5.1 | 5.5 | 5.6 | 5.7 | MariaDB |
| MysqlChefGem::Mysql / centos-5       |  X  |     |     |  X  |  X  |         |
| MysqlChefGem::Mysql / centos-6       |     |  X  |  X  |  X  |  X  |         |
| MysqlChefGem::Mysql / centos-7       |     |     |  X  |  X  |  X  |         |
| MysqlChefGem::Mysql / debian-7       |     |     |  X  |     |     |         |
| MysqlChefGem::Mysql / debian-8       |     |     |  X  |     |     |         |
| MysqlChefGem::Mysql / fedora-22      |     |     |     |  X  |  X  |         |
| MysqlChefGem::Mysql / fedora-23      |     |     |     |  X  |  X  |         |
| MysqlChefGem::Mysql / ubuntu-12.04   |     |     |  X  |     |     |         |
| MysqlChefGem::Mysql / ubuntu-14.04   |     |     |  X  |  X  |     |         |
| MysqlChefGem::Mariadb / fedora-22    |     |     |     |     |     |    X    |
| MysqlChefGem::Mariadb / fedora-23    |     |     |     |     |     |    X    |
| MysqlChefGem::Mariadb / ubuntu-14.04 |     |     |     |     |     |    X    |


  • Chef 12.1+


  • build-essential
  • mysql 6.0+
  • mariadb


Place a dependency on the mysql_chef_gem cookbook in your cookbook's metadata.rb

depends 'mysql_chef_gem', '~> 3.0'

Then, in a recipe:

mysql_chef_gem 'default' do
  action :install

Resources Overview


The mysql_chef_gem resource the build dependencies and installation of the mysql rubygem into Chef's Ruby environment


mysql_chef_gem 'default' do
  gem_version '2.9.1'
  action :install


  • gem_version - The version of the mysql Rubygem to install into the Chef environment. Defaults to '2.9.1'
  • connectors_url - URL of a tarball containing pre-compiled MySQL connector libraries
  • connectors_checksum - sha256sum of the connectors_url tarball


  • :install - Build and install the gem into the Chef environment
  • :remove - Delete the gem from the Chef environment


Chef selects a default provider based on platform and version, but you can specify one if your platform support it.

mysql_chef_gem 'default' do
  provider Chef::Provider::mysqlChefGem::Mariadb
  Action :install

License & Authors

Author: Cookbook Engineering Team (

Copyright: 2014-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
mysql >= 6.0.0
mariadb >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

mysql_chef_gem CHANGELOG

This file is used to list changes made in each version of the mysql_chef_gem cookbook.

4.0.2 (2017-04-27)

  • Expand the chefspec helper and remove the report that’s useless
  • Update chefignore file for policyfiles

4.0.1 (2017-04-26)

  • Update apache2 license string

4.0.0 (2016-09-16)

  • Remove double entries
  • Fix some faulty instructions
  • Testing updates
  • Require Chef 12.1

v3.0.1 (2016-04-25)

  • Updated the readme's list of supported platforms to match current tested platforms
  • Added testing of all PRs using Kitchen-Docker in Travis
  • Updated Test Kitchen suites to test the most recent platforms / MySQL releases available
  • Depend mysql cookbook 6.0+ which was needed by the providers

v3.0.0 (2015-10-21)

  • Removed Chef 10 backwards compatibility. This cookbook requires 11+
  • Expanded the requirements and license sections of the readme to match other Chef managed cookbooks
  • Added oracle as a supported platform in the metadata
  • Added long_description to the metadata
  • Added issues_url and source_url to the metadata for Supermarket
  • Updated the .gitignore file
  • Expanded platforms tested in Test Kitchen
  • Added the standard Chef Rubocop config
  • Updated Travis CI to use ChefDK for testing deps
  • Updated testing and development deps in the Gemfile
  • Updated Testing and Contributing docs
  • Added maintainers.toml and maintainers.rb files
  • Added Travis status and cookbook version badges to the readme
  • Added a Rakefile for simplified testing
  • Added a chefignore file to limit what files are uploaded to the Chef server

v2.0.2 (2014-12-26)

  • Updating source in Berksfile

v2.0.1 (2014-12-25)

  • Switching to include_recipe from recipe_eval

v2.0.0 (2014-12-23)

  • Reverting to using vendor packages instead of the connector tarball
  • Adding support for linking against MariaDB libraries

v1.0.0 (2014-12-12)

  • Removing recipe that contained a single resource
  • Removed dependency on mysql cookbook
  • Switched to using the MySQL connector libraries tarball from a webserver rather than system development package
  • Added serverspec tests
  • Updated the README

v0.0.5 (2014-09-26)

  • Reverting installation of ruby dev packages

v0.0.4 (2014-09-22)

  • Fixing some bugs in the README
  • Adding more development packages

v0.0.2 (2014-03-31)

Initial Release

v0.0.1 (2014-03-28)

  • Initial release

Collaborator Number Metric

4.0.2 failed this metric

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

Contributing File Metric

4.0.2 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

4.0.2 failed this metric

FC122: Use the build_essential resource instead of the recipe: mysql_chef_gem/libraries/provider_mysql_chef_gem_mysql.rb:13
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

4.0.2 passed this metric

Testing File Metric

4.0.2 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

4.0.2 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