nextcloud / nextcloud/docker

Add opencontainer labels to Docker images

Open
#2,282 2 comments 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement image priority: low
Dominant language
Shell
Stars
7.4k
Forks
1.9k
PR merge metrics
No merged PRs in 30d

Description

It would be great if the Docker container images had opencontainers labels. I have seen this across multiple other containers and believe this is the standard for labeling images.

https://github.com/opencontainers/image-spec/blob/main/annotations.md

Adding labels such as org.opencontainers.image.version will provide a way to obtain the current version of the running docker image which can be useful in automating the process of checking for updates.

Doing a docker inspect on the current images shows no labels. Here is an example of the Jellyfin docker image with opencontainers labels:

"Labels": {
    "org.opencontainers.image.description": "The Free Software Media System",
    "org.opencontainers.image.documentation": "https://jellyfin.org/docs/",
    "org.opencontainers.image.source": "https://github.com/jellyfin/jellyfin",
    "org.opencontainers.image.title": "Jellyfin",
    "org.opencontainers.image.url": "https://jellyfin.org",
    "org.opencontainers.image.version": "10.9.8"
}

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the repository's Docker image build configuration and compare the available image metadata with the OCI annotations specification linked in the issue. Add appropriate opencontainers labels, including a version label that reflects the image version, and verify with docker inspect that the built images expose the labels.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker
Domain
devops
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.