Merge pull request #30660 from yongtang/02012017-man-container

Make markdown for man pages of `docker container ...` consistent
This commit is contained in:
Sebastiaan van Stijn 2017-02-01 23:15:12 -08:00 committed by GitHub
commit 1caba6c71e
5 changed files with 27 additions and 27 deletions

View file

@ -45,8 +45,8 @@ In this example the top command is run inside a container, from an image called
fedora, in detached mode. The ID from the container is passed into the **docker fedora, in detached mode. The ID from the container is passed into the **docker
attach** command: attach** command:
# ID=$(sudo docker run -d fedora /usr/bin/top -b) $ ID=$(sudo docker run -d fedora /usr/bin/top -b)
# sudo docker attach $ID $ sudo docker attach $ID
top - 02:05:52 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 top - 02:05:52 up 3:05, 0 users, load average: 0.01, 0.02, 0.05
Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie
Cpu(s): 0.1%us, 0.2%sy, 0.0%ni, 99.7%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st Cpu(s): 0.1%us, 0.2%sy, 0.0%ni, 99.7%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st

View file

@ -15,7 +15,7 @@ An existing Fedora based container has had Apache installed while running
in interactive mode with the bash shell. Apache is also running. To in interactive mode with the bash shell. Apache is also running. To
create a new image run `docker ps` to find the container's ID and then run: create a new image run `docker ps` to find the container's ID and then run:
# docker commit -m="Added Apache to Fedora base image" \ $ docker commit -m="Added Apache to Fedora base image" \
-a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20 -a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20
Note that only a-z0-9-_. are allowed when naming images from an Note that only a-z0-9-_. are allowed when naming images from an
@ -27,4 +27,4 @@ variable set to "true", you can create a new image based on that
container by first getting the container's ID with `docker ps` and container by first getting the container's ID with `docker ps` and
then running: then running:
# docker container commit -c="ENV DEBUG true" 98bd7fc99854 debug-image $ docker container commit -c="ENV DEBUG true" 98bd7fc99854 debug-image

View file

@ -8,11 +8,11 @@ Stream to a file instead of STDOUT by using **-o**.
Export the contents of the container called angry_bell to a tar file Export the contents of the container called angry_bell to a tar file
called angry_bell.tar: called angry_bell.tar:
# docker export angry_bell > angry_bell.tar $ docker export angry_bell > angry_bell.tar
# docker export --output=angry_bell-latest.tar angry_bell $ docker export --output=angry_bell-latest.tar angry_bell
# ls -sh angry_bell.tar $ ls -sh angry_bell.tar
321M angry_bell.tar 321M angry_bell.tar
# ls -sh angry_bell-latest.tar $ ls -sh angry_bell-latest.tar
321M angry_bell-latest.tar 321M angry_bell-latest.tar
# See also # See also

View file

