Failure Notification Example Via Slack

examples/failure-notification/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## v0.0.1 (2022.09.30)
+
+### failure notifications
+
+This Workflow Template is an example of parsing and sending a slack notification on failure of a worklow.

examples/failure-notification/versions/0.0.1/README.md

@@ -0,0 +1,13 @@
+# Failure Notification
+
+## Summary
+
+This Workflow Template is an example of parsing and sending a slack notification on failure of a worklow.
+
+## Templates
+
+1. [failure-notification](https://github.com/codefresh-io/argo-hub/blob/main/examples/failure-notification/versions/0.0.1/docs/failure-notification.md)
+
+## Security
+
+This Utilizizes the codefresh-sa service account that is available with the codefresh hybrid installation.  Also, the service account from the Slack Notification worklow.

examples/failure-notification/versions/0.0.1/docs/failure-notification.md

@@ -0,0 +1,90 @@
+# failure-notifications
+
+## Summary
+
+This Workflow template is an example on how to parse and send a slack notification upon fialure of a workflow.  
+
+## Template Breakdown
+
+### Workflow Spec
+
+To utilize failure notification you will need to set the `spec.onExit` field to a template.  This will run at the end of a workflow no matter the status.
+
+```yaml
+apiVersion: argoproj.io/v1alpha1
+kind: WorkflowTemplate
+metadata:
+  name: failure-notification-example
+spec:
+  onExit: failure-notification # invoke pipeline-hook template at end of the workflow
+```
+
+### Workflow Templates
+
+#### Parsing Template
+
+We need to parse the information from the variable `workflow.failures` and output them to smaller items to make it more manageable instead of a raw json.  We are extracting the failure message, the template name that failed, and the timestamp.
+
+```yaml
+# This Steps parses the information to be utlized in the slack notifcation.
+    - name: parse-info
+      serviceAccountName: codefresh-sa
+      script:
+        image: alpine
+        command: [sh]
+        source: |
+          apk add jq
+          echo {{workflow.failures}} | jq -r '.[].message' > /tmp/message.txt
+          echo {{workflow.failures}} | jq -r '.[].templateName' > /tmp/templateName.txt
+          echo {{workflow.failures}} | jq -r '.[].finishedAt' > /tmp/finishedAt.txt
+      outputs:
+        parameters:
+          - name: message
+            valueFrom:
+              path: /tmp/message.txt
+          - name: templateName
+            valueFrom:
+              path: /tmp/templateName.txt
+          - name: finishedAt
+            valueFrom:
+              path: /tmp/finishedAt.txt
+```
+
+#### Notification Template
+
+This template will run upon exit of the workflow.  To make sure this is a failure notification we utlize the `when` parameter as `when: "{{workflow.status}} != Succeeded"`.  This will make sure that only Errors / Failure will send the notification.
+
+This template first use the parsing template of the failure. Then utlize the `send-message` template from `argo-hub.slack.0.0.2`.
+
+```yaml
+# After the completion of the entrypoint template, the status of the
+    # workflow is made available in the global variable {{workflow.status}}.
+    # {{workflow.status}} will be one of: Succeeded, Failed, Error
+    # useing slack from https://codefresh.io/argohub/workflow-template/slack
+    - name: failure-notification
+      steps:
+        - - name: parse-failure-info
+            template: parse-info
+            when: "{{workflow.status}} != Succeeded"
+        - - name: slack-notification
+            templateRef:
+              name: argo-hub.slack.0.0.2
+              template: send-message
+            arguments:
+              parameters:
+                - name: SLACK_HOOK_URL
+                  value: <INSERT SLACK URL>
+                - name: SLACK_TEXT
+                  value: "Workflow {{workflow.name}} has {{workflow.status}}. The template {{steps.parse-failure-info.outputs.parameters.templateName}} had the error of {{steps.parse-failure-info.outputs.parameters.message}} at {{steps.parse-failure-info.outputs.parameters.finishedAt}}"
+            when: "{{workflow.status}} != Succeeded"
+```
+
+## Example
+
+Workflow Failed with Exit Code 1.
+
+![workflow failure](../../../assets/workflow.png)
+
+Slack notification that gets sent.
+
+![workflow failure](../../../assets/slack.png)

examples/failure-notification/versions/0.0.1/workflowTemplate.yaml

@@ -0,0 +1,58 @@
+apiVersion: argoproj.io/v1alpha1
+kind: WorkflowTemplate
+metadata:
+  name: failure-notification-example
+spec:
+  entrypoint: intentional-fail
+  onExit: failure-notification # invoke pipeline-hook template at end of the workflow
+  templates:
+    # primary workflow template
+    - name: intentional-fail
+      container:
+        image: alpine:latest
+        command: [sh, -c]
+        args: ["echo intentional failure; exit 1"]
+
+    # After the completion of the entrypoint template, the status of the
+    # workflow is made available in the global variable {{workflow.status}}.
+    # {{workflow.status}} will be one of: Succeeded, Failed, Error
+    # useing slack from https://codefresh.io/argohub/workflow-template/slack
+    - name: failure-notification
+      steps:
+        - - name: parse-failure-info
+            template: parse-info
+            when: "{{workflow.status}} != Succeeded"
+        - - name: slack-notification
+            templateRef:
+              name: argo-hub.slack.0.0.2
+              template: send-message
+            arguments:
+              parameters:
+                - name: SLACK_HOOK_URL
+                  value: <INSERT SLACK URL>
+                - name: SLACK_TEXT
+                  value: "Workflow {{workflow.name}} has {{workflow.status}}. The template {{steps.parse-failure-info.outputs.parameters.templateName}} had the error of {{steps.parse-failure-info.outputs.parameters.message}} at {{steps.parse-failure-info.outputs.parameters.finishedAt}}"
+            when: "{{workflow.status}} != Succeeded"
+
+    # This Steps parses the information to be utlized in the slack notifcation.
+    - name: parse-info
+      serviceAccountName: codefresh-sa
+      script:
+        image: alpine
+        command: [sh]
+        source: |
+          apk add jq
+          echo {{workflow.failures}} | jq -r '.[].message' > /tmp/message.txt
+          echo {{workflow.failures}} | jq -r '.[].templateName' > /tmp/templateName.txt
+          echo {{workflow.failures}} | jq -r '.[].finishedAt' > /tmp/finishedAt.txt
+      outputs:
+        parameters:
+          - name: message
+            valueFrom:
+              path: /tmp/message.txt
+          - name: templateName
+            valueFrom:
+              path: /tmp/templateName.txt
+          - name: finishedAt
+            valueFrom:
+              path: /tmp/finishedAt.txt