/ansible_sysctl

Ansible role to configure sysctl values

Primary LanguageJinjaCreative Commons Attribution Share Alike 4.0 InternationalCC-BY-SA-4.0

sysctl

This role can configure sysctl values (/proc/sys) and sysfs values (/sys).

Sysctl Values

The role configures sysctl values (under /etc/sysctl.d/) and restarts systemd-sysctl afterwards to apply them. The file the sysctl values is written to is called XX-ansible.conf where XX is a configurable number (default: 10). This allows to set the priority of the file if other packages/modules also place sysctl configurations to /etc/sysctl.d/. Note that when changing the value, the old file is not automatically removed.

Sysfs Values

The role installes the sysfsutils package and uses its /etc/sysfs.d/ directory to configure persistent sysfs values. Then it applies these values by restarting the sysfsutils service. The file the sysctl values is written to is called XX-ansible.conf where XX is a configurable number (default: 10). This allows to set the priority of the file if other packages/modules also place sysctl configurations to /etc/sysfs.d/. Note that when changing the value, the old file is not automatically removed.

Requirements

Debian with systemd

Role Variables

Name Default / Mandatory Description
sysctl_number 10 The number of the filename prefix
sysctl {} sysctl values to set
sysfs_number 10 The number of the filename prefix
sysfs {} sysctl values to set

Example Playbook

- hosts: all
  roles:
    - role: sysctl
      sysctl:
        net.ip6: 0
        net.bridge.bridge-nf-call-arptables: 0
      sysfs:
        bus/pci/devices/0000:01:00.0/enable: 0

License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Author Information