Files
computer-playbook/roles/sys-ctl-alm-email
Kevin Veen-Birkenbach 3da645f3b8 Mailu/MSMTP: split token mgmt, idempotent reload, safer guards
• Rename: 02_create-user.yml → 02_manage_user.yml; 03_create-token.yml → 03a_manage_user_token.yml + 03b_create_user_token.yml
• Only (re)run sys-svc-msmtp when no-reply token exists; set run_once_sys_svc_msmtp=true in 01_core
• Reset by setting run_once_sys_svc_msmtp=false after creating no-reply token; then include sys-svc-msmtp
• Harden when-guards (no '{{ }}' in when, safe .get lookups)
• Minor formatting and failed_when readability

Conversation: https://chatgpt.com/share/68ebd196-a264-800f-a215-3a89d0f96c79
2025-10-12 18:05:00 +02:00
..

Automated Email Alerts for Service Failures

Description

This role installs and configures the necessary components for sending email notifications via systemd when a service fails. It sets up the {{ system_service_id }} service and configures email parameters and templates using msmtp.

Overview

Optimized for secure and reliable service failure notifications, this role is an integral part of the overall sys-ctl-alm-compose suite. It ensures that, upon failure of a critical service, an email alert is sent automatically to enable prompt troubleshooting.

Purpose

The primary purpose of this role is to provide a comprehensive solution for automated email notifications in a systemd environment. By integrating with msmtp and customizable templates, it delivers clear and timely alerts about service failures, thereby enhancing system reliability.

Features

  • Service Installation & Configuration: Installs msmtp and configures the email sending service.
  • Customizable Templates: Supports tailoring email templates for service failure notifications.
  • Secure Notifications: Integrates with systemd to trigger email alerts when services fail.
  • Suite Integration: Part of the sys-ctl-alm-compose suite, offering a unified approach to service failure notifications.

Other Resources

This role was created as part of a conversation with OpenAI's ChatGPT and can be found here.