Ansible Collection: arillso.system

Description

This Ansible collection provides comprehensive system configuration and management capabilities for Linux servers. It includes unified roles for access control, package management, network configuration, firewall setup, logging, and system tuning.

Roles

Core System Roles

• access - User/group/SSH/sudo management
• ansible - Ansible automation with systemd timer
• facts - Extended system facts (cloud, container, security)
• packages - Package management with APT, DNF, unattended upgrades
• python - Python and pip management
• ready - System readiness checks
• shell - Shell environment and MOTD configuration

Infrastructure Roles

• firewall - NFTables firewall configuration
• logging - Log management (rsyslog, logrotate)
• network - Network configuration (netplan, resolv)
• systemd - Systemd service/unit/journald management

Advanced Roles

• bitwarden_secrets - Bitwarden CLI secret management
• thermal - CPU thermal management
• tuning - System performance tuning (CPU, IO, network, swap)

Plugins

Lookup Plugins

• environment_files - Curate file lists based on patterns
• github_latest_release - Fetch latest GitHub release version

Modules

• apt_update_info - Retrieve list of updatable APT packages
• reboot_info - Check if system requires reboot

Filter Plugins

• from_toml - Convert TOML string to dictionary
• to_toml - Convert dictionary to TOML string
• to_nice_toml - Convert dictionary to nicely formatted TOML
• to_nftables_hierarchy - Generate nftables rule hierarchy
• to_nftables_rule - Generate nftables rule
• to_nftables_ports - Generate nftables port rules

Installation

Install this collection from Ansible Galaxy:

ansible-galaxy collection install arillso.system

Or add it to your requirements.yml:

---
collections:
    - name: arillso.system
      version: ">=1.0.0"

Requirements

• Ansible >= 2.16
• Python >= 3.11

Dependencies

• ansible.posix >= 2.0.0
• community.general >= 9.0.0
• community.crypto >= 2.0.0

Documentation

Full documentation is available at: https://guide.arillso.io/collections/arillso/system/

Breaking Changes in 1.0.0:

Version 1.0.0 introduces a major restructuring. Many roles have been removed and consolidated. See CHANGELOG.md for migration guidance.

License

This project is under the MIT License. See the LICENSE file for the full license text.

Copyright

(c) 2024-2026, Arillso