@ -35,61 +35,61 @@ Filter output based on these conditions:
.Mounts - Names of the volumes mounted in this container. .Mounts - Names of the volumes mounted in this container.
# EXAMPLES # EXAMPLES
# Display all containers, including non-running ## Display all containers, including non-running
# docker container ls -a $ docker container ls -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
a87ecb4f327c fedora:20 /bin/sh -c #(nop) MA 20 minutes ago Exit 0 desperate_brattain a87ecb4f327c fedora:20 /bin/sh -c #(nop) MA 20 minutes ago Exit 0 desperate_brattain
01946d9d34d8 vpavlin/rhel7:latest /bin/sh -c #(nop) MA 33 minutes ago Exit 0 thirsty_bell 01946d9d34d8 vpavlin/rhel7:latest /bin/sh -c #(nop) MA 33 minutes ago Exit 0 thirsty_bell
c1d3b0166030 acffc0358b9e /bin/sh -c yum -y up 2 weeks ago Exit 1 determined_torvalds c1d3b0166030 acffc0358b9e /bin/sh -c yum -y up 2 weeks ago Exit 1 determined_torvalds
41d50ecd2f57 fedora:20 /bin/sh -c #(nop) MA 2 weeks ago Exit 0 drunk_pike 41d50ecd2f57 fedora:20 /bin/sh -c #(nop) MA 2 weeks ago Exit 0 drunk_pike
# Display only IDs of all containers, including non-running ## Display only IDs of all containers, including non-running
# docker container ls -a -q $ docker container ls -a -q
a87ecb4f327c a87ecb4f327c
01946d9d34d8 01946d9d34d8
c1d3b0166030 c1d3b0166030
41d50ecd2f57 41d50ecd2f57
# Display only IDs of all containers that have the name `determined_torvalds` ## Display only IDs of all containers that have the name `determined_torvalds`
# docker container ls -a -q --filter=name=determined_torvalds $ docker container ls -a -q --filter=name=determined_torvalds
c1d3b0166030 c1d3b0166030
# Display containers with their commands ## Display containers with their commands
# docker container ls --format "{{.ID}}: {{.Command}}" $ docker container ls --format "{{.ID}}: {{.Command}}"
a87ecb4f327c: /bin/sh -c #(nop) MA a87ecb4f327c: /bin/sh -c #(nop) MA
01946d9d34d8: /bin/sh -c #(nop) MA 01946d9d34d8: /bin/sh -c #(nop) MA
c1d3b0166030: /bin/sh -c yum -y up c1d3b0166030: /bin/sh -c yum -y up
41d50ecd2f57: /bin/sh -c #(nop) MA 41d50ecd2f57: /bin/sh -c #(nop) MA
# Display containers with their labels in a table ## Display containers with their labels in a table
# docker container ls --format "table {{.ID}}\t{{.Labels}}" $ docker container ls --format "table {{.ID}}\t{{.Labels}}"
CONTAINER ID LABELS CONTAINER ID LABELS
a87ecb4f327c com.docker.swarm.node=ubuntu,com.docker.swarm.storage=ssd a87ecb4f327c com.docker.swarm.node=ubuntu,com.docker.swarm.storage=ssd
01946d9d34d8 01946d9d34d8
c1d3b0166030 com.docker.swarm.node=debian,com.docker.swarm.cpu=6 c1d3b0166030 com.docker.swarm.node=debian,com.docker.swarm.cpu=6
41d50ecd2f57 com.docker.swarm.node=fedora,com.docker.swarm.cpu=3,com.docker.swarm.storage=ssd 41d50ecd2f57 com.docker.swarm.node=fedora,com.docker.swarm.cpu=3,com.docker.swarm.storage=ssd
# Display containers with their node label in a table ## Display containers with their node label in a table
# docker container ls --format 'table {{.ID}}\t{{(.Label "com.docker.swarm.node")}}' $ docker container ls --format 'table {{.ID}}\t{{(.Label "com.docker.swarm.node")}}'
CONTAINER ID NODE CONTAINER ID NODE
a87ecb4f327c ubuntu a87ecb4f327c ubuntu
01946d9d34d8 01946d9d34d8
c1d3b0166030 debian c1d3b0166030 debian
41d50ecd2f57 fedora 41d50ecd2f57 fedora
# Display containers with `remote-volume` mounted ## Display containers with `remote-volume` mounted
$ docker container ls --filter volume=remote-volume --format "table {{.ID}}\t{{.Mounts}}" $ docker container ls --filter volume=remote-volume --format "table {{.ID}}\t{{.Mounts}}"
CONTAINER ID MOUNTS CONTAINER ID MOUNTS
9c3527ed70ce remote-volume 9c3527ed70ce remote-volume
# Display containers with a volume mounted in `/data` ## Display containers with a volume mounted in `/data`
$ docker container ls --filter volume=/data --format "table {{.ID}}\t{{.Mounts}}" $ docker container ls --filter volume=/data --format "table {{.ID}}\t{{.Mounts}}"
CONTAINER ID MOUNTS CONTAINER ID MOUNTS

View file

@ -2,25 +2,25 @@ List port mappings for the CONTAINER, or lookup the public-facing port that is N
# EXAMPLES # EXAMPLES
# docker ps $ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
b650456536c7 busybox:latest top 54 minutes ago Up 54 minutes 0.0.0.0:1234->9876/tcp, 0.0.0.0:4321->7890/tcp test b650456536c7 busybox:latest top 54 minutes ago Up 54 minutes 0.0.0.0:1234->9876/tcp, 0.0.0.0:4321->7890/tcp test
## Find out all the ports mapped ## Find out all the ports mapped
# docker container port test $ docker container port test
7890/tcp -> 0.0.0.0:4321 7890/tcp -> 0.0.0.0:4321
9876/tcp -> 0.0.0.0:1234 9876/tcp -> 0.0.0.0:1234
## Find out a specific mapping ## Find out a specific mapping
# docker container port test 7890/tcp $ docker container port test 7890/tcp
0.0.0.0:4321 0.0.0.0:4321
# docker container port test 7890 $ docker container port test 7890
0.0.0.0:4321 0.0.0.0:4321
## An example showing error for non-existent mapping ## An example showing error for non-existent mapping
# docker container port test 7890/udp $ docker container port test 7890/udp
2014/06/24 11:53:36 Error: No public port '7890/udp' published for test 2014/06/24 11:53:36 Error: No public port '7890/udp' published for test