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


rethinkdb-cluster (2) Versions 0.3.0

Installs/Configures RethinkDB, and configure a cluster

cookbook 'rethinkdb-cluster', '~> 0.3.0', :supermarket
cookbook 'rethinkdb-cluster', '~> 0.3.0'
knife supermarket install rethinkdb-cluster
knife supermarket download rethinkdb-cluster
Quality 17%


Installs RethinkDB and configures it in a cluster.



  • Ubuntu 20.04 LTS


  • Chef >= 16


Server process

Name Purpose Default
default['rethinkdb']['version'] Choose the package version to be installed nil meaning latest
default['rethinkdb']['server_tags'] Tags to be passed when running the server. See the Server tags documentation page nil meaning no tags
default['rethinkdb']['data_directory'] Server directory where data and logs are stored /var/lib/rethinkdb/instances.d/cluster
default['rethinkdb']['tls']['cluster'] Should the cluster communication be secured using certificate from an encrypted data bag false


Name Purpose Default
default['rethinkdb']['network']['bind'] Address of local interfaces to listen on when accepting connections (See attributes/default.rb`) nil meaning RethinkDB default to all local addresses
default['rethinkdb']['network']['ports']['cluster'] RethinkDB port used for cluster communications nil meaning RethinkDB default to 29015 + port-offset
defautl['rethinkdb']['network']['disable-admin-ui'] Disables RethinkDB Admin UI true
default['rethinkdb']['network']['ports']['admin'] RethinkDB admin port nil meaning RethinkDB default to 8080 + port-offset


This cookbook leverages the Chef's search so that converging a first node will
initialize a RetinkDB cluster, while all other converged nodes, with the same
tags than the first one, will automatically join it automatically.


  • rethinkdb-cluster::default : Installs and configure RethinkDB
  • rethinkdb-cluster::install : Installs RethinkDB using the package manager

Securing cluster communications

When your nodes doesn't have a secured private network, you must secure the
cluster communications using a TLS certificate.\
You can find more on the RethinkDB documentation.

In order to do so, you have the create a TLS certificate following the
instructions from the RethinkDB documentation page.\
You should have a cert.pem and a 'key.pem' file.

You will have to store them inline so you need to get a single line version
usign the commands :
* awk 'NF {sub(/\r/, ""); printf "%s\\n",$0;}' cert.pem && echo
* awk 'NF {sub(/\r/, ""); printf "%s\\n",$0;}' key.pem && echo

Now you need to create an encrypted data bag with named rethinkdb with the
item tls:

EDITOR=nano knife data bag create rethinkdb tls --secret-file ~/.chef/knife-secret

(The file ~/.chef/knife-secret is a regular file including a simple string,
like a MD5, SHA256, RSA key etc). You have to upload that file on each nodes at
the path /etc/chef/encrypted_data_bag_secret which will allow Chef to decrypt
the data bag).

In the created data bag, add the cluster-cert and cluster-key attributes with
the inline version of the above generated files:

  "id": "tls",
  "cluster-cert": "-----BEGIN CERTIFICATE-----\nMIID...Uj4=\n-----END CERTIFICATE-----\n",
  "cluster-key": "-----BEGIN RSA PRIVATE KEY-----\nMIIE...hjU\n-----END RSA PRIVATE KEY-----\n"

Last but not least update the default['rethinkdb']['tls']['cluster'] attribute
to true and converge.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

rethinkdb-cluster CHANGELOG

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

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


0.3.0 - 2022-02-11


  • Admin UI config to disable it and change port

0.2.0 - 2022-02-09


  • Implements clustering configuration (port + TLS)

0.1.0 - 2022-02-02

Initial release.

Collaborator Number Metric

0.3.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.3.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.3.0 failed this metric

FC067: Ensure at least one platform supported in metadata: rethinkdb-cluster/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

0.3.0 passed this metric

Testing File Metric

0.3.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.3.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