https://github.com/geerlingguy/ansible-role-swap

Ansible Role - Swap
https://github.com/geerlingguy/ansible-role-swap

ansible centos debian fedora memory ram redhat role swap swapfile ubuntu

Last synced: 15 days ago
JSON representation

Ansible Role - Swap

• Host: GitHub
• URL: https://github.com/geerlingguy/ansible-role-swap
• Owner: geerlingguy
• License: mit
• Created: 2018-05-23T03:34:53.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2025-01-31T03:25:53.000Z (3 months ago)
• Last Synced: 2025-04-04T04:31:29.512Z (24 days ago)
• Topics: ansible, centos, debian, fedora, memory, ram, redhat, role, swap, swapfile, ubuntu
• Homepage: https://galaxy.ansible.com/geerlingguy/swap/
• Size: 31.3 KB
• Stars: 163
• Watchers: 6
• Forks: 70
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Ansible Role: Swap

[![CI](https://github.com/geerlingguy/ansible-role-swap/actions/workflows/ci.yml/badge.svg)](https://github.com/geerlingguy/ansible-role-swap/actions/workflows/ci.yml)

An Ansible Role that configures swap space on Linux.

## Requirements

None.

## Role Variables

Available variables are listed below, along with default values (see `defaults/main.yml`):

    swap_file_path: /swapfile

The location of the swap file on the server.

    swap_file_size_mb: '512'

How large (in mebibytes) to make the swap file.

    swap_swappiness: '60'

The `vm.swappiness` value to be configured in sysconfig.

    swap_file_state: present

If you wish to _remove_ your swapfile, and disable swap, set this to `absent`. Generally you'd probably want to set this to `present`.

    swap_file_create_command: "dd if=/dev/zero of={{ swap_file_path }} bs=1M count={{ swap_file_size_mb }}"

The command used to create the swap file. You could switch to using `fallocate` to write the swap file more quickly, though there may be inconsistencies if not writing the file with `dd`.

## Dependencies

None.

## Example Playbook

    - hosts: all

    

      vars:

        swap_file_size_mb: '1024'

    

      roles:

        - geerlingguy.swap

## License

MIT / BSD

## Author Information

This role was created in 2018 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).