mirror of
https://github.com/docker/docs.git
synced 2026-03-27 22:38:54 +07:00
c588fbe5ca
Regenerated the yaml files after fixing a bug in the generator script that caused some extended descriptions and examples to not be included. Also fixes the generated YAML to use the "long form" format, instead of the compact format (where newlines were encoded as `\n`). This makes the YAML more "human readable", and makes reviewing updates easier. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
74 lines
2.2 KiB
YAML
74 lines
2.2 KiB
YAML
command: docker push
|
|
short: Push an image or a repository to a registry
|
|
long: |-
|
|
Use `docker push` to share your images to the [Docker Hub](https://hub.docker.com)
|
|
registry or to a self-hosted one.
|
|
|
|
Refer to the [`docker tag`](tag.md) reference for more information about valid
|
|
image and tag names.
|
|
|
|
Killing the `docker push` process, for example by pressing `CTRL-c` while it is
|
|
running in a terminal, terminates the push operation.
|
|
|
|
Progress bars are shown during docker push, which show the uncompressed size.
|
|
The actual amount of data that's pushed will be compressed before sending, so
|
|
the uploaded size will not be reflected by the progress bar.
|
|
|
|
Registry credentials are managed by [docker login](login.md).
|
|
|
|
### Concurrent uploads
|
|
|
|
By default the Docker daemon will push five layers of an image at a time.
|
|
If you are on a low bandwidth connection this may cause timeout issues and you may want to lower
|
|
this via the `--max-concurrent-uploads` daemon option. See the
|
|
[daemon documentation](dockerd.md) for more details.
|
|
usage: docker push [OPTIONS] NAME[:TAG]
|
|
pname: docker
|
|
plink: docker.yaml
|
|
options:
|
|
- option: disable-content-trust
|
|
value_type: bool
|
|
default_value: "true"
|
|
description: Skip image signing
|
|
deprecated: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
examples: |-
|
|
### Push a new image to a registry
|
|
|
|
First save the new image by finding the container ID (using [`docker ps`](ps.md))
|
|
and then committing it to a new image name. Note that only `a-z0-9-_.` are
|
|
allowed when naming images:
|
|
|
|
```bash
|
|
$ 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`. To do
|
|
this, tag the image with the host name or IP address, and the port of the
|
|
registry:
|
|
|
|
```bash
|
|
$ docker tag rhel-httpd registry-host:5000/myadmin/rhel-httpd
|
|
|
|
$ docker push registry-host:5000/myadmin/rhel-httpd
|
|
```
|
|
|
|
Check that this worked by running:
|
|
|
|
```bash
|
|
$ docker images
|
|
```
|
|
|
|
You should see both `rhel-httpd` and `registry-host:5000/myadmin/rhel-httpd`
|
|
listed.
|
|
deprecated: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
|