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 managerFilePatterns value, please follow this link.

Supported datasources

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

Dependency types

This manager extracts the following depType values:

depType	Description
image	Docker image specified as a string
image-name	Docker image specified via the name property
service-image	Docker image used as a service
repository	A GitLab CI/CD component reference

Default config

{
  "managerFilePatterns": [
    "/\\.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 predefined GitLab CI variables like CI_REGISTRY or CI_SERVER_FQDN make sure to configure their value via registryAliases:

{
  "registryAliases": {
    "$CI_REGISTRY": "registry.example.com",
    "$CI_SERVER_FQDN": "gitlab.example.com",
    "$CI_SERVER_HOST": "gitlab.example.com"
  }
}