mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
a2b529ead2
--help and help are successful commands so output should not go to error.
QE teams have requested this change, also users doing docker help | less
or docker run --help | less would expect this to work.
Usage statement should only be printed when the user asks for it.
Errors should print error message and then suggest the docker COMMAND --help
command to see usage information.
The current behaviour causes the user to have to search for the error message
and sometimes scrolls right off the screen. For example a error on a
"docker run" command is very difficult to diagnose.
Finally erros should always exit with a non 0 exit code, if the user
makes a CLI error.
Docker-DCO-1.1-Signed-off-by: Dan Walsh <dwalsh@redhat.com> (github: rhatdan)
51 lines
1.5 KiB
Markdown
51 lines
1.5 KiB
Markdown
% DOCKER(1) Docker User Manuals
|
|
% Docker Community
|
|
% JUNE 2014
|
|
# NAME
|
|
docker-push - Push an image or a repository to the registry
|
|
|
|
# SYNOPSIS
|
|
**docker push**
|
|
[**--help**]
|
|
NAME[:TAG]
|
|
|
|
# DESCRIPTION
|
|
Push an image or a repository to a registry. The default registry is the Docker
|
|
Hub located at [hub.docker.com](https://hub.docker.com/). However the
|
|
image can be pushed to another, perhaps private, registry as demonstrated in
|
|
the example below.
|
|
|
|
# OPTIONS
|
|
**--help**
|
|
Print usage statement
|
|
|
|
# EXAMPLES
|
|
|
|
# Pushing a new image to a registry
|
|
|
|
First save the new image by finding the container ID (using **docker ps**)
|
|
and then committing it to a new image name:
|
|
|
|
# docker commit c16378f943fe rhel-httpd
|
|
|
|
Now push the image to the registry using the image ID. In this example
|
|
the registry is on host named registry-host and listening on port 5000.
|
|
Default Docker commands will push to the default `hub.docker.com`
|
|
registry. Instead, push to the local registry, which is on a host called
|
|
registry-host*. To do this, tag the image with the host name or IP
|
|
address, and the port of the registry:
|
|
|
|
# docker tag rhel-httpd registry-host:5000/myadmin/rhel-httpd
|
|
# docker push registry-host:5000/myadmin/rhel-httpd
|
|
|
|
Check that this worked by running:
|
|
|
|
# docker images
|
|
|
|
You should see both `rhel-httpd` and `registry-host:5000/myadmin/rhel-httpd`
|
|
listed.
|
|
|
|
# HISTORY
|
|
April 2014, Originally compiled by William Henry (whenry at redhat dot com)
|
|
based on docker.com source material and internal work.
|
|
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
|