If you are familir with promotion hooks, you know that they are meant to take action or provude information for the release and environments when a promotion is intiated.

In this walkthrough we'll show you how to use hooks to handle promotion failures so that users or staeksholders get all the information they need in a timely manner without needing or having to monio the release.

Promotion hooks are designed to take action or provide information related to a release and its environments when a promotion is triggered.

In this walkthrough, you'll see how to use promotion hooks to handle promotion failures, ensuring that stakeholders are notified with the right information—without needing to monitor the release manually.

This walkthrough covers:

*[Creating Promotion Workflows with hooks](#create-promotion-workflows-with-hooks)

*[Assigning hooks in Promotion Flow](#assign-hooks-to-promotion-flow)

*[Triggering hooks in Promotion Flow](#result-of-triggering-hooks-1-and-2-work-in-the-promotion-flow)

This walkthgoh

1. Creating the hooks

1. Assignig hooks to a Promotion Flow

1. See result

|**Two-step DAG structure**| The hook uses a Directed Acyclic Graph (DAG) with two tasks: first`create-issue`, then`set-promotion-context`. The second task depends on the successful creation of the Jira issue.|

|**Jira issue creation**| The`create-issue` task uses a custom container to create a Jira ticket.|

|**Promotion context definition**| After creating the Jira issue, the`set-promotion-context` task creates a JSON object with the full Jira issue URL. This JSON is saved to`/tmp/promotion-context.txt` and exported as the`PROMOTION_CONTEXT` global output.|

|**Sharing information across hooks**| By exporting`PROMOTION_CONTEXT`, later hooks in the same Promotion Flow, have access to the Jira issuedetails.|

|**Sharing information across hooks**| By exporting`PROMOTION_CONTEXT`, later hooks in the same Promotion Flow, have access to the Jira issueURL.|

apiVersion:argoproj.io/v1alpha1

kind:WorkflowTemplate

valueFrom:

path:/tmp/promotion-context.txt