Skip to content

Automated Dependency Updates for GitLab CI/CD

Categories: ci

Renovate supports updating GitLab CI/CD dependencies.

File Matching

By default, Renovate will check any files matching the following regular expression: \.gitlab-ci\.ya?ml$.

For details on how to extend a manager's fileMatch value, please follow this link.

Supported datasources

This manager supports extracting the following datasources: docker, gitlab-tags.

Default config

{
  "fileMatch": [
    "\\.gitlab-ci\\.ya?ml$"
  ]
}

Additional Information

Extracts Docker dependencies from gitlab-ci.yml files.

If you need to change the versioning format, read the versioning documentation to learn more.

If you use Gitlab Dependency Proxy then you can use these predefined variables as prefixes for your image:

  • CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX
  • CI_DEPENDENCY_PROXY_DIRECT_GROUP_IMAGE_PREFIX

If you use the predefined CI_REGISTRY variable make sure to configure its value via registryAliases:

{
  "registryAliases": {
    "$CI_REGISTRY": "registry.example.com"
  }
}

Open items

The below list of features and bugs were current when this page was generated on December 21, 2024.

Feature requests

  • GitLab CI - include project ENV_VARIABLE support #33156
  • Feature request: Support for Gitlab include local wildcard #24359
  • gitlabci: support input parameter #22481
  • Merge gitlabci-include to gitlabci manager #21446
  • Gitlab CI trigger includes #12178

Bug reports

  • gitlabci should ignore !reference services #33057
  • Error updating gitlabci includes if pinDigests=true" #14177
  • gitlabci-include manager may fail if yml file is empty #12529
  • Docker references in gitlab-ci.yml split on multiple lines is not updated correctly #11595