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


mysqld (10) Versions 1.0.3

Installs/Configures mysqld

cookbook 'mysqld', '= 1.0.3'
cookbook 'mysqld', '= 1.0.3', :supermarket
knife cookbook site install mysqld
knife cookbook site download mysqld

mysqld Cookbook

Manage your mysqld servers with this cookbook. Unlike the official opscode mysql cookbook, it doesn't mess with the default mysql configuration. If you do not specify anything explicitly, the defaults of your distribution will be used. (At least if I do not mess up - Check the default attributes, if unsure (and file a pull request if you need to correct anything))


  • Defaults to OS settings unless explicitly specified otherwise
  • Supports all my.cnf settings

Currently tested on Ubuntu, should work on RHEL and Debian as well. Contributions to support other systems are very welcome!


You need to add the following line to your metadata.rb

depends 'mysqld'



Everything in your my.cnf can be maintained using attributes. Consider using the provides LWRPs (see below)

If you do not specify anything, the defaults of your os will be used.

This recipe supports every setting in the my.cnf. All your settings will be merged with the systems default, and then written to the my.cnf config file. The packages to install, the path to my.cnf as well as the name of the service are set automatically, and can be overwritten using the following attributes:

node['mysqld']['mysql_packages']          # When using mysql_install recipe
node['mysqld']['mariadb_packages']        # When using mariadb_install recipe
node['mysqld']['mariadb_galera_packages'] # When using mariadb_galera_install recipe

The configuration is stored in the node['mysqld']['my.cnf'] hash, and can be adapted like so

# node['mysqld']['my.conf'][<category>][<key>] = <value>
node['mysqld']['my.cnf']['mysqld']['bind-address'] = ''

This will expand to the following in your config file (leaving all other settings untouched)

  bind-address =

To remove a default option, you can pass false or nil as the value

# Remove deprecated innodb option
default['mysqld']['my.cnf']['mysqld']['innodb_additional_mem_pool_size'] = false

As the configuration file is constructed from the config hash, every my.cnf configuration option is supported.

node['mysqld']['root_password'] = 'yourpass'



  • Setup official MariaDB repository
  • Install MariaDB server
  • Configure MariaDB server according to the attributes. If no attributes are given, stick with the systems default


Runs mariadb_apt_repository or mariadb_yum_repository recipe according to your platform


Sets up official MariaDB repository to install packages from. Configure it using the following attributes

node['mysqld']['repository']['version'] # Defaults to '10.1'
node['mysqld']['repository']['mirror']  # Defaults to HostEurope mirror


Sets up official MariaDB repository to install packages from. Configure it using the following attributes

node['mysqld']['repository']['version'] # Defaults to '10.1'
node['mysqld']['repository']['mirror']  # Defaults to HostEurope mirror


Install mariadb packages (according to attributes, defaults to mariadb-server)


Install mysql packages (according to attributes, defaults to mysql-server)


Configure mysql according to attributes. Sets the databases root account (resp. debian-sys-maint on Debian/Ubuntu systems) to use the password in node['mysqld']['root_password'], if the attribute is set.


Run mariadb\_repository and mariadb\_galera\_install recipes, then configure as the configure recipe would do, but start mariadb with --wsrep-new-cluster --wsrep\_cluster\_address=gcomm:// to initialize a new Galera cluster.

Use this if you want to setup a new Galera cluster, and run it on your first node once:

$ sudo chef-client --once -o 'recipe[mysqld::mariadb_galera_init]'

Once you connected the other nodes using the regular recipes, re-run chef-client as you did on the other servers.

Note: If you use a wrapper cookbook to configure your instances, attributes might not be available when running the recipe with -o recipe[]. Create a mariadb_galera_init recipe in your wrapper cookbook, calling this recipe if you have trouble.



You can configure your database also using the mysqld provider:

include_recipe 'mysqld::mariadb_galera_install'

# Name attribute will be ignored. Choose something that makes sense for you
mysqld 'galera' do
  my_cnf { 'bind-address' => '' }


You can set passwords (incl. root and debian-sys-maint accounts) using this provider. By default, the provider uses the created root/debian-sys-maint accounts depending on the system you are on.

mysqld_password 'root' do
  password 'get_from_data_bag_maybe?'

  # If required, you can specify your own auth-scheme here
  # auth '-u specialuser -pmypass'


Contributions are very welcome!

  1. Fork the repository on Github
  2. Create a named feature branch (like add_component_x)
  3. Write you change
  4. Write tests for your change (if applicable)
  5. Run the tests, ensuring they all pass
  6. Submit a Pull Request using Github

License and Authors

Authors: Chris Aumann

License: GPLv3


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


  • Use Upstart provider only on Ubuntu 13.10


  • Restart service immediately when my.cnf is updated


  • Do not force presence of password attribute


  • Add support for mariadb
  • Add support for mariadb-galera
  • Automatically set admin passwords if attribute is given (incl. modifying /etc/mysql/debian.cnf accordingly, if required)

Compatibility changes:

  • Rename node['mysqld']['packages'] attribute to node['mysqld']['mysql_packages']


  • Add support to remove configuration options set by default attributes


  • Do not manage service_name, when service_name is empty
  • Fixes an issue with the template when the LWRP was called from another cookbook
  • Use deep_merge to merge my.cnf hashes


  • Initial release of mysqld

Foodcritic Metric

1.0.3 failed this metric

FC021: Resource condition in provider may not behave as expected: /tmp/cook/89a25daf64aa3a87bf6d56b0/mysqld/providers/default.rb:48
FC021: Resource condition in provider may not behave as expected: /tmp/cook/89a25daf64aa3a87bf6d56b0/mysqld/providers/password.rb:31