Description

This cookbook manages tmpfs RAM disks with Chef.

Requirements

Supported Platforms

This cookbook has been tested on the following platforms:

• CentOS
• Debian
• Fedora
• FreeBSD
• RedHat
• Ubuntu

FreeBSD support is somewhat limited due to its current implementation: the remount is not supported on this platform and some mount options are ignored.

Please, let us know if you use it successfully on any other platform.

Required Applications

• Ruby 1.9.3 or higher.

Resources

ramdisk[path]

Creates or deletes a RAM disk.

If you change the RAM disk size, the ramdisk resource will try to remount the disk without umounting.

ramdisk Actions

• create: Creates a RAM disk (default).
• delete: Deletes a RAM disk.

ramdisk Parameters

Attributes

These attributes are primarily intended to support the different platforms. Do not touch them unless you know what you are doing.

Usage

Including in the metadata

Before using this cookbook, remember to put it as a dependency in your metadata:

# metadata.rb
depends 'ramdisk'

Basic Example

Create a 10MB tmpfs RAM disk:

ramdisk '/mnt/ramdisk1' do
  size '10m'
end

A Complex Example

Create a tmpfs RAM disk setting some options and the owner user:

ramdisk '/tmp/secure_bob_ramdisk' do
  size '1g'
  user 'bob'
  group 'bob'
  persist false
  nosuid true
  nodev true
  noexec true
  noatime true
  inodes '999k'
  mode '750'
end

Testing

See TESTING.md.

Contributing

Please do not hesitate to open an issue with any questions or problems.

See CONTRIBUTING.md.

TODO

See TODO.md.

License and Author

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.