# Azure DevOps Integration

https://api-docs.lumar.io/docs/protect/ci/ci-azure-devops-integration

[Marketplace](https://marketplace.visualstudio.com/items?itemName=deepcrawl.lumar-protect-tools) | [Github Repository](https://github.com/deepcrawl/automator-sdk/tree/master/azure-devops-extension)

## Introduction

In order to integrate Lumar Protect with Azure DevOps, you need to use our Lumar Protect Azure DevOps extension:

This extension can be installed through Azure DevOps extensions, and it can be found under the name "Lumar Protect Tools".

It has the following tasks:

## Run Lumar Protect Build Task (`run-lumar-protect-build-task`)

### How to run

- Install the extension from: https://marketplace.visualstudio.com/items?itemName=deepcrawl.lumar-protect-tools
- Generate an API key on: https://accounts.lumar.io/api-access
- Make sure you have the test suite created and the test suite id, if not create your test suite in: https://protect.lumar.io/
- Add the following task to your azure devops pipeline `yaml` file:

```yaml
- task: run-lumar-protect-build-task@1
  displayName: 'Lumar Protect'
  inputs:
    userKeyId: '{USER_KEY_ID}' (string - generate new api key on deepcrawl core app)
    userKeySecret: '{USER_KEY_SECRET}' (string - generate new api key on deepcrawl core app)
    testSuiteId: '{TEST_SUITE_ID}' (string - use your created test suite id)
    ciBuildId: '{CI_BUILD_ID}' (optional - string)
    startOnly: false (optional - boolean - use it if you want to skip polling)
```

:::caution

Unless `startOnly` is set to `true`, max polling time is set to 50 minutes. If the build takes longer than 50 minutes, it will automatically fail the pipeline.

:::

:::tip

For more information, please see: https://github.com/deepcrawl/automator-sdk/blob/master/azure-devops-extension/README.md.

:::