Forge Home

Modules

Puppet

Resources

PuppetEcosystemPuppet CommunityUpdates

swap_file

Create swap files for Linux systems with Puppet
Project URLRSS FeedReport issues

88 downloads

88 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 5.0.0 (latest)
released Sep 20th 2024
This version is compatible with:
  • Puppet Enterprise 2023.8.x, 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x
  • Puppet >= 7.0.0 < 9.0.0
  • , , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'puppet-swap_file', '5.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add puppet-swap_file
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install puppet-swap_file --version 5.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

puppet/swap_file — version 5.0.0 Sep 20th 2024

swap_file

CI License puppetmodule.info docs Donated by petems

Puppet Forge Endorsement Puppet Forge Version Puppet Forge Score Puppet Forge Downloads

Table of Contents

  1. Overview
  2. Setup
  3. Usage
  4. Limitations
  5. Upgrading from 1.0.1 Release
  6. Development

Overview

Manage swap files for your Linux environments. This is based on the gist by @Yggdrasil, with a few changes and added specs.

Setup

What swap_file affects

  • Creating a swap-file on disk. This uses dd by default, but can use fallocate optionally for performance reasons. Note: Using fallocate to create a ZFS file system will fail: https://bugzilla.redhat.com/show_bug.cgi?id=1129205
  • Swapfiles on the system
  • Any mounts of swapfiles

Usage

The simplest use of the module is this:

swap_file::files { 'default':
  ensure   => present,
}

By default, the module it will:

  • create a file using /bin/dd at /mnt/swap.1 with the default size taken from the $::memorysize fact in megabytes (eg. 8GB RAM will create an 8GB swap file)
  • A mount for the swapfile created

For a custom setup, you can do something like this:

swap_file::files { 'tmp file swap':
  ensure    => present,
  swapfile  => '/tmp/swapfile',
  add_mount => false,
}

To use fallocate for swap file creation instead of dd:

swap_file::files { 'tmp file swap':
  ensure    => present,
  swapfile  => '/tmp/swapfile',
  cmd       => 'fallocate',
}

To remove a prexisting swap, you can use ensure absent:

swap_file::files { 'tmp file swap':
  ensure   => absent,
}

To choose the size of the swap file instead of defaulting to memory size:

swap_file::files { '5GB Swap':
  ensure       => present,
  swapfile     => '/mnt/swap.5gb',
  swapfilesize => '5GB',
}

hiera

You can also use hiera to call this module and set the configuration.

The simplest use of the module with hiera is this:

classes:
  - swap_file

swap_file::files:
  'default':
    ensure: 'present'

This hiera setup will create a file using /bin/dd atr /mnt/swap.1 with the default size taken from the $::memorysize fact and add a mount resource for it.

You can use all customizations mentioned above in hiera like this:

classes:
  - swap_file

swap_file::files:
  'custom setup':
    ensure: 'present'
    swapfile: '/tmp/swapfile.custom'
    add_mount: false
  'use fallocate':
    swapfile: '/tmp/swapfile.fallocate'
    cmd: 'fallocate'
  'remove swap file'
    ensure: 'absent'
    swapfile: '/tmp/swapfile.old'

This hiera config will respectively:

  • create a file /tmp/swapfile.custom using /bin/dd with the default size taken from the $::memorysize fact without creating a mount for it.
  • create a file /tmp/swapfile.fallocate using /usr/bin/fallocate with the default size taken from the $::memorysize fact and creating a mount for it.
  • deactivates the swapfile /tmp/swapfile.old, deletes it and removes the mount.

Set $files_hiera_merge to true to merge all found instances of swap_file::files in Hiera. This is useful for specifying swap files at different levels of the hierachy and having them all included in the catalog.

Upgrading from 1.0.1 Release

Previously you would create swapfiles with the swap_file class:

class { 'swap_file':
  ensure => 'present',
}

However, this had many problems, such as not being able to declare more than one swap_file because of duplicate class errors. Since 2.x.x the swapfiles are created by a defined type instead. The swap_file class is now a wrapper and can handle multiple swap_files.

You can now use:

class { 'swap_file':
  files => {
    'freetext resource name' => {
      ensure => 'present',
    },
  },
}

You can also safely declare mutliple swap file definitions:

class { 'swap_file':
  files => {
    'swapfile' => {
      ensure => 'present',
    },
    'use fallocate' => {
      swapfile => '/tmp/swapfile.fallocate',
      cmd      => 'fallocate',
    },
    'remove swap file' => {
      ensure   => 'absent',
      swapfile => '/tmp/swapfile.old',
    },
  },
}

Limitations

Primary support is for Debian and RedHat, but should work on all Linux flavours.

Right now there is no BSD support, but I'm planning on adding it in the future

Development

Follow the CONTRIBUTING guidelines! :)

Transfer Notice

This project was originally authored by Peter Souter. The maintainer preferred that Vox Pupuli take ownership of the project for future improvement and maintenance. Existing pull requests and issues were transferred over, please fork and continue to contribute here.