Skip to content

Pull all image aliases for id#8193

Merged
tiborvass merged 1 commit intomoby:masterfrom
jessfraz:8141-pull-all-image-aliases-for-id
Sep 25, 2014
Merged

Pull all image aliases for id#8193
tiborvass merged 1 commit intomoby:masterfrom
jessfraz:8141-pull-all-image-aliases-for-id

Conversation

@jessfraz
Copy link
Copy Markdown
Contributor

Pull all image aliases for id.
Closes #8141.

Docker-DCO-1.1-Signed-off-by: Jessica Frazelle jess@docker.com (github: jfrazelle)

@tiborvass
Copy link
Copy Markdown
Contributor

@jfrazelle can I haz test, please? :)

@jessfraz
Copy link
Copy Markdown
Contributor Author

ya I am thinking about the best way without waiting for a huge image to download

@jessfraz jessfraz force-pushed the 8141-pull-all-image-aliases-for-id branch 3 times, most recently from db2d75e to 3d0e55e Compare September 23, 2014 23:38
@jessfraz
Copy link
Copy Markdown
Contributor Author

ok @tiborvass test added

@SvenDowideit
Copy link
Copy Markdown
Contributor

I presume this needs docs updates?

@jessfraz jessfraz force-pushed the 8141-pull-all-image-aliases-for-id branch from 3d0e55e to b49d1fc Compare September 23, 2014 23:48
@jessfraz
Copy link
Copy Markdown
Contributor Author

@SvenDowideit added something, a bit unsure about wording

@jessfraz jessfraz force-pushed the 8141-pull-all-image-aliases-for-id branch from b49d1fc to 246e443 Compare September 23, 2014 23:51
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/my/jess's/

@tiborvass
Copy link
Copy Markdown
Contributor

@unclejack @LK4D4 if you guys have better ideas for the test. Do you think we should add a test relying on internet or should we not have a test for now?

@crosbymichael
Copy link
Copy Markdown
Contributor

I would rather skip the test than rely on network

@jessfraz jessfraz force-pushed the 8141-pull-all-image-aliases-for-id branch from 246e443 to 07e5b98 Compare September 24, 2014 00:31
@LK4D4
Copy link
Copy Markdown
Contributor

LK4D4 commented Sep 24, 2014

Actually I think our tests not work without network anyway now :/ Pull tests in particular test pull on central registry.

@tiborvass
Copy link
Copy Markdown
Contributor

Okay, then apologies @jfrazelle :S Maybe we should just put a FIXME to remind us to put a test.

@jessfraz
Copy link
Copy Markdown
Contributor Author

np! i will update

@jessfraz jessfraz force-pushed the 8141-pull-all-image-aliases-for-id branch from 07e5b98 to 718530a Compare September 24, 2014 17:34
@jessfraz
Copy link
Copy Markdown
Contributor Author

updated!

@thaJeztah
Copy link
Copy Markdown
Member

First of all, thanks for picking this up, Jessie, much appreciated!

I've got a couple of remarks/questions

  • By opening this issue, I introduced a new term; "alias". While I think this is okay, it may be confusing for Mac OS X users (an "alias" on OS X is similar to a "shortcut (Windows)" / "symlink (Linux)"). Probably have the doc maintainers give that a green light.
  • Does this PR also cover cases where docker pull is not explicitly called, ie when the pull is triggered from a Dockerfile FROM image:tag instruction? My concern here is that this would still leave the opportunity that "aliases" get "out of sync"
  • In a broader perspective; should a API pull produce the same result? If so, maybe this change should be moved to the API, so that tools like (for example) fig would keep aliased images in sync as well (and reduce the chance that images get out of sync)

(Note; I'm not a Go-programmer, I try to follow the code changes, but I may of course have interpreted them incorrectly :))

@jessfraz
Copy link
Copy Markdown
Contributor Author

  1. I think @SvenDowideit or one of the other docs maintainers will be able to say if "alias" is the right term
  2. Yes, pulling via a Dockerfile would also pull aliases, because the changes were made to the pull action, and not the command line specifically.
  3. Remote API pull would perform the same as well and pull all aliases.

@thaJeztah
Copy link
Copy Markdown
Member

Well, erm, then, let me summarise ....... Awesome!

Yup, that about covers it 😸

@vieux
Copy link
Copy Markdown
Contributor

vieux commented Sep 25, 2014

LGTM

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you just add the issue number ? #8141

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

added!

@jessfraz jessfraz force-pushed the 8141-pull-all-image-aliases-for-id branch from 718530a to 0f5ce35 Compare September 25, 2014 00:28
@SvenDowideit
Copy link
Copy Markdown
Contributor

I would love to ditch the repository:tag words in favour of alias in many cases, so +1 to that.

(and this PR/feature is exactly why - its just a label, not anything like git add to a repo.)

Doc LGTM - @jamtur01 @fredlf @ostezer

@jamtur01
Copy link
Copy Markdown
Contributor

Docs LGTM

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

will this debian:testing == debian:jessie always hold true? If not, I'd prefer an example that will always be true.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's not even true right now, let alone in the future...

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lol I can fix it
On Sep 25, 2014 8:38 AM, "Tianon Gravi" notifications@github.com wrote:

In docs/sources/reference/commandline/cli.md:

 $ sudo docker pull debian:testing
  • will pull only the image named debian:testing and any intermediate layers

  • it is based on. (Typically the empty scratch image, a MAINTAINER layer,

  • will pull the image named debian:testing, debian:jessie

That's not even true right now, let alone in the future...


Reply to this email directly or view it on GitHub
https://github.com/docker/docker/pull/8193/files#r18039420.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i don't know what a good example would be that wouldn't become obsolete at some point.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe "trusty" and "14.04"? It will become obsolete eventually, but won't
ever be incorrect.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah genius changing!!

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated

@jessfraz jessfraz force-pushed the 8141-pull-all-image-aliases-for-id branch from 0f5ce35 to 62d3245 Compare September 25, 2014 17:12
@fredlf
Copy link
Copy Markdown
Contributor

fredlf commented Sep 25, 2014

I'm fine with "alias". I tried, but I can't think of a better term. LGTM from docs.

Docker-DCO-1.1-Signed-off-by: Jessica Frazelle <jess@docker.com> (github: jfrazelle)
@jessfraz jessfraz force-pushed the 8141-pull-all-image-aliases-for-id branch from 62d3245 to 7d74be1 Compare September 25, 2014 18:48
@tiborvass
Copy link
Copy Markdown
Contributor

LGTM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docker pull image:tag should pull all "aliases"

10 participants