Menu

Chef Supermarket

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.

View our collection of guides, documentation, and articles

Cookbooks
Advanced Options

Select Badges

Select Supported Platforms

Select Status

RSS

filesystem (38) Versions 4.0.15

Installs/Configures various filesystems

Policyfile
Berkshelf
Knife 
cookbook 'filesystem', '= 4.0.15', :supermarket
cookbook 'filesystem', '= 4.0.15'
knife supermarket install filesystem
knife supermarket download filesystem
README
Dependencies
Changelog
Quality 50%

filesystem cookbook

Cookbook Version
CI State
OpenCollective
OpenCollective
License

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.

Maintainers

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 sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

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

Resources

Main Attributes

filesystems

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.

Usage

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"
    }
  }
}

Authors

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

https://opencollective.com/sous-chefs#backers

Sponsors

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

https://opencollective.com/sous-chefs/sponsor/0/website
https://opencollective.com/sous-chefs/sponsor/1/website
https://opencollective.com/sous-chefs/sponsor/2/website
https://opencollective.com/sous-chefs/sponsor/3/website
https://opencollective.com/sous-chefs/sponsor/4/website
https://opencollective.com/sous-chefs/sponsor/5/website
https://opencollective.com/sous-chefs/sponsor/6/website
https://opencollective.com/sous-chefs/sponsor/7/website
https://opencollective.com/sous-chefs/sponsor/8/website
https://opencollective.com/sous-chefs/sponsor/9/website

Dependent cookbooks

lvm >= 1.1

Contingent cookbooks

chef_libvirt Applicable Versions
chef_libvirt 0.0.1
chef_libvirt 0.0.2
chef_sheepdog Applicable Versions
chef_sheepdog 0.0.1

Changelog

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

4.0.15 - 2024-12-09

4.0.14 - 2024-05-03

  • Update tested platforms

4.0.13 - 2024-05-03

4.0.12 - 2024-05-02

4.0.11 - 2023-09-28

4.0.10 - 2023-09-04

4.0.9 - 2023-09-04

4.0.8 - 2023-06-08

Standardise files with files in sous-chefs/repo-management

4.0.7 - 2023-05-17

4.0.6 - 2023-05-03

4.0.5 - 2023-04-01

4.0.4 - 2023-03-02

4.0.3 - 2023-02-14

4.0.2 - 2023-02-14

4.0.1 - 2022-10-28

  • Remove delivery folder
  • Fix document: nomkfs option is not in filesystem resource

4.0.0 - 2021-10-14

  • Chef 17 compatibility
  • Minimum chef version set to 15.3

3.0.5 - 2021-08-31

  • Standardise files with files in sous-chefs/repo-management

3.0.4 (2021-06-01)

  • Standardise files with files in sous-chefs/repo-management

3.0.3 (2020-11-09)

  • resolved cookstyle error: resources/default.rb:118:35 convention: Style/RedundantCondition
  • fix the check for an existing mountable filesystem before running mkfs again

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 CHANGELOG.md
  • Added CONTRIBUTING.md
  • Removed Berksfile.lock
  • Added CODE_OF_CONDUCT.md
  • 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

Added

Collaborator Number Metric 
            
4.0.15 passed this metric

Contributing File Metric 
            
4.0.15 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 https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Cookstyle Metric 
            
4.0.15 passed this metric

No Binaries Metric 
            
4.0.15 passed this metric

Testing File Metric 
            
4.0.15 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 https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric 
            
4.0.15 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 https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number

Sous Chefs Sous Chefs
Lance Albertson
Jason Field
Timothy Smith

Details

View Source View Issues

Updated December 9, 2024 Created on

Supported Platforms

  • centos >= 0.0.0
  • debian >= 0.0.0
  • ubuntu >= 0.0.0
  • redhat >= 0.0.0
  • scientific >= 0.0.0
  • amazon >= 0.0.0
  • xenserver >= 0.0.0

License

Apache-2.0

Required Chef Infra Client

(>= 15.3)

Download Cookbook