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/notify@.service'
    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: 'change@me.com'
notify_toEmail: 'change@me.com'

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

• Temelio.ssmtp

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