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


filesystem (35) Versions 3.0.2

Installs/Configures various filesystems

cookbook 'filesystem', '= 3.0.2', :supermarket
cookbook 'filesystem', '= 3.0.2'
knife supermarket install filesystem
knife supermarket download filesystem
Quality 100%

filesystem cookbook

Cookbook Version
CI State

This cookbook exists to generically define and create block device filesystems with the minimum of inputs.

This cookbook supports four main types of block devices:

  • normal device - drives, SSDs, volumes presented by HBAs etc
  • device ID uuid - mostly found on drives / known block IDs.
  • LVM Volume Groups vg - found on systems using LVM.
  • file-backed file - created dynamically and looped back.

We will try to create filesystems in two ways: through keys found in node data under 'filesystems' or by being called directly with the filesystem default provider. See the example recipe.

You can also use your own key for a list of filesystems, see the example recipe for an example of this option.

Tools have been listed in the following attribute key : filesystem_tools. This allows for extending the support to other/new filesystems.

Network file systems, nfs and others, are somewhat supported. This cookbook will attempt to create a mount point, enable the filesystem by adding an /etc/fstab entry for the filesystem mount and will attempt to mount the filesystem. This cookbook does not attempt to modify the internal contents of network filesystems.


This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit or come chat with us on the Chef Community Slack in #sous-chefs.


  • lvm cookbook when creating logical volumes
  • package #{fstype}progs to support your chosen fstype. We provide some defaults, too.


Main Attributes


Hash of filesytems to setup - this is called filesystems because filesystem is already created/managed by ohai (i.e. no s on the end).

node[:filesystems] keys

Each filesytem's key is the FS label: This explains each key in a filesystems entry. The label must not exceed 12 characters.

We also let you use your own top-level key if you want - see the default recipe and example recipe.


Keyed filesystem creation:

 "filesystems": {
   "testfs1": {
     "device": "/dev/sdb",
     "mount": "/db",
     "fstype": "xfs",
     "options": "noatime,nodev",
     "mkfs_options": "-d sunit=128,swidth=2048"
   "applv1": {
     "mount": "/logical1",
     "fstype": "ext4",
     "vg": "standardvg",
     "size": "20G"
   "cluster_01": {
     "fstype": "ocfs2",
     "package": "ocfs2-tools",
     "device": "/dev/mpath/ocfs01",
     "mount": "/mnt/test"
   "filebacked": {
     "file": "/mnt/filesystem-on-a-filesystem.file",
     "device": "/dev/loop7",
     "mount": "/mnt/filesystem-on-a-filesystem",
     "size": "20000"



This project exists thanks to all the people who contribute.


Thank you to all our backers!


Support this project by becoming a sponsor. Your logo will show up here with a link to your website.


All notable changes to this project will be documented in this file.

3.0.2 (2020-09-16)

  • resolved cookstyle error: libraries/fs.rb:14:5 convention: Style/RedundantAssignment
  • resolved cookstyle error: libraries/fs.rb:15:1 convention: Layout/EmptyLinesAroundMethodBody
  • resolved cookstyle error: libraries/fs.rb:15:1 convention: Layout/TrailingWhitespace

3.0.1 (2020-08-07)

  • Fix README spelling errors and formatting

3.0.0 (2020-07-30)

  • Simplified the filesystem freeze action code
  • Added tests for the freeze action
  • Updated the versions of platforms to test against
  • Add the device_defer attribute to the filesystem resource. If set to true and the backing device does not exist the default resource returns without processing or error.
  • Convert the lwrp resources to custom resources
  • Add dokken cookbook converges and tests to the github flow

2.0.2 (2020-06-18)

  • Removed Dangerfile from rubocop.yml
  • Deleted rubocop.yml
  • Ran latest cookstyle to clean up minor style issues

2.0.1 - 2020-05-20

  • resolved cookstyle error: providers/filebacked.rb:36:14 refactor: ChefModernize/ShellOutHelper

2.0.0 - 2020-05-05

  • Require Chef Infra Client 14+
  • Remove unused long_description metadata
  • Remove ChefSpec matchers that are autogenerated now
  • resolved cookstyle error: resources/create_all_from_key.rb:25:1 refactor: ChefRedundantCode/UnnecessaryNameProperty
  • resolved cookstyle error: resources/default.rb:25:1 refactor: ChefRedundantCode/UnnecessaryNameProperty
  • resolved cookstyle error: resources/filebacked.rb:25:1 refactor: ChefRedundantCode/UnnecessaryNameProperty
  • resolved cookstyle error: resources/filebacked.rb:26:1 convention: Layout/EmptyLines

1.0.0 - 2018-03-14

  • Fix idempotence of 'wait for device' block
  • Remove possible double format of disks if force
  • Do not perform test mount if ignore_existing and force
  • Use truthy value of ignore_existing rather than nil?
  • updated mount resource in providers/default.rb to notify directory resource immediately to fix mount permissions after mounting
  • Fix linting errors
  • Updated default provider to notify directory resource immediately upon mounting filesystem. (#37)
  • Reorganise code to only format disks once
  • Fix missing /etc/fstab file in centos7 image
  • Remove xfsprogs-devel

0.12.0 - 2017-04-24

  • removed xfs dependency, installing packages in default.rb

0.11.1 - 2017-03-20

  • fixed issue with frozen being a ruby default function

0.11.0 - 2017-03-13

  • Added
  • Added
  • Removed Berksfile.lock
  • Added
  • Added Delivery
  • Added Travis
  • Added Test-Kitchen, Kitchen-dokken
  • updated Berksfile to supermarket
  • updated lvm >= 1.1
  • updated to sous-chefs

0.10.6 - 2016-01-21

0.10.2 - 2015-10-13

  • dont wait for network devices they won't exist
  • make fetches to fspackages not fail on unknown types


Collaborator Number Metric

3.0.2 passed this metric

Contributing File Metric

3.0.2 passed this metric

Foodcritic Metric

3.0.2 passed this metric

No Binaries Metric

3.0.2 passed this metric

Testing File Metric

3.0.2 passed this metric

Version Tag Metric

3.0.2 passed this metric