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

RSS

efs (9) Versions 1.0.1

Installs/Configures Amazon Elastic Filesystem mounts

Policyfile
Berkshelf
Knife
cookbook 'efs', '= 1.0.1', :supermarket
cookbook 'efs', '= 1.0.1'
knife supermarket install efs
knife supermarket download efs
README
Dependencies
Changelog
Quality 83%

efs Cookbook

Cookbook to mount Elastic Filesystem endpoints in Amazon Web Services.

You just configure global defaults (presently the recommended values from Amazon) and individual mounts through node attributes. You also have the option of using the mount_efs resource within your own recipes.

Requirements

  • NFS

Platforms

  • Ubuntu 16.04
  • Centos 7.2
  • RHEL 7.2
  • Debian (untested)

Attributes

efs::default

<table>
<tr>
<th>Key</th>
<th>Type</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><tt>['efs']['mounts']</tt></td>
<td>hash of hashes</td>
<td>Keys are mount point paths, values can be any of the keys below. The <tt>fsid</tt> key is required. Any other optional keys will use global defaults from the attributes below.</td>
<td><tt>{}</tt></td>
</tr>
<tr>
<td><tt>['efs']['mounts'][mount point]['fsid']</tt></td>
<td>string (required)</td>
<td>FSID of the Elastic Filesystem (e.g. fs-1234abcd)</td>
<td></td>
</tr>
<tr>
<td><tt>['efs']['mounts'][mount point]['region']</tt></td>
<td>string</td>
<td>Override AWS region for the mount</td>
<td>derived from node['ec2']['placement_availability_zone']</td>
</tr>
<tr>
<td><tt>['efs']['mounts'][mount point]['options']</tt></td>
<td>string</td>
<td>Override mount options string</td>
<td>generated from attributes of mount and global below</td>
</tr>
<tr>
<td><tt>['efs']['rsize']</tt></td>
<td>int</td>
<td>maximum read size in bytes</td>
<td><tt>1048576</tt></td>
</tr>
<tr>
<td><tt>['efs']['wsize']</tt></td>
<td>int</td>
<td>maximum write size in bytes</td>
<td><tt>1048576</tt></td>
</tr>
<tr>
<td><tt>['efs']['timeout']</tt></td>
<td>int</td>
<td>timeout between retries in deciseconds</td>
<td><tt>600</tt></td>
</tr>
<tr>
<td><tt>['efs']['retrans']</tt></td>
<td>int</td>
<td>number of retries before further action</td>
<td><tt>2</tt></td>
</tr>
<tr>
<td><tt>['efs']['behavior']</tt></td>
<td>string</td>
<td>determines timeout behavior (hard or soft)</td>
<td><tt>hard</tt></td>
</tr>
<tr>
<td><tt>['efs']['remove_unspecified_mounts']</tt></td>
<td>boolean</td>
<td>Unmount and remove any EFS mount in fstab that is not specified by <tt>['efs']['mounts']</tt></td>
<td><tt>false</tt></td>
</tr>
</table>

Usage

efs::default

Configure any desired mounts under node['efs']['mounts'] and include efs in your node's run_list:

{
  "name":"my_node",
  "run_list": [
    "recipe[efs]"
  ]
}

mount_efs

This cookbook is implemented with a custom resource so you can use mount_efs in your cookbook recipes as well with the same available attributes as the node['efs']['mounts'] structure.

Contributing

  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

Authors: Matt Kulka matt@lqx.net

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

efs CHANGELOG

1.0.1

  • [mattlqx] - Fix resource not converging if fstab line exists but not mounted.

1.0.0

  • [mattlqx] - Moved implementation to library, wrappered by resource and recipe.

0.1.5

  • [mattlqx] - Gate more metadata for older Chef 11 delivery.

0.1.4

  • [mattlqx] - Add supporting docs recommended by Supermarket.

0.1.3

  • [mattlqx] - Add unit tests
  • [mattlqx] - Relocate ruby_block logic to library function
  • [mattlqx] - Add Travis CI

0.1.2

  • [mattlqx] - Metadata tweaks

0.1.0

  • [mattlqx] - Initial release of efs

Check the Markdown Syntax Guide for help with Markdown.

The Github Flavored Markdown page describes the differences between markdown on github and standard markdown.

Collaborator Number Metric
            

1.0.1 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.1 passed this metric

Foodcritic Metric
            

1.0.1 passed this metric

No Binaries Metric
            

1.0.1 passed this metric

Testing File Metric
            

1.0.1 passed this metric

Version Tag Metric
            

1.0.1 passed this metric