# Azure DevOps deployment pipeline

The [Azure DevOps](https://azure.microsoft.com/en-gb/products/devops) deployment integration enables you to forward release and pipeline deployment events to ilert, creating a richer incident timeline that reflects code pushes, releases, and environment changes. Deployment pipelines organize your Azure DevOps events and connect them to alert sources – offering clear context that accelerates root cause analysis and supports change accountability.

## Setting up

### Creating your deployment pipeline in ilert

In any way, a pipeline is required, which will also generate a new `integrationKey` required to route deployment events when they occur. Head to your ilert account and navigate to **Alert sources -> Deployment events.**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FJhi8HVwtzjjtp1oWFAVm%2F1.png?alt=media&#x26;token=0c9293b5-ff7a-4245-b1c6-da414442d60b" alt=""><figcaption></figcaption></figure>

Head over to the deployment pipelines tab and click on **Create new pipeline.**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FbUw6fz59bXJzlyVkoOCQ%2F2.png?alt=media&#x26;token=d83ec0da-169d-4fba-81fd-e9c7bcad2318" alt=""><figcaption></figcaption></figure>

Provide a name for your pipeline.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FSnxfN6Rvxo40mem69Rqq%2Fdep-1.png?alt=media&#x26;token=d0984583-f4e1-4d7a-901a-e3e0235db0d3" alt=""><figcaption></figcaption></figure>

**Optional**: If you are going to manage branch-specific deployments, choose the branches in the branch filter section for which you would like to create deployment events in ilert.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FXmUUjkfKhI1g6nvZopfX%2F4.png?alt=media&#x26;token=176fa144-23d7-4571-93e8-a706ae28aecc" alt=""><figcaption></figcaption></figure>

In any way, by clicking on Create, you should end up on the detail view of your Azure DevOps deployment pipeline.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FBAUKEuYcFIS7ZXglNG3h%2Fdep-2.png?alt=media&#x26;token=a91406f4-cf1a-4d63-a8d0-94af56a7d180" alt=""><figcaption></figcaption></figure>

Providing you with a freshly generated `integrationKey` and copy & pastable **URL** ready for your webhook setup.

### Creating a service hook in Azure DevOps

In your Azure DevOps project, open **Project settings**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FyTN89Ah7juAc4TosQrPk%2F1.png?alt=media&#x26;token=97255f6b-8eb8-4a29-a3c3-e309094cd305" alt=""><figcaption></figcaption></figure>

In the sidebar, select **Service hooks** and click **Create subscription**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FQeMrJUNT2tMEp0pQFZKN%2F2.png?alt=media&#x26;token=701efe40-b52f-4df0-95fb-0a253de7f5ee" alt=""><figcaption></figcaption></figure>

Choose **Web Hooks** and click **Next**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FoXlIAvDUlTIqEmRhyoVS%2F3.png?alt=media&#x26;token=2b7d6d9e-2a27-466b-bc95-e35a10a81417" alt=""><figcaption></figcaption></figure>

Select the **Trigger** (for example, *Work item updated*, *Build completed*, *Code pushed*) and configure **Filters** to reduce noise.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FuyMI7L35jnk17F1F9y6d%2F4.png?alt=media&#x26;token=64681696-26dd-4df3-b319-d84be478ad3b" alt=""><figcaption></figcaption></figure>

In **URL**, paste the ilert **Integration URL** you created earlier.

Click **Finish** to save the subscription.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F1TsW5PXxEAtWl7Ujrr9Z%2Fdep-3.png?alt=media&#x26;token=7baaadfc-c8c0-4d07-b60b-f9d3ce2462d2" alt=""><figcaption></figcaption></figure>

You are now all set and should see deployment events coming into your ilert account.