Kevin Veen-Birkenbach 2569abc0be
Refactor systemctl services and timers
- Unified service templates into generic systemctl templates
- Introduced reusable filter plugins for script path handling
- Updated path variables and service/timer definitions
- Migrated roles (backup, cleanup, repair, etc.) to use systemctl role
- Added sys-daemon role for core systemd cleanup
- Simplified timer handling via sys-timer role

Note: This is a large refactor and some errors may still exist. Further testing and adjustments will be needed.
2025-08-18 21:22:16 +02:00
..

Certbot Reaper

Description

This Ansible role automates the detection, revocation and deletion of unused Let's Encrypt certificates. It leverages the certreap tool to identify certificates no longer referenced by any active NGINX configuration and removes them automatically.

Overview

  • Installs the certreap cleanup tool using the pkgmgr-install role
  • Deploys and configures a sys-ctl-cln-certs{{ SYS_SERVICE_SUFFIX }} systemd unit
  • (Optionally) Sets up a recurring cleanup via a systemd timer using the sys-timer role
  • Integrates with sys-ctl-alm-compose to send failure notifications
  • Ensures idempotent execution with a run_once_sys_ctl_cln_certs flag

Features

  • Certificate Cleanup Tool Installation
    Uses pkgmgr-install to install the certreap binary.

  • Systemd Service Configuration
    Deploys sys-ctl-cln-certs{{ SYS_SERVICE_SUFFIX }} and reloads/restarts it on changes.

  • Systemd Timer Scheduling
    Optionally wires in a timer via the sys-timer role, controlled by the on_calendar_cleanup_certs variable.

  • Smart Execution Logic
    Prevents multiple runs in one play by setting a run_once_sys_ctl_cln_certs fact.

  • Failure Notification
    Triggers sys-ctl-alm-compose.infinito@sys-ctl-cln-certs{{ SYS_SERVICE_SUFFIX }} on failure.

Further Resources