Sous-Chefs-Boneyard / swap

Development repository for the swap cookbook
https://supermarket.chef.io/cookbooks/swap
Apache License 2.0
32 stars 33 forks source link
chef chef-cookbook chef-resource swap

The swap resource from this cookbook is now shipping as part of Chef 14. With the inclusion of this resource into Chef itself we are now deprecating this cookbook. It will continue to function for Chef 13 users, but will not be updated.

Swap Cookbook

CircleCI Cookbook Version

This cookbook provides resource for easily creating and managing swap files.

Requirements

Platforms

Chef

Cookbooks

Usage

Add a new swap:

swap_file '/mnt/swap' do
  size      1024    # MBs
end

Or remove an existing one:

swap_file '/mnt/swap' do
  action    :remove
end

LWRP Attributes

Attribute Description Example Default
path The path to put the swap file on the system /mnt/swap
size The size (in MBs) for the swap file 2048
persist Persist the swapon true false
timeout Timeout for dd/fallocate 600 600

Installation

If you're using berkshelf, add swap to your Berksfile:

cookbook 'swap'

Otherwise, install the cookbook from the community site:

knife cookbook site install swap

Have any other cookbooks depend on this cookbook by adding it to the metadata.rb:

depends 'swap'

Now you can use the LWRP in your cookbook!

ChefSpec matchers

create_swap_file(path)

Assert that the Chef run creates swap_file.

expect(chef_run).to create_swap_file(path).with(
  :size => 1024
)

remove_swap_file(path)

Assert that the Chef run removes swap_file.

expect(chef_run).to remove_swap_file(path)

Contributing

  1. Fork the project
  2. Create a feature branch corresponding to you change
  3. Commit and test thoroughly
  4. Create a Pull Request on github

    • ensure you add a detailed description of your changes

License & Authors

Copyright 2012-2016, Seth Vargo

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.