mirror of
https://github.com/renovatebot/renovate.git
synced 2025-01-15 09:06:25 +00:00
2d2e95c747
Co-authored-by: Renovate Bot <bot@renovateapp.com> Co-authored-by: Jamie Magee <jamie.magee@gmail.com> Co-authored-by: Jamie Magee <JamieMagee@users.noreply.github.com> |
||
|---|---|---|
| .. | ||
| __snapshots__ | ||
| cdnjs | ||
| clojure | ||
| crate | ||
| dart | ||
| docker | ||
| galaxy | ||
| git-refs | ||
| git-submodules | ||
| git-tags | ||
| github-releases | ||
| github-tags | ||
| gitlab-tags | ||
| go | ||
| gradle-version | ||
| helm | ||
| hex | ||
| jenkins-plugins | ||
| maven | ||
| npm | ||
| nuget | ||
| orb | ||
| packagist | ||
| pod | ||
| pypi | ||
| repology | ||
| ruby-version | ||
| rubygems | ||
| sbt-package | ||
| sbt-plugin | ||
| terraform-module | ||
| terraform-provider | ||
| cache.ts | ||
| common.ts | ||
| index.spec.ts | ||
| index.ts | ||
| metadata.spec.ts | ||
| metadata.ts | ||
| readme.md | ||
Datasources
Datasources are used in Renovate primarily to fetch released versions of packages.
getReleases
The minimum exported interface for a datasource is a function called getReleases that takes a lookup config as input.
The config contains:
lookupName: the package's full name including scope if present (e.g.@foo/bar)registryUrls: an array of registry Urls to try
getReleases should return an object containing:
releases: an array of strings of matched versions. This is the only mandatory field.deprecationMessage: a string description of the package's deprecation notice, if applicablesourceUrl: a HTTP URL pointing to the source code (e.g. on GitHub)homepage: a HTTP URL for the package's homepage. Ideally should be empty if the homepage and sourceUrl are the samechangelogUrl: a URL pointing to the package's Changelog (could be a markdown file, for example). If not present then Renovate will search thesourceUrlfor a changelog file.tags: an object mapping tag -> version, e.g.tags: { latest: '3.0.0' }. This is only used by thefollowTagsfunction.
getDigest
Datasources that support the concept of digests (e.g. docker digests and git commit hashes) also can export a getDigest function.
The getDigest function has two inputs:
config: the Renovate config for the package being updated, contains same fields asgetReleasesnewValue: the version or value to retrieve the digest for
The getDigest function returns a string output representing the digest value. If none is found then a return value of null should be returned.