arillso.system.systemd role – Systemd management with multi-entry-point support

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.systemd.

Entry point journald – Journald configuration entry point

Synopsis

  • Entry point for configuring systemd-journald

  • Manage journal storage, retention and forwarding

Parameters

Parameter

Comments

systemd_journald_compress

boolean

Compress journal data

Choices:

  • false

  • true ← (default)

systemd_journald_forward_to_console

boolean

Forward journal to console

Choices:

  • false ← (default)

  • true

systemd_journald_forward_to_kmsg

boolean

Forward journal to kernel log buffer

Choices:

  • false ← (default)

  • true

systemd_journald_forward_to_syslog

boolean

Forward journal to syslog

Choices:

  • false

  • true ← (default)

systemd_journald_forward_to_wall

boolean

Forward journal to wall messages

Choices:

  • false

  • true ← (default)

systemd_journald_line_max

string

Maximum line length for journal entries

Default: "48K"

systemd_journald_max_file_sec

string

Maximum time to store entries in a single journal file

Default: "1month"

systemd_journald_max_level_console

string

Maximum log level to forward to console

Default: "warning"

systemd_journald_max_level_kmsg

string

Maximum log level to forward to kernel log

Default: "notice"

systemd_journald_max_level_store

string

Maximum log level to store in journal

Default: "info"

systemd_journald_max_level_syslog

string

Maximum log level to forward to syslog

Default: "info"

systemd_journald_max_level_wall

string

Maximum log level to forward to wall

Default: "emerg"

systemd_journald_max_retention_sec

string

Maximum retention time for journal entries

Default: "1month"

systemd_journald_rate_limit_burst

integer

Maximum burst of messages within rate limit interval

Default: 1000

systemd_journald_rate_limit_interval

string

Rate limiting interval for journal messages

Default: "30s"

systemd_journald_restart_on_change

boolean

Restart journald when configuration changes

Choices:

  • false

  • true ← (default)

systemd_journald_runtime_keep_free

string

Minimum free disk space for runtime journal

Default: ""

systemd_journald_runtime_max_file_size

string

Maximum size of individual runtime journal files

Default: ""

systemd_journald_runtime_max_files

integer

Maximum number of runtime journal files

Default: 100

systemd_journald_runtime_max_use

string

Maximum disk space for runtime journal

Default: ""

systemd_journald_seal

boolean

Enable Forward Secure Sealing for journal

Choices:

  • false

  • true ← (default)

systemd_journald_service_enabled

boolean

Enable journald service on boot

Choices:

  • false

  • true ← (default)

systemd_journald_service_state

string

State of the journald service

Choices:

  • "started" ← (default)

  • "stopped"

  • "restarted"

  • "reloaded"

systemd_journald_split_mode

string

Journal split mode

Default: "uid"

systemd_journald_storage

string

Journal storage mode

Choices:

  • "auto" ← (default)

  • "volatile"

  • "persistent"

  • "none"

systemd_journald_sync_interval_sec

string

Interval for syncing journal to disk

Default: "5m"

systemd_journald_system_keep_free

string

Minimum free disk space for system journal

Default: "500M"

systemd_journald_system_max_file_size

string

Maximum size of individual system journal files

Default: "10M"

systemd_journald_system_max_files

integer

Maximum number of system journal files

Default: 100

systemd_journald_system_max_use

string

Maximum disk space for system journal

Default: "1G"

Entry point main – Systemd management with multi-entry-point support

Synopsis

  • Manages systemd services, unit files and journald configuration

  • Supports granular control via entry points

Parameters

Parameter

Comments

systemd_backup_units

boolean

Create backups before modifying unit files

Choices:

  • false

  • true ← (default)

systemd_daemon_reload

boolean

Reload systemd daemon after unit file changes

Choices:

  • false ← (default)

  • true

systemd_debug_mode

boolean

Enable debug output for troubleshooting

Choices:

  • false ← (default)

  • true

systemd_journald_compress

boolean

Compress journal data

Choices:

  • false

  • true ← (default)

systemd_journald_enabled

boolean

Enable journald configuration entry point

Choices:

  • false

  • true ← (default)

systemd_journald_forward_to_console

boolean

Forward journal to console

Choices:

  • false ← (default)

  • true

systemd_journald_forward_to_kmsg

boolean

Forward journal to kernel log buffer

Choices:

  • false ← (default)

  • true

systemd_journald_forward_to_syslog

boolean

Forward journal to syslog

Choices:

  • false

  • true ← (default)

systemd_journald_forward_to_wall

boolean

Forward journal to wall messages

Choices:

  • false

  • true ← (default)

systemd_journald_line_max

string

Maximum line length for journal entries

Default: "48K"

systemd_journald_max_file_sec

string

Maximum time to store entries in a single journal file

Default: "1month"

systemd_journald_max_level_console

string

Maximum log level to forward to console

Default: "warning"

systemd_journald_max_level_kmsg

string

Maximum log level to forward to kernel log

Default: "notice"

systemd_journald_max_level_store

string

Maximum log level to store in journal

Default: "info"

systemd_journald_max_level_syslog

string

Maximum log level to forward to syslog

Default: "info"

systemd_journald_max_level_wall

string

Maximum log level to forward to wall

Default: "emerg"

systemd_journald_max_retention_sec

string

Maximum retention time for journal entries

Default: "1month"

systemd_journald_rate_limit_burst

integer

Maximum burst of messages within rate limit interval

Default: 1000

systemd_journald_rate_limit_interval

string

Rate limiting interval for journal messages

Default: "30s"

systemd_journald_restart_on_change

boolean

Restart journald when configuration changes

Choices:

  • false

  • true ← (default)

systemd_journald_runtime_keep_free

string

Minimum free disk space for runtime journal

Default: ""

systemd_journald_runtime_max_file_size

string

Maximum size of individual runtime journal files

Default: ""

systemd_journald_runtime_max_files

integer

Maximum number of runtime journal files

Default: 100

systemd_journald_runtime_max_use

string

Maximum disk space for runtime journal

Default: ""

systemd_journald_seal

boolean

Enable Forward Secure Sealing for journal

Choices:

  • false

  • true ← (default)

systemd_journald_service_enabled

boolean

Enable journald service on boot

Choices:

  • false

  • true ← (default)

systemd_journald_service_state

string

State of the journald service

Choices:

  • "started" ← (default)

  • "stopped"

  • "restarted"

  • "reloaded"

systemd_journald_split_mode

string

Journal split mode

Default: "uid"

systemd_journald_storage

string

Journal storage mode

Choices:

  • "auto" ← (default)

  • "volatile"

  • "persistent"

  • "none"

systemd_journald_sync_interval_sec

string

Interval for syncing journal to disk

Default: "5m"

systemd_journald_system_keep_free

string

Minimum free disk space for system journal

Default: "500M"

systemd_journald_system_max_file_size

string

Maximum size of individual system journal files

Default: "10M"

systemd_journald_system_max_files

integer

Maximum number of system journal files

Default: 100

systemd_journald_system_max_use

string

Maximum disk space for system journal

Default: "1G"

systemd_retry_count

integer

Number of retry attempts for tasks

Default: 3

systemd_retry_delay

integer

Delay in seconds between retry attempts

Default: 5

systemd_service_enabled

boolean

Enable service management entry point

Choices:

  • false

  • true ← (default)

systemd_services

list / elements=dictionary

List of systemd services to manage

Default: []

daemon_reload

boolean

Reload systemd daemon

Choices:

  • false

  • true

enabled

boolean

Enable service on boot

Choices:

  • false

  • true

masked

boolean

Mask service

Choices:

  • false

  • true

name

string / required

Service name

state

string

Service state

Choices:

  • "started"

  • "stopped"

  • "restarted"

  • "reloaded"

systemd_unit_dir_mode

string

Directory mode for the systemd unit destination path

Default: "0755"

systemd_unit_enabled

boolean

Enable unit file management entry point

Choices:

  • false

  • true ← (default)

systemd_unit_group

string

Group of systemd unit files

Default: "root"

systemd_unit_mode

string

File mode for systemd unit files

Default: "0644"

systemd_unit_owner

string

Owner of systemd unit files

Default: "root"

systemd_unit_path

string

Path for systemd unit files

Default: "/etc/systemd/system"

systemd_units

list / elements=dictionary

List of systemd unit files to manage

Default: []

content

string

Unit file content (raw text)

name

string / required

Unit file name

state

string

Unit state

Choices:

  • "present" ← (default)

  • "absent"

unit

dictionary

Unit file content (structured dict)

systemd_validate_units

boolean

Validate unit files before deploying

Choices:

  • false

  • true ← (default)

Entry point service – Service management entry point

Synopsis

  • Entry point for managing systemd services

  • Control service state and boot configuration

Parameters

Parameter

Comments

systemd_services

list / elements=dictionary / required

List of services to manage

daemon_reload

boolean

Reload systemd daemon

Choices:

  • false

  • true

enabled

boolean

Enable service on boot

Choices:

  • false

  • true

masked

boolean

Mask service

Choices:

  • false

  • true

name

string / required

Service name

state

string

Service state

Choices:

  • "started"

  • "stopped"

  • "restarted"

  • "reloaded"

Entry point unit – Unit file management entry point

Synopsis

  • Entry point for managing systemd unit files

  • Deploy and remove unit files

Parameters

Parameter

Comments

systemd_backup_units

boolean

Create backups before modifying unit files

Choices:

  • false

  • true ← (default)

systemd_unit_dir_mode

string

Directory mode for the systemd unit destination path

Default: "0755"

systemd_unit_group

string

Group of systemd unit files

Default: "root"

systemd_unit_mode

string

File mode for systemd unit files

Default: "0644"

systemd_unit_owner

string

Owner of systemd unit files

Default: "root"

systemd_unit_path

string

Path for systemd unit files

Default: "/etc/systemd/system"

systemd_units

list / elements=dictionary / required

List of unit files to manage

content

string

Unit file content (raw text)

name

string / required

Unit file name

state

string

Unit state

Choices:

  • "present" ← (default)

  • "absent"

unit

dictionary

Unit file content (structured dict)

systemd_validate_units

boolean

Validate unit files before deploying

Choices:

  • false

  • true ← (default)