arillso.system.tuning role – Apply system performance tuning configurations

Note

This role is part of the arillso.system collection (version 1.0.5).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install arillso.system.

To use it in a playbook, specify: arillso.system.tuning.

Entry point main – Apply system performance tuning configurations

Synopsis

  • This role configures system-level performance tuning including sysctl parameters, network tuning, I/O schedulers, CPU governors, and security limits for optimized server performance.

Parameters

Parameter

Comments

tuning_cpu_governor

string

CPU governor to use. Set to ‘auto’ for automatic detection based on CPU type.

Default: "auto"

tuning_cpu_governor_override

string

Override automatic CPU governor detection

tuning_grub_cmdline_linux_append

string

Kernel parameters to append to GRUB configuration

Default: "transparent_hugepage=never"

tuning_io_scheduler

string

I/O scheduler to use. Set to ‘auto’ for automatic detection based on storage type.

Default: "auto"

tuning_io_scheduler_devices

list / elements=string

List of specific block devices to apply I/O scheduler settings to

Default: []

tuning_io_scheduler_override

string

Override automatic I/O scheduler detection

tuning_network_ring_buffers

list / elements=dictionary

List of network interface ring buffer configurations

Default: []

interface

string / required

Network interface name (e.g., eth0, ens3)

rx_buffer

integer / required

Receive ring buffer size

tx_buffer

integer / required

Transmit ring buffer size

tuning_network_sysctl_config

dictionary

Additional network-specific sysctl parameters. Keys are sysctl parameter names (e.g. net.ipv4.tcp_window_scaling, net.ipv4.tcp_timestamps, net.ipv4.ip_local_port_range). See defaults/main.yml for the full set of default parameters.

Default: {}

tuning_network_sysctl_file

string

Path to network sysctl configuration file

Default: "/etc/sysctl.d/99-network-tuning.conf"

tuning_network_tuning_enabled

boolean

Enable network-specific tuning

Choices:

  • false

  • true ← (default)

tuning_packages_list

list / elements=string

List of packages required for tuning (auto-detected based on OS family)

Default: []

tuning_security_limits

list / elements=dictionary

List of security limit configurations

Default: []

domain

string / required

User or group domain (e.g., ‘*’, ‘@group’, ‘user’)

item

string / required

Resource item (e.g., nofile, nproc, memlock)

type

string / required

Limit type (soft or hard)

Choices:

  • "soft"

  • "hard"

value

integer / required

Limit value

tuning_swap_file_enabled

boolean

Enable swap file creation

Choices:

  • false ← (default)

  • true

tuning_swap_file_path

string

Path to swap file

Default: "/swapfile"

tuning_swap_file_size_mb

integer

Swap file size in megabytes

Default: 2048

tuning_swap_swappiness

integer

Swappiness value (0-100, lower = less swap usage)

Default: 10

tuning_sysctl_config

dictionary

Dictionary of sysctl parameters for performance tuning. Keys are sysctl parameter names (e.g. vm.dirty_ratio, net.core.rmem_max, fs.file-max, kernel.pid_max). Values are the desired settings. See defaults/main.yml for the full set of default parameters.

Default: {}

tuning_sysctl_file

string

Path to sysctl configuration file

Default: "/etc/sysctl.d/99-tuning.conf"

tuning_transparent_hugepages

string

Transparent Huge Pages configuration

Choices:

  • "always"

  • "madvise" ← (default)

  • "never"

tuning_tuned_profile

string

Tuned profile to apply

Default: "balanced"

tuning_validate_settings

boolean

Validate settings before applying

Choices:

  • false

  • true ← (default)