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

zfsonlinux (1) Versions 1.0.0

Installs/Configures ZFS on Linux.

Policyfile
Berkshelf
Knife 
cookbook 'zfsonlinux', '~> 1.0.0', :supermarket
cookbook 'zfsonlinux', '~> 1.0.0'
knife supermarket install zfsonlinux
knife supermarket download zfsonlinux
README
Dependencies
Changelog
Quality 0%

zfsonlinux Cookbook

Build Status

Table of Contents

  1. Overview
  2. Requirements
  3. Attributes
  4. Usage
  5. Contributing
  6. License & Authors

Overview

This module manages the installation and configuration of ZFS on Linux.

Requirements

  • Chef 12.5+
  • yum Cookbook.
  • yum-epel Cookbook.

Attributes

Key Type Description Default
['zfsonlinux']['manage_repo'] Boolean Determines if Chef should manage the Yum repos for ZFS on Linux or not as well as the EPEL repo on DKMS installs. true
['zfsonlinux']['repo']['el']['type'] String Determines if dkms or kmod kernel modules should be used. If you are using the stock Red Hat kernel kmod is recommended. The default is set to dksm as this will work on any system by default. dkms
['zfsonlinux']['kmod']['modprobe'] Boolean Determines if when using the kmod installation method if the kernel module should be loaded by Chef or not. true

Usage

This cookbook can:

  • Optionally sets up the ZFS on Linux (and EPEL if using the dkms style install) repo.
  • Installs dependencies is using the dkms style install.
  • Installs the ZFS package.
  • Can manage zpools.
  • Can manage datasets.

A minimal default install (managed repos using dkms):

include_recipe 'zfsonlinux::default'

Using the kmod style install:

node.default['zfsonlinux']['repo']['el']['type'] = 'kmod'

include_recipe 'zfsonlinux::default'

zfsonlinux_zpool

To create a zpool:

zfsonlinux_zpool 'morpheus' do
  vdevs ['/dev/sdb', '/dev/sdc']
end

To destroy a zpool:

zfsonlinux_zpool 'morpheus' do
  action :destroy
end

NOTE: This resource currently only supports striped zpools.

zfsonlinux_dataset

To create a dataset with default properties:

zfsonlinux_dataset 'morpheus/nebuchadnezzar'

NOTE: You should ensure the parent zpool exists before creating a dataset on it.

To create a dataset with non-default properties:

zfsonlinux_dataset 'morpheus/nebuchadnezzar' do
  properties mountpoint: '/ship'
             compress: 'lz4'
end

To remove a dataset without children:

zfsonlinux_dataset 'morpheus/nebuchadnezzar' do
  action :destroy
end

To remove a dataset with children:

zfsonlinux_dataset 'morpheus/nebuchadnezzar' do
  remove_children true
  action :destroy
end

Contributing

If you would like to contribute to this cookbook please follow these steps;

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

License and Authors

License: BSD 2-Clause

Authors:

Dependent cookbooks

yum >= 3.5.2
yum-epel >= 0.7.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

2016-11-27 (v1.0.0)

Summary

Initial release.

Features

  • Optionally set-up ZFS on Linux repos (EL 6 & 7 supported.)
  • Install ZFS package (dkms & kmod supported).
  • Optionally enable the zfs kernel module.
  • Custom resources for:
    • zpools (zfsonlinux_zpool) - striped zpools only at this time.
    • datasets (zfsonlinux_dataset)

Collaborator Number Metric 
            
1.0.0 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

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

Foodcritic Metric 
            
1.0.0 failed this metric
FC009: Resource attribute not recognised: zfsonlinux/recipes/default.rb:10
FC108: Resource should not define a property named 'name': zfsonlinux/resources/dataset.rb:1
FC108: Resource should not define a property named 'name': zfsonlinux/resources/zpool.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric 
            
1.0.0 failed this metric
Failure: Cookbook should not contain binaries. Found:
zfsonlinux/files/default/gpg.key

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

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

Danny Roberts Danny Roberts

Details

View Source View Issues

Updated October 27, 2016 Created on

Supported Platforms

  • scientific >= 6.0
  • centos >= 6.0
  • redhat >= 6.0
  • oracle >= 6.0

License

BSD-2-Claue

Download Cookbook