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_override

string

Override automatic I/O scheduler detection

tuning_network_sysctl_config

dictionary

Additional network-specific sysctl 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_security_limits

list / elements=dictionary

List of security limit configurations. Each entry requires: domain, type, item, value.

Default: []

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. Includes VM, network, filesystem, and kernel tuning.

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)