Skip to content

How to enable automerge with renovatebot

This guide show you how to enable automerge support with renovatebot. When automerge is enabled certain Merge Requests opened by renovatebot will be approved and merged automatically.

Choose your level of automerge

We have the following levels of automerge available as custom presets:

  • Gentle: use this level if you have low confidence in your CI/CD setup. Only the most uncontroversial changes such as digest pinning, lock file maintenance and patch-level updates will be automerged.
  • Moderate: use this level if you have moderate confidence in your CI/CD setup. In addition to the updates from the "gentle" level, minor version updates will also be automerged.

Automerge presets may change over time

DO NOT choose your level of automerge based on the exact types of Merge Requests covered by the presets. The exact types of Merge Requests which will be merged may change over time as we refine our automerge strategy. DO choose your level of automerge based on your confidence in your CI/CD setup.

Add the appropriate preset to the renovate configuration

For the "gentle" level, update renovate.json in the following manner:

{
  extends: [
    // ... other presets ...
    "local>uis/devops/renovate-config:automergeGentle"
  ]
}

For the "moderate" level, update renovate.json in the following manner:

{
  extends: [
    // ... other presets ...
    "local>uis/devops/renovate-config:automergeModerate"
  ]
}

Tip

You are not limited to our custom presets. You can use one of the built-in renovatebot presets or configure your exact automerge strategy using custom match rules.

Check that the configuration is working

After merging the change to the renovatebot configuration and waiting for renovatebot to open appropriate Merge Requests, you can check if automerge is working by searching for merged Merge Requests which were approved by uis-devops-triagebot.

Note

Triagebot currently will only approve automerge Merge Requests during the working day, Monday to Friday. This is to increase the chance that someone is available to revert the change if needed.

Summary

In this guide you learned how to enable automerge for your project.

Next steps