ilia/ansible
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
ansible/roles/maintenance
History
ilia 4621ea4674 Add monitoring and backup roles, enhancing infrastructure management capabilities. Introduce Proxmox VM creation playbook for automated VM provisioning. Update Makefile with new commands for monitoring and backup tasks. Enhance README.md with detailed usage instructions for new features, including automated backups and system monitoring tools. Refactor existing roles for improved organization and clarity, ensuring compatibility across various systems.
2025-09-07 22:17:22 -04:00
..
defaults
Add monitoring and backup roles, enhancing infrastructure management capabilities. Introduce Proxmox VM creation playbook for automated VM provisioning. Update Makefile with new commands for monitoring and backup tasks. Enhance README.md with detailed usage instructions for new features, including automated backups and system monitoring tools. Refactor existing roles for improved organization and clarity, ensuring compatibility across various systems.
2025-09-07 22:17:22 -04:00
handlers
Add .gitignore file to exclude sensitive and temporary files. Update ansible.cfg to set default stdout callback and disable deprecation warnings. Modify hosts file to include a local group for localhost. Create local-playbook.yml for local development setup with pre-tasks and role execution. Enhance README.md with vault password setup instructions and debug output configuration. Update group_vars to include ansible_debug_output variable. Refactor roles to improve package installation checks and streamline Docker setup with GPG key management.
2025-08-29 13:58:06 +00:00
tasks
Add monitoring and backup roles, enhancing infrastructure management capabilities. Introduce Proxmox VM creation playbook for automated VM provisioning. Update Makefile with new commands for monitoring and backup tasks. Enhance README.md with detailed usage instructions for new features, including automated backups and system monitoring tools. Refactor existing roles for improved organization and clarity, ensuring compatibility across various systems.
2025-09-07 22:17:22 -04:00
tests
Refactor playbooks and roles to enhance task organization and improve package management. Update development and local playbooks to include descriptive names, streamline APT tasks, and ensure consistent use of Ansible modules. Modify group variables for timezone and update role metadata for clarity. Improve error handling and user feedback in various roles, including applications, base, and snap, by utilizing built-in Ansible modules and adding necessary checks.
2025-08-29 15:42:09 -04:00
vars
first commit
2025-08-27 02:28:58 +00:00
README.md
Update inventory and playbook configurations to reflect new host addresses and user settings. Modify the Makefile for improved maintenance task execution, including unified command options for maintenance operations. Enhance README.md with updated usage instructions for the maintenance system and clarify host group definitions. Adjust group_vars for maintenance settings, ensuring proper handling of reboot conditions and cache management.
2025-09-02 11:32:16 -04:00

README.md

Maintenance Role

Handles system maintenance tasks including package updates, cleanup, and conditional reboots.

Requirements

  • Debian/Ubuntu-based systems with apt package manager
  • sudo privileges for package management and system operations

Role Variables

Default Variables (defaults/main.yml)

# Package management
maintenance_update_cache: true          # Update apt cache before operations
maintenance_upgrade_packages: true      # Perform dist-upgrade
maintenance_autoremove: true            # Remove unused packages
maintenance_autoclean: true             # Clean apt cache

# Reboot handling
maintenance_check_reboot: true          # Check if reboot is required
maintenance_allow_reboot: true          # Allow automatic reboots

Host Variables

skip_reboot: true                       # Skip reboots for this host (optional)

Playbook Variables

maintenance_serial: "100%"              # Serial execution (e.g., "1" for one-at-a-time)
target_group: "all"                     # Target host group

Dependencies

None.

Example Playbook

Basic Usage

- hosts: servers
  become: true
  roles:
    - maintenance

With Custom Variables

- hosts: servers
  become: true
  vars:
    maintenance_allow_reboot: false     # Disable automatic reboots
  roles:
    - maintenance

Using the Dedicated Maintenance Playbook

# Run on all hosts
ansible-playbook maintenance-playbook.yml

# Run on specific group
ansible-playbook maintenance-playbook.yml -e "target_group=dev"

# Run with serial execution
ansible-playbook maintenance-playbook.yml -e "target_group=dev" -e "maintenance_serial=1"

# Dry-run
ansible-playbook maintenance-playbook.yml --check --diff

Using Makefile (Recommended)

# Basic usage
make maintenance                    # All hosts
make maintenance GROUP=dev         # Specific group
make maintenance HOST=dev01        # Specific host
make maintenance CHECK=true        # Dry-run

# Advanced options
make maintenance GROUP=dev SERIAL=1 # Serial execution
make maintenance GROUP=local       # Local machine (auto-sudo)

Tasks Performed

  1. Package Updates: Performs apt dist-upgrade to update all packages
  2. Cleanup: Removes unused packages (apt autoremove) and cleans cache (apt autoclean)
  3. Reboot Check: Checks if /var/run/reboot-required exists
  4. Conditional Reboot: Reboots system if required (unless skip_reboot=true)

Reboot Behavior

The role respects the following reboot conditions:

  • Only reboots if /var/run/reboot-required exists
  • Only on apt-based systems (ansible_facts['pkg_mgr'] == "apt")
  • Skips reboot if skip_reboot is set to true in host variables
  • Provides informative reboot message

Integration with Maintenance Playbook

This role is designed to work with the dedicated maintenance-playbook.yml which provides:

  • Flexible host targeting
  • Serial execution support
  • Detailed progress reporting
  • System information display
  • Intelligent sudo handling

License

BSD

Author Information

Part of the Ansible Development Environment Setup project.