arillso.system.facts role – Collect system facts and metadata with K3s integration

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

Entry point main – Collect system facts and metadata with K3s integration

Synopsis

  • Enterprise-grade facts collection role that gathers system information, cloud metadata, and provides K3s cluster state detection.

Parameters

Parameter

Comments

facts_cache_cleanup_age_days

integer

Age threshold in days for cache file cleanup

Default: 7

facts_cache_cleanup_enabled

boolean

Enable automatic cleanup of old cache files

Choices:

  • false

  • true ← (default)

facts_cache_compression_enabled

boolean

Enable compression for cache files (requires gzip)

Choices:

  • false ← (default)

  • true

facts_cache_default_ttl

integer

Default cache TTL in seconds (5 minutes)

Default: 300

facts_cache_dir

string

Universal cache directory for all facts scripts

Default: "/var/cache/ansible-facts"

facts_cache_enabled

boolean

Universal cache enablement for all facts scripts

Choices:

  • false

  • true ← (default)

facts_cache_ttl_cloud

integer

Cache TTL for cloud metadata (1 hour)

Default: 3600

facts_cache_ttl_container

integer

Cache TTL for container facts (5 minutes)

Default: 300

facts_cache_ttl_network

integer

Cache TTL for network facts (30 minutes)

Default: 1800

facts_cache_ttl_security

integer

Cache TTL for security facts (5 minutes)

Default: 300

facts_cache_ttl_system

integer

Cache TTL for system facts (24 hours)

Default: 86400

facts_cloud_metadata_base_url

string

Base URL for cloud metadata services

Default: "http://169.254.169.254"

facts_cloud_providers_enabled

list / elements=string

List of cloud providers to detect and support

Default: ["aws", "digitalocean", "hetzner", "gcp", "generic"]

facts_collection_name

string

Full collection name for metadata tracking

Default: "arillso.system.facts"

facts_concurrent_execution

boolean

Enable parallel execution of facts scripts

Choices:

  • false ← (default)

  • true

facts_container_collect_health

boolean

Collect container runtime health metrics

Choices:

  • false

  • true ← (default)

facts_container_collect_inventory

boolean

Collect container inventory information

Choices:

  • false

  • true ← (default)

facts_container_collect_networks

boolean

Collect container network information

Choices:

  • false

  • true ← (default)

facts_container_collect_volumes

boolean

Collect container volume information

Choices:

  • false

  • true ← (default)

facts_container_detect_containerd

boolean

Enable containerd runtime detection

Choices:

  • false

  • true ← (default)

facts_container_detect_docker

boolean

Enable Docker runtime detection

Choices:

  • false

  • true ← (default)

facts_container_detect_kubernetes

boolean

Enable Kubernetes (K3s/K8s/MicroK8s) runtime detection

Choices:

  • false

  • true ← (default)

facts_container_detect_podman

boolean

Enable Podman runtime detection

Choices:

  • false

  • true ← (default)

facts_debug_enabled

boolean

Enable debug logging for facts collection

Choices:

  • false ← (default)

  • true

facts_enable_cloud_metadata

boolean

Enable cloud provider metadata collection

Choices:

  • false

  • true ← (default)

facts_enable_container_detection

boolean

Enable container runtime detection and facts collection

Choices:

  • false

  • true ← (default)

facts_enable_security_updates

boolean

Enable security update information collection

Choices:

  • false

  • true ← (default)

facts_enable_static_cache

boolean

Enable caching for static system information

Choices:

  • false

  • true ← (default)

facts_error_on_failure

boolean

Abort execution on script failures vs. continue

Choices:

  • false ← (default)

  • true

facts_logging_level

string

Logging level for facts scripts

Choices:

  • "debug"

  • "info" ← (default)

  • "warn"

  • "error"

facts_max_retries

integer

Maximum number of retries for network operations

Default: 1

facts_network_collect_dns

boolean

Collect DNS configuration information

Choices:

  • false

  • true ← (default)

facts_network_collect_firewall

boolean

Collect firewall configuration information

Choices:

  • false

  • true ← (default)

facts_network_collect_interfaces

boolean

Collect network interface information

Choices:

  • false

  • true ← (default)

facts_network_collect_routes

boolean

Collect network routing information

Choices:

  • false

  • true ← (default)

facts_node_type

string

Node type classification used in facts output

Choices:

  • "generic" ← (default)

  • "controller"

  • "agent"

  • "gateway"

  • "worker"

facts_playbook_name

string

Name of playbook executing the role for audit trail

Default: "facts"

facts_role_name

string

Internal role identifier for facts collection

Default: "facts"

facts_script_execution_timeout

integer

Maximum execution time per facts script in seconds

Default: 30

facts_security_check_method

string

Method for checking security updates

Choices:

  • "auto" ← (default)

  • "apt"

  • "yum"

  • "dnf"

  • "disabled"

facts_security_command_timeout

integer

Extended timeout for package manager security operations

Default: 15

facts_ssh_service_names

dictionary

SSH service names by OS family for handler operations

facts_system_collect_hardware

boolean

Collect hardware information in system facts

Choices:

  • false

  • true ← (default)

facts_system_collect_network

boolean

Collect network information in system facts

Choices:

  • false

  • true ← (default)

facts_system_collect_performance

boolean

Collect performance metrics in system facts

Choices:

  • false

  • true ← (default)

facts_system_collect_storage

boolean

Collect storage information in system facts

Choices:

  • false

  • true ← (default)

facts_system_collect_virtualization

boolean

Collect virtualization information in system facts

Choices:

  • false

  • true ← (default)

facts_system_owner

string

Team or individual responsible for system maintenance

Default: "ops-team"

facts_system_tags

list / elements=string

List of tags for system classification and metadata

Default: ["managed", "facts"]

facts_timeout_api

integer

Timeout in seconds for API calls

Default: 10

facts_timeout_default

integer

Default timeout in seconds for all operations

Default: 5

facts_version

string

Auto-detected collection version