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

RSS

dm-crypt (1) Versions 0.1.0

Installs/Configures dm-crypt

Berkshelf/Librarian
Policyfile
Knife
cookbook 'dm-crypt', '~> 0.1.0'
cookbook 'dm-crypt', '~> 0.1.0', :supermarket
knife cookbook site install dm-crypt
knife cookbook site download dm-crypt
README
Dependencies
Changelog
Quality 44%

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 12.2.1 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

License Metric
            

0.1.0 failed this metric

dm-crypt does not have a valid open source license.
Acceptable licenses include Apache-2.0, apachev2, Apache 2.0, MIT, mit, GPL-2.0, gplv2, GNU Public License 2.0, GPL-3.0, gplv3, GNU Public License 3.0.

No Binaries Metric
            

0.1.0 passed this metric

Publish Metric
            

0.1.0 passed this metric

Supported Platforms 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