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 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_PREFIXCI_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"
}
}
Open items¶
The below list of features and bugs were current when this page was generated on April 02, 2026.
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-includetogitlabcimanager #21446 - Gitlab CI trigger includes #12178