Azure DevOps Keptn Integration

Integration of Keptn within your Azure DevOps pipelines.

This extension includes 4 tasks which can be used to integrate your pipeline with the Keptn capabilities.

• Prepare Keptn environment
• Send Keptn event
• Wait for Keptn event
• Add Keptn resource

Watch the following Keptn Community Webinar to see the extension in action:

The service endpoint

First of all you need to configure the Keptn endpoint as a service connection.

All you need to configure is the API endpoint and the token. Note that the api endpoint structure has changed from version 0.7 from keptn onwards.

Tip: The API Token can be found in the Keptn bridge behind the user icon in the upper right corner.

Prepare Keptn environment

This task is optional, but very usefull since it prepares a project, stage and service for you. It also puts these entities as variables on the pipeline for later use by the other tasks. Optionally you can also configure monitoring here and push an sli and slo file to Keptn.

When you flag the Create/Initalize flag, you will see following in the keptn bridge if the project did not yet exist.

It's not in the screenshot, but there is also a section where you could configure monitoring via Dynatrace or Prometheus and upload an sli and slo file. See https://keptn.sh/docs/0.7.x/quality_gates/ for more details on Service Level Indicators and Service Level Objectives.

Send Keptn event

The main task in this extension.

• By sending the configuration-changed cloud-event to Keptn, you can trigger Keptn to perform a deployment of an image.
• By sending the deployment-finished cloud-event to Keptn, you can trigger your load / performance tests to be executed.
• By sending the start-evaluation cloud-event to Keptn, you can trigger Lighthouse to perform automatic validation of your performance tests.

configuration-changed requires some extra parameters:

• image: the container image to be deployed

deployment-finished requires some extra parameters:

• deploymentURI: The public deploymentURI which will be used to execute the tests against
• testStrategy: The testing stategy which is used to perform the tests
• image: the container image to be deployed
• tag: The tag of the deployment

start-evaluation requires some extra parameters:

• startTime: format needs to be "yyyy-MM-ddTHH:mm:sszzz"
• endTime: format needs to be "yyyy-MM-ddTHH:mm:sszzz"
• timeframe: If you don't want to use start and end time you could for example provide "15m" as value to evaluate the previous 15 minutes.

All of the types supported here are sending labels to Keptn as well to provide extra context. The default labels are:

• buildId: $(Build.BuildNumber)
• definition: $(Release.DefinitionName)
• runby: $(Build.QueuedBy)
• environment : $(Environment.Name)
• pipeline : $(Release.ReleaseWebURL) There is an optional text-area field called Labels where you can add a list of key-value pairs (example 'key:value' use semicolon) separated by a new line. You are able to extend or overwrite the default labels this way.

Note: the start and end time for the evaluation probably will come via variables from a previous task running the load tests. If you enter it manually for some reason Azure DevOps changes the date format. Which is again not recognized by Keptn.

Wait for Keptn event

This task listens for some time for a specific Keptn event. Currently only evaluation-done is supported. It waits for a configurable amount of minutes. Prerequisite of this task is the Send Keptn Event task which puts the keptnContext as a variable on the pipeline. This task uses this variable to capture the result.

You can configure what should happen with the pipeline on a warning or fail from keptn. In this case it will give a warning whenever the lighthouse service did not indicate a 'pass'. So both warning as fail in Keptn will result in a 'succeeded with issues' here.

Add Keptn resource

Although you can add the SLI, SLO and Dynatrace config files via the Prepare Keptn Environment task, there might be cases where you need to push additional files to Keptn. I am thinking about JMeter scripts for example or other config that can be used by Keptn services. That's when you could use this additional task.

Release notes

• 0.1.4 First public version
• 0.1.5 Added SLI and SLO upload
• 0.1.14 Github tickets 16, 14, 2, 7, 17, 18, 8, 19, 10
• 0.1.15 Added support for the deployment-finished event
• 0.1.17 Github ticket 32: some changes to support keptn 0.7 and higher Updated README.md
• 1.0.0 Github ticket 6 beïng implementation of the configuration changed event Updated README.md
• 1.0.5 Github ticket 30: added support to upload dynatrace.conf file. Added support for timeframe in the StartEvaluation event. Available since Keptn 0.7.3. Updated README.md
• 1.1.0 Added support for custom labels Added separate task to upload resources to Keptn Updated README.md
• 1.1.1 Bugfix packages Add Keptn Resource task

Created by Bert Van der Heyden, RealDolmen - an Inetum company. Also available via the MarketPlace: https://marketplace.visualstudio.com/items?itemName=RealdolmenDevOps.keptn-integration

Want to know more about our offering regarding Dynatrace and Keptn? Please contact us: https://www.realdolmen.com/en/solution/digital-performance-management Looking for official support for this plugin? See: https://www.realdolmen.com/en/solution/cicd-pipeline-quality-gates