renovate/lib/modules/datasource/gitlab-releases
Sebastian Poxhofer 8e2df85268
feat(versioning)!: default to semver-coerced instead of semver (#20573)
BREAKING CHANGE: default versioning is now `semver-coerced`, instead of `semver`.
2023-03-10 09:34:41 +01:00
..
__snapshots__ test: use jest v29 (#17151) 2022-08-16 14:22:29 +02:00
index.spec.ts refactor(datasource): use packageName and not depName for datasource lookups (#20474) 2023-03-10 09:34:40 +01:00
index.ts fix(ci): Restrict template expressions (#16834) 2022-07-30 16:28:31 +02:00
readme.md feat(versioning)!: default to semver-coerced instead of semver (#20573) 2023-03-10 09:34:41 +01:00
types.ts refactor: lib/modules (#14488) 2022-03-04 09:04:02 +01:00

GitLab Releases API supports looking up releases supported by GitLab and can be used in combination with regex managers to keep dependencies up-to-date which are not specifically supported by Renovate.

To specify which specific repository should be queried when looking up a package, the packageName should be set to the project path.

As an example, gitlab-org/ci-cd/package-stage/feature-testing/new-packages-list would look for releases in the gitlab-org/ci-cd/package-stage/feature-testing/new-packages-list project.

To specify where to find a self-hosted GitLab instance, specify registryUrl. An example would be https://gitlab.company.com.

Please note the following requirements:

  • This datasource requires at least GitLab 11.7

Usage Example

A real-world example for this specific datasource would be maintaining package versions in a config file. This can be achieved by configuring a generic regex manager in renovate.json for files named versions.ini:

{
  "regexManagers": [
    {
      "fileMatch": ["^versions.ini$"],
      "matchStrings": [
        "# renovate: datasource=(?<datasource>.*?) depName=(?<depName>.*?)( versioning=(?<versioning>.*?))?( registryUrl=(?<registryUrl>.*?))?\\s.*?_VERSION=(?<currentValue>.*)\\s"
      ],
      "versioningTemplate": "{{#if versioning}}{{{versioning}}}{{else}}semver{{/if}}"
    }
  ]
}

Now you may use comments in your versions.ini files to automatically update dependencies, which could look like this:

# renovate: datasource=gitlab-releases depName=gitlab-org/ci-cd/package-stage/feature-testing/new-packages-list versioning=semver registryUrl=https://gitlab.com
NKJS_VERSION=3.4.0

By default, gitlab-releases uses the semver-coerced versioning scheme.