computer-playbook/roles/systemd-notifier-email/README.md

44 lines
1.6 KiB
Markdown
Raw Normal View History

2023-12-03 11:24:17 +01:00
# systemd-notifier-email Ansible Role
2023-05-28 22:17:33 +02:00
Author: Kevin Veen-Birkenbach (kevin@veen.world)
## Description
2023-12-03 11:24:17 +01:00
This Ansible role installs the necessary components for sending email notifications through systemd when any service fails. It configures the `systemd-notifier-email` service and handles the setup of email parameters and templates.
2023-05-28 22:17:33 +02:00
Features include:
- Installation and configuration of an email sending service.
- Customizable email templates for service failure notifications.
2023-12-03 11:24:17 +01:00
This role is part of the `systemd-notifier` suite, which provides a comprehensive solution for service failure notifications in a systemd environment.
2023-05-28 22:17:33 +02:00
This role was created as part of a conversation with OpenAI's ChatGPT and can be found [here](https://chat.openai.com/share/96e4ca12-0888-41c0-9cfc-29c0180f0dba).
## Requirements
This role has the following requirements:
- Access to an SMTP server for sending email notifications.
- Availability of the `msmtp` package on the target system.
## Role Variables
The following variables can be customized in the role's `vars/main.yml` file:
- `systemd_notifier_email_folder`: The path to the folder where email-related scripts and configurations will be stored.
## Usage
2023-12-03 11:24:17 +01:00
To use this role, include it as a dependency in your playbook or role that requires email notifications. Ensure that the `systemd-notifier-email` role is correctly referenced and configured.
2023-05-28 22:17:33 +02:00
## License
This Ansible role is licensed under the AGPL v3 License. See the LICENSE file for the full license text.
## Contact Information
For any questions or feedback, please contact the author:
Author: Kevin Veen-Birkenbach
Email: kevin@veen.world