add role `notify_teams`

docs/source/roles/index.rst

@@ -8,6 +8,7 @@ Content
    :maxdepth: 1
 
    check_service_catalog
+   tag_rps_vms
    provision_docker_router
    provision_docker_proxy
    provision_docker_waf
@@ -15,7 +16,7 @@ Content
    provision_docker_httpbin
    probe_healthchecks
    probe_testurls
-   tag_rps_vms
+   notify_teams
 
 Legacy
 ------

docs/source/roles/notify_teams.rst

+Notify Teams Channel
+====================
+
+This role will send a notification to a Teams Channel.
+
+Usage
+-----
+
+.. code-block:: yaml
+
+   ---
+
+   - name: My Playbook
+     hosts: localhost
+     connection: local
+     vars:
+       notify_teams_webhook_url: "{{ lookup('env', 'TEAMS_WEBHOOK_URL') }}"
+     roles:
+       - role: ec.rps_nginx.notify_teams
+         vars:
+           env_name: 'my-env-name'
+           notify_teams_webhook_template: !unsafe |
+             This is a message from the {{ env_name }} environment.
+
+Inventory
+---------
+
+.. csv-table::
+   :header: "Key", "Description", "Default Value"
+   :widths: 20, 70, 10
+
+   "notify_teams_webhook_url", "URL to the Teams 'Incomming Webhook'", "N/A"
+   "notify_teams_webhook_template", "Jinja2 template to use to generate the webhook request body", "N/A"

roles/notify_teams/defaults/main.yml

+---
+
+notify_teams_webhook_url: ""
+notify_teams_webhook_template: ""

roles/notify_teams/tasks/main.yml

+---
+
+- name: Send notification
+  ansible.builtin.uri:
+    url: "{{ teams_webhook }}"
+    method: POST
+    headers:
+      Content-Type: "application/json"
+    body: "{{ lookup('template', notify_teams_webhook_template) }}"
+    body_format: json
+  register: result
+  retries: 5
+  delay: 3
+  until: result is not failed