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

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

Requirements

Platforms

• Debian / Ubuntu derivatives
• RHEL and derivatives
• Fedora
• openSUSE / SUSE Linux Enterprises

Chef

• Chef 12.7+

Cookbooks

• none

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

• Author:: Seth Vargo ([email protected])

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.