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

dm-crypt (2) Versions 0.1.0

Installs/Configures dm-crypt

Policyfile
Berkshelf
Knife 
cookbook 'dm-crypt', '= 0.1.0', :supermarket
cookbook 'dm-crypt', '= 0.1.0'
knife supermarket install dm-crypt
knife supermarket download dm-crypt
README
Dependencies
Changelog
Quality 33%

dm-crypt Cookbook

Build Status

Table of Contents

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

Overview

This cookbook provides a way to format devices with LUKS via dm-crypt. Other encryption options supported by dm-crypt as well as other features will be added in time.

Requirements

Requires Chef 12.5 or later as this cookbook makes use of Custom Resources.

Usage

You always need to include the main recipe:

include_recipe 'dm-crypt::default'

This installs 2 packages:

  • cryptsetup - Utilities for interacting with dm-crypt.
  • file - Used to determine if devices are correctly formatted.

dmcrypt_device

Each device to be formatted by dm-crypt is defined by a dmcrypt_device custom resource.

Each dmcrypt_device has the following attributes:

Attribute Type Description Default
name String Resource name. N/A
device String The absolute path to the device to be formatted. N/A
passphrase String Passphrase used to encrypt the device. N/A
keyfile String Key file used to encrypt the device. N/A

NOTE: You must supply either a passphrase or a keyfile but never both.

To encrypt an LVM partition:

dmcrypt_device 'enc_data' do
  device '/dev/mapper/vg_enc-lv_data'
  passphrase 'supersecretword'
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. Run the tests, ensuring they all pass.
  6. Submit a Pull Request using Github.

License and Authors

License: [BSD 2 Clause](https://tldrlegal.com/license/bsd-2-clause-license-\(freebsd\)

Authors:

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

2016-02-15

Summary

Initial release.

Features

  • Installs cryptsetup utilities.
  • Provides resource for dmcrypt_device to format devices with dm-crypt (LUKS).

Collaborator Number Metric 
            
0.1.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.1.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 
            
0.1.0 failed this metric
FC108: Resource should not define a property named 'name': dm-crypt/resources/device.rb:3
Run with Foodcritic Version 14.0.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric 
            
0.1.0 passed this metric

Testing File Metric 
            
0.1.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 
            
0.1.0 passed this metric

Danny Roberts Danny Roberts

Details

View Source View Issues

Updated February 15, 2016 Created on

Supported Platforms

  • ubuntu = 12.04
  • debian >= 7.0
  • centos >= 7.0
  • redhat >= 7.0
  • scientific >= 7.0
  • oracle >= 7.0

License

BSD-2-Clause

Download Cookbook