docker / docker/cli

[Proposal] docker image is up-to-date command

Open
#1,975 6 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area/distribution
Dominant language
Go
Stars
6.1k
Forks
2.2k
Avg merge
1d 15h
Merged PRs (30d)
43

Description

Spinning this out of #538, one of the requests was to have return codes for docker pull such that a user could determine whether the image was already up-to-date (and nothing was done) or the image was outdated, and docker pull did work and updated the image.

I would argue that an end-user would want a successful return code in each of these instances (and that docker pull should return 0 in both cases), however the functionality is still useful to be able to determine if you have the latest image.

One suggestion:

If your goal is to "watch" for new image versions, you should use API to check for changes.

However, it would be much nicer if there were a command-line argument to be able to do this for me, eg docker isuptodate my/image:latest

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 existing docker pull command and the API path suggested for checking image changes. Define the command's behavior for an image that is already current versus one that has been updated; done means a CLI command can report whether the requested image is up to date.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, go
Domain
cli
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.