Guest24897
/
DockerCLI
mirror of https://github.com/docker/cli.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
DockerCLI/docs/reference/commandline
History
Sebastiaan van Stijn 9e620e990f
implement docker push -a/--all-tags 
The `docker push` command up until [v0.9.1](https://github.com/moby/moby/blob/v0.9.1/api/client.go#L998)
always pushed all tags of a given image, so `docker push foo/bar` would push (e.g.)
all of  `foo/bar:latest`, `foo:/bar:v1`, `foo/bar:v1.0.0`.

Pushing all tags of an image was not desirable in many case, so docker v0.10.0
enhanced `docker push` to optionally specify a tag to push (`docker push foo/bar:v1`)
(see https://github.com/moby/moby/issues/3411 and the pull request that implemented
this: https://github.com/moby/moby/pull/4948).

This behavior exists up until today, and is confusing, because unlike other commands,
`docker push` does not default to use the `:latest` tag when omitted, but instead
makes it push "all tags of the image"

For example, in the following situation;

```
docker images

REPOSITORY          TAG                        IMAGE ID            CREATED             SIZE
thajeztah/myimage   latest                     b534869c81f0        41 hours ago        1.22MB
```

Running `docker push thajeztah/myimage` seemingly does the expected behavior (it
pushes `thajeztah/myimage:latest` to Docker Hub), however, it does not so for the
reason expected (`:latest` being the default tag), but because `:latest` happens
to be the only tag present for the `thajeztah/myimage` image.

If another tag exists for the image:

```
docker images

REPOSITORY          TAG                        IMAGE ID            CREATED             SIZE
thajeztah/myimage   latest                     b534869c81f0        41 hours ago        1.22MB
thajeztah/myimage   v1.0.0                     b534869c81f0        41 hours ago        1.22MB
```

Running the same command (`docker push thajeztah/myimage`) will push _both_ images
to Docker Hub.

> Note that the behavior described above is currently not (clearly) documented;
> the `docker push` reference documentation (https://docs.docker.com/engine/reference/commandline/push/)
does not mention that omitting the tag will push all tags

This patch changes the default behavior, and if no tag is specified, `:latest` is
assumed. To push _all_ tags, a new flag (`-a` / `--all-tags`) is added, similar
to the flag that's present on `docker pull`.

With this change:

- `docker push myname/myimage` will be the equivalent of `docker push myname/myimage:latest`
- to push all images, the user needs to set a flag (`--all-tags`), so `docker push --all-tags myname/myimage:latest`

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
 		2020-01-28 16:21:06 +01:00
..
attach.md Note caveat with detaching using key sequence 2019-02-08 13:13:05 -08:00
build.md Fix typos 2019-02-07 13:23:13 +01:00
cli.md docs: document ssh multiplexing env 2020-01-09 10:25:12 -08:00
commit.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
container.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
container_prune.md Fix description of filter flag in prune commands 2018-01-02 19:40:23 +01:00
context_create.md add --from option to context create 2019-04-02 13:41:47 +01:00
context_export.md Fast Context Switch: commands 2019-01-10 22:25:43 +01:00
context_import.md Context Switch: documentation alignment 2019-01-21 09:24:12 +01:00
context_inspect.md Context Switch: documentation alignment 2019-01-21 09:24:12 +01:00
context_ls.md Fast Context Switch: commands 2019-01-10 22:25:43 +01:00
context_rm.md Fast Context Switch: commands 2019-01-10 22:25:43 +01:00
context_update.md add --from option to context create 2019-04-02 13:41:47 +01:00
context_use.md Context Switch: documentation alignment 2019-01-21 09:24:12 +01:00
cp.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
create.md cli: add a separate --domainname flag 2018-12-08 00:03:56 +11:00
diff.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
dockerd.md daemon: document --max-download-attempts option 2019-10-15 12:06:58 +02:00
events.md docs: add info for events backlog and scope 2019-07-11 14:18:39 +02:00
exec.md introduce `—workdir` option for docker exec 2017-12-06 17:24:01 +01:00
export.md Developer Certificate of Origin 2018-05-16 20:16:08 +08:00
history.md For docker/docker.github.io/issues/6987 2018-07-05 14:12:47 -07:00
image.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
image_prune.md Add examples of prune by label 2018-01-30 11:29:45 -08:00
images.md fix: add more details about multiple images filter 2018-12-05 12:04:06 +08:00
import.md LCOW: --platform on import (already in API) 2018-09-13 15:04:04 -07:00
index.md Context Switch: documentation alignment 2019-01-21 09:24:12 +01:00
info.md Rework `docker info` output to be more like `docker version` 2019-01-25 14:46:26 +00:00
inspect.md fix a number of minor typos 2017-10-31 15:21:51 +05:00
kill.md Update docker kill reference docs 2018-02-20 14:58:55 +01:00
load.md docker load: Typofix in examples 2018-04-16 16:39:54 +02:00
login.md Fix login documentation layout 2018-10-04 11:14:17 +02:00
logout.md Fix login documentation layout 2018-10-04 11:14:17 +02:00
logs.md Developer Certificate of Origin 2018-05-16 20:16:08 +08:00
manifest.md Fix some typos in manifest.md 2019-01-20 01:20:34 +08:00
network.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
network_connect.md Developer Certificate of Origin 2018-05-16 20:16:08 +08:00
network_create.md Change example networks 2020-01-06 13:39:02 +01:00
network_disconnect.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
network_inspect.md fix a number of minor typos 2017-10-31 15:21:51 +05:00
network_ls.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
network_prune.md Fix description of filter flag in prune commands 2018-01-02 19:40:23 +01:00
network_rm.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
node.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
node_demote.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
node_inspect.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
node_ls.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
node_promote.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
node_ps.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
node_rm.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
node_update.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
pause.md Fix phrasing when referring to the freezer cgroup 2019-08-18 13:55:20 +02:00
plugin.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
plugin_create.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
plugin_disable.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
plugin_enable.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
plugin_inspect.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
plugin_install.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
plugin_ls.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
plugin_push.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
plugin_rm.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
plugin_set.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
plugin_upgrade.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
port.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
ps.md Explain -s flag on docker ps 2019-08-06 16:27:05 +02:00
pull.md Add option to pull images quietly 2018-12-19 13:48:41 +01:00
push.md implement docker push -a/--all-tags 2020-01-28 16:21:06 +01:00
rename.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
restart.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
rm.md Update flag description for docker rm -v 2020-01-25 13:54:23 +01:00
rmi.md Improve `docker image rm` reference docs 2019-01-21 16:15:45 +01:00
run.md Add notice about port binding and overriding of UFW to docker run reference 2020-01-24 16:35:43 +01:00
save.md give `docker save` a gzip usage guide (#1678) 2019-03-21 14:49:21 -07:00
search.md Updating deprecated command example in search.md 2019-08-29 14:41:05 -03:00
secret.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
secret_create.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
secret_inspect.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
secret_ls.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
secret_rm.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
service.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
service_create.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
service_inspect.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
service_logs.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
service_ls.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
service_ps.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
service_rm.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
service_rollback.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
service_scale.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
service_update.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
stack.md Update command usage and documentation 2018-06-21 23:16:27 -07:00
stack_deploy.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
stack_ls.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
stack_ps.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
stack_rm.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
stack_services.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
start.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
stats.md Fix small typo 2019-01-30 11:00:38 -05:00
stop.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
swarm.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
swarm_ca.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
swarm_init.md Data Path Port configuration support 2018-11-28 10:55:42 -05:00
swarm_join.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
swarm_join_token.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
swarm_leave.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
swarm_unlock.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
swarm_unlock_key.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
swarm_update.md Docs: add note about management commands targeting a manager 2019-12-12 14:57:05 +01:00
system.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
system_df.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
system_events.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
system_prune.md For system prune, -f is not an alias for --filter 2017-10-20 10:51:28 -07:00
tag.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
top.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
trust_inspect.md [WIP] fix trust inspect typo 'AdminstrativeKeys' 2018-08-19 17:57:04 -07:00
trust_key_generate.md update doc 2018-03-13 16:50:56 -07:00
trust_key_load.md update doc 2018-03-13 16:50:56 -07:00
trust_revoke.md update doc 2018-03-13 16:50:56 -07:00
trust_sign.md update doc 2018-03-13 16:50:56 -07:00
trust_signer_add.md update doc 2018-03-13 16:50:56 -07:00
trust_signer_remove.md update doc 2018-03-13 16:50:56 -07:00
unpause.md Fix phrasing when referring to the freezer cgroup 2019-08-18 13:55:20 +02:00
update.md Add `--pids-limit` flag to `docker update` 2019-03-21 01:20:32 +01:00
version.md Remove shorthand `-k` option from `docker version` 2018-06-21 23:33:55 -07:00
volume.md Clarify description of volume prune command 2018-02-08 15:33:07 +09:00
volume_create.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
volume_inspect.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
volume_ls.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
volume_prune.md Clarify description of volume prune command 2018-02-08 15:33:07 +09:00
volume_rm.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00
wait.md Fix GitHub spelling 2017-10-05 01:14:31 +08:00