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


bag_config (4) Versions 1.0.0

Provides helpers for optional data bag configuration

cookbook 'bag_config', '= 1.0.0'
cookbook 'bag_config', '= 1.0.0', :supermarket
knife cookbook site install bag_config
knife cookbook site download bag_config


This cookbook provides helper methods to Recipe instances allowing them to easily provide configurations from data bag entries, and elegantly fall back to node attributes if the data bag entry does not exist or the attribute requested does not exist within the data bag entry.

By default, no attribute modification will be required when providing configuration to a recipe via data bag entries. The Basic Usage section will cover this simple usage. The Advanced Usage section will cover available configuration attributes to handle non-standard naming and extra data bag functionality.

Basic Usage


Recipes must make use of the #bag_or_node method(s) for data bag configuration to be applied. For example, below is a generic recipe:

# recipes/default.rb

template node[:test][:my_file] do

To provide support for data bag configuration, the recipe can be modifed like so:

# recipes/default.rb

template bag_or_node(:my_file) do

This allows the value to come from the configuration data bag if it exists and the value has been set there, other wise it will fall back to the value defined by node[:test][:my_file].

Naming scheme

Data bags

The name of the data bag used will correspond to the name of the cookbook the recipe resides within. For example, if the cookbook is named test, configuration entries will be searched for within the test data bag. Configuration entries for a node are based on the node name. If the name of the node is, then the test data bag will be searched for an entry with the id of config_test1_box.

Quick Ref:

cookbook: test
node name:
data bag entry: test/config_test1_box

Advanced Usage

Custom Data Bag

If the configuration entries are not within a data bag that corresponds to the cookbook name (or #node_key if it has been overriden) it can be explicitly defined via attribute:

  • node[cookbook][:config_data_bag_override] = 'my_custom_bag'

This will force config entries to be searched for within the my_custom_bag data bag.

Custom Data Bag Entry

By default, the configuration entries are based on the current node name, prefixed with config_. If a custom entry name is required:

  • node[cookbook][:config_bag] = 'myconfigentry'

This will force the data bag entry searched for to have the id myconfigentry.

Encrypted Data Bag Entry

Encrypted data bags are supported when the encrypted attribute is set:

  • node[cookbook][:config_bag][:encrypted] = true

This will require the secret being provided either inline:

  • node[cookbook][:config_bag][:secret] = 'my_secret'

or as a path to the secret file on the node:

  • node[cookbook][:config_bag][:secret] = '/etc/config_secret.file'

Note: If a custom data bag entry name is required, it can be supplied via the :name key:

  • node[cookbook][:config_bag][:name] = 'myconfigentry'

Advanced Recipe Usage

This section is for helpers and configurations available to recipes providing data bag based configuration.

Accessing configuration attributes

To access a single attribute:

file_name = bag_or_node(:file_name)

To access a number of attributes:

config_hash = bag_or_node_args(:file_name, :file_mode, :etc...)

The latter provides an easy way to fetch all configuration attributes at the start of the recipe and use the provided hash to access the values throughout the recipe.

Note: The resulting hash keys will be symbolized regardless of how they are initially provided to the method.

Non-standard attributes key

If the key used to access attributes on the node is not the same as the cookbook name of the recipe, it can be overriden in the recipe by calling #override_node_key.


Non-standard data bag

A custom data bag can be defined by recipe. Please note that if this approach is taken (rather than overriding via attributes) it must be done in all applicable recipes:


Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

gem_installer Applicable Versions

No quality metric results found