renovate/lib/modules/datasource/docker
Marcel Boehm 2f8ff83eab
feat(manager/flux): Allow OCI media type used by `flux push artifact` to enable Release Notes lookup (#32783)
2024-11-28 17:13:54 +00:00
..
common.spec.ts fix(datasource/docker): map `registry-1.docker.io` to `index.docker.io` (#26585) 2024-01-10 20:50:24 +00:00
common.ts chore(deps): update linters to v7.3.0 (#28005) 2024-03-18 20:39:19 +00:00
dockerhub-cache.spec.ts chore: eslint to enforce for typed imports (#30844) 2024-08-19 13:15:27 +00:00
dockerhub-cache.ts feat(docker): Reconcile deleted releases in cache (#30491) 2024-08-06 08:00:50 +00:00
ecr.ts chore: eslint to enforce for typed imports (#30844) 2024-08-19 13:15:27 +00:00
google.ts refactor(prettier): Force trailing commas (#25631) 2023-11-07 15:50:29 +00:00
index.spec.ts build(deps): update aws-sdk-js-v3 monorepo (#32262) 2024-11-12 07:17:38 +00:00
index.ts feat(self-hosted): convert experimental vars to config options (#29137) 2024-08-19 15:45:49 +00:00
readme.md docs(docker): mention required version for Harbor proxy cache feature (#20322) 2023-02-14 06:26:20 +01:00
schema.spec.ts feat(manager/flux): Allow OCI media type used by `flux push artifact` to enable Release Notes lookup (#32783) 2024-11-28 17:13:54 +00:00
schema.ts feat(manager/flux): Allow OCI media type used by `flux push artifact` to enable Release Notes lookup (#32783) 2024-11-28 17:13:54 +00:00
types.ts feat(docker): use Docker Hub tags api (#23876) 2023-08-15 13:21:17 +00:00

readme.md

This datasource identifies an image's source repository according to the pre-defined annotation keys of the OCI Image Format Specification.

This datasource looks for the metadata of the latest stable image found on the Docker registry and uses the value of the label org.opencontainers.image.source and org.label-schema.vcs-url as the sourceUrl. Additionally, it uses the value of the label org.opencontainers.image.revision as the gitRef.

The Label Schema is superseded by OCI annotations, use the org.opencontainers.image.source label if possible.

If you maintain a Docker image and want Renovate to find your changelogs, add a org.opencontainers.image.source field to your Dockerfile. The link must point to your GitHub or GitLab repository. Here's an example from our renovate/renovate Dockerfile:

LABEL org.opencontainers.image.source="https://github.com/renovatebot/renovate"

If you use Harbor as a proxy cache for Docker Hub, then you must use Harbor version 2.5.0 or higher.