ansible-role-systemd-notify
Install email notify for a systemd service.
Requirements
This role requires Ansible 2.4 or higher and platform requirements are listed in the metadata file.
Testing
This role use Molecule to run tests.
Local and Travis tests run tests on Docker by default. See molecule documentation to use other backend.
Currently, tests are done on:
- Debian Stretch
- Ubuntu Xenial
- Ubuntu Bionic
and use:
- Ansible 2.4.x
- Ansible 2.5.x
- Ansible 2.6.x
- Ansible 2.7.x
Running tests
Using Docker driver
$ tox
Role Variables
Default role variables
# Dependencies management
systemd_notify_use_ansible_galaxy_dependencies: True # Use role dependencies in meta
ssmtp_use_ansible_galaxy_dependencies: True
service_name_to_modify: 'sshd' #change it to modify systemd service you want alert on
notify_mail_config:
- src: "{{ role_path }}/templates/systemd.email.j2"
dest: '/usr/local/bin/systemd-email'
owner: 'root'
group: 'root'
mode: '0755'
notify_service_systemd:
- src: "{{ role_path }}/templates/notify.service.j2"
dest: '/etc/systemd/system/[email protected]'
owner: 'root'
group: 'root'
mode: '0644'
options:
Unit:
Description: 'status email for %i to user'
After: 'network.target'
Service:
Type: 'oneshot'
ExecStart: '/usr/local/bin/systemd-email {{ notify_toEmail }} %i'
User: 'nobody'
Group: 'systemd-journal'
notify_fromEmail: '[email protected]'
notify_toEmail: '[email protected]'
systemd_service_states:
- name: "{{ service_name_to_modify }}"
state: "started"
enabled: True
daemon_reload: True
systemd_notify_options:
- dest: "/etc/systemd/system/{{ service_name_to_modify }}.service"
insertafter: '^Description'
line: 'OnFailure=notify@%n'
state: 'present'
Dependencies
You can disable role dependencies using systemd_notify_use_ansible_galaxy_dependencies or ssmtp_use_ansible_galaxy_dependencies and setting False
Example Playbook
- hosts: servers
roles:
- { role: Temelio.systemd-notify }
License
MIT
Author Information
Lise Machetel (for Temelio company)
- https://temelio.com
- lise.machetel [at] temelio.com