global_handlers: Introduce a global handlers role (#455)

---------

Co-authored-by: Thilo Solbrig <thilo.solbrig@aspicon.de>
Co-authored-by: Thorsten Bruhns <Rendanic@users.noreply.github.com>

Author: 3 people

changelogs/fragments/global_handlers.yml

@@ -0,0 +1,3 @@
+---
+minor_changes:
+  - "global_handlers: Introduce a global handlers role (oravirt#455)"

roles/global_handlers/.ansibledoctor.yml

@@ -0,0 +1,5 @@
+---
+logging:
+  level: warning
+template: readme
+force_overwrite: true

roles/global_handlers/README.md

@@ -0,0 +1,50 @@
+# global_handlers
+
+Collection of handlers includeable by other roles.
+
+Make them available to your role by including it into the
+dependency list in meta/main.yml of your role, for instance.
+
+## Table of content
+
+- [Requirements](#requirements)
+- [Default Variables](#default-variables)
+  - [restart_on_requirement](#restart_on_requirement)
+- [Dependencies](#dependencies)
+- [License](#license)
+- [Author](#author)
+
+---
+
+## Requirements
+
+- Minimum Ansible version: `2.14.0`
+
+## Default Variables
+
+### restart_on_requirement
+
+Controls if reboot handler actually reboots the host (true)
+or just displays a reboot advice (false)
+
+**_Type:_** bool<br />
+
+#### Default value
+
+```YAML
+restart_on_requirement: true
+```
+
+
+
+## Dependencies
+
+None.
+
+## License
+
+license (MIT)
+
+## Author
+
+[Thilo Solbrig]

roles/global_handlers/defaults/main.yml

@@ -0,0 +1,7 @@
+---
+# @var restart_on_requirement:description: >
+# Controls if reboot handler actually reboots the host (true)
+# or just displays a reboot advice (false)
+# @end
+# @var restart_on_requirement:type: bool
+restart_on_requirement: true

roles/global_handlers/handlers/main.yml

@@ -0,0 +1,24 @@
+---
+- name: Reboot concerning package updates
+  ansible.builtin.command:
+    "{%- if ansible_facts.os_family == 'RedHat' -%}
+      yum needs-restarting -r
+    {%- elif ansible_facts.os_family == 'Suse' -%}
+      zypper needs-rebooting
+    {%- endif -%}"
+  failed_when: false
+  register: _global_handlers_needs_restarting
+  changed_when: _global_handlers_needs_restarting.rc > 0
+  notify: restart server
+
+- name: "restart server block (on behalf of 'restart server')"
+  block:
+    - name: Reboot
+      when: restart_on_requirement
+      listen: restart server
+      ansible.builtin.reboot:
+    - name: Reboot recommendation
+      when: not restart_on_requirement
+      listen: restart server
+      ansible.builtin.debug:
+        msg: Please REBOOT {{ ansible_hostname }} for modifications to take effect.

roles/global_handlers/meta/main.yml

@@ -0,0 +1,31 @@
+---
+# @meta description: >
+# Collection of handlers includeable by other roles.
+#
+# Make them available to your role by including it into the
+# dependency list in meta/main.yml of your role, for instance.
+# @end
+# @meta author: [Thilo Solbrig]
+galaxy_info:
+  role_name: global_handlers
+  author: Thilo Solbrig
+  description: Collection of handlers includeable by other roles (e.g., via meta dependencies)
+  company: ASPICON GmbH
+  license: license (MIT)
+
+  min_ansible_version: 2.14.0
+
+  platforms:
+    - name: EL
+      versions:
+        - "6"
+        - "7"
+        - "8"
+        - "9"
+    - name: SLES
+      versions:
+        - "15"
+
+  galaxy_tags: []
+
+dependencies: []