1.docker ps introduction
The docker ps command is used to list container-related information
2.docker ps usage
docker ps [parameters]
[root@centos79 ~]# docker ps --help
Usage: docker ps [OPTIONS]
List containers
Aliases:
docker container ls, docker container list, docker container ps, docker ps
Options:
-a, --all Show all containers (default shows just running)
-f, --filter filter Filter output based on conditions provided
--format string Format output using a custom template:
'table': Print output in table format with column headers (default)
'table TEMPLATE': Print output in table format using the given Go template
'json': Print in JSON format
'TEMPLATE': Print output using the given Go template.
Refer to https://docs.docker.com/go/formatting/ for more information about
formatting output with templates
-n, --last int Show n last created containers (includes all states) (default -1)
-l, --latest Show the latest created container (includes all states)
--no-trunc Don't truncate output
-q, --quiet Only display container IDs
-s, --size Display total file sizes
[root@centos79 ~]#
3.Examples
3.1. Display running containers
Order:
docker ps
[root@centos79 ~]# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
d59b9e356f74 centos:centos7 "/bin/bash" 49 seconds ago Up 48 seconds condescending_margulis
8cd2c35ffd65 centos:centos7 "/bin/bash" 51 seconds ago Up 50 seconds nervous_mclean
5fffa9ab7380 centos:centos7 "/bin/bash" 52 seconds ago Up 51 seconds xenodochial_moore
800d0759315f centos:centos7 "/bin/bash" 53 seconds ago Up 53 seconds gracious_bohr
425747b4385b centos-nginx:1.0 "nginx -g 'daemon of…" 4 hours ago Up 34 minutes 0.0.0.0:80->80/tcp, :::80->80/tcp centos-nginx
4ad2db28832b logstash:7.11.1 "/usr/local/bin/dock…" 3 weeks ago Up 34 minutes 0.0.0.0:5045->5044/tcp, :::5045->5044/tcp, 0.0.0.0:9601->9600/tcp, :::9601->9600/tcp logstash-messages
eba7697b317c logstash:7.11.1 "/usr/local/bin/dock…" 3 weeks ago Up 34 minutes 0.0.0.0:5044->5044/tcp, :::5044->5044/tcp, 0.0.0.0:9600->9600/tcp, :::9600->9600/tcp logstash
d5dc67cd0596 kibana:7.11.1 "/bin/tini -- /usr/l…" 3 weeks ago Up 34 minutes 0.0.0.0:5601->5601/tcp, :::5601->5601/tcp kibana
85374b727101 elasticsearch:7.11.1 "/bin/tini -- /usr/l…" 3 weeks ago Up 34 minutes 0.0.0.0:9200->9200/tcp, :::9200->9200/tcp, 0.0.0.0:9300->9300/tcp, :::9300->9300/tcp es
[root@centos79 ~]#
3.2. Display all containers
Order:
docker ps -a
[root@centos79 ~]# docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
15792fdb6bdc hello-world "/hello" About a minute ago Exited (0) About a minute ago distracted_panini
4a8eb7af634f hello-world "/hello" About a minute ago Exited (0) About a minute ago pedantic_shaw
d59b9e356f74 centos:centos7 "/bin/bash" About a minute ago Up About a minute condescending_margulis
8cd2c35ffd65 centos:centos7 "/bin/bash" About a minute ago Up About a minute nervous_mclean
5fffa9ab7380 centos:centos7 "/bin/bash" About a minute ago Up About a minute xenodochial_moore
800d0759315f centos:centos7 "/bin/bash" About a minute ago Up About a minute gracious_bohr
8f86869d31a8 hello-world "/hello" 2 minutes ago Exited (0) 2 minutes ago busy_taussig
425747b4385b centos-nginx:1.0 "nginx -g 'daemon of…" 4 hours ago Up 34 minutes 0.0.0.0:80->80/tcp, :::80->80/tcp centos-nginx
4ad2db28832b logstash:7.11.1 "/usr/local/bin/dock…" 3 weeks ago Up 34 minutes 0.0.0.0:5045->5044/tcp, :::5045->5044/tcp, 0.0.0.0:9601->9600/tcp, :::9601->9600/tcp logstash-messages
eba7697b317c logstash:7.11.1 "/usr/local/bin/dock…" 3 weeks ago Up 34 minutes 0.0.0.0:5044->5044/tcp, :::5044->5044/tcp, 0.0.0.0:9600->9600/tcp, :::9600->9600/tcp logstash
d5dc67cd0596 kibana:7.11.1 "/bin/tini -- /usr/l…" 3 weeks ago Up 34 minutes 0.0.0.0:5601->5601/tcp, :::5601->5601/tcp kibana
85374b727101 elasticsearch:7.11.1 "/bin/tini -- /usr/l…" 3 weeks ago Up 34 minutes 0.0.0.0:9200->9200/tcp, :::9200->9200/tcp, 0.0.0.0:9300->9300/tcp, :::9300->9300/tcp es
[root@centos79 ~]#
3.3. Display the 4 recently created containers
Order:
docker ps -n 4
[root@centos79 ~]# docker ps -n 4
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
15792fdb6bdc hello-world "/hello" About a minute ago Exited (0) About a minute ago distracted_panini
4a8eb7af634f hello-world "/hello" About a minute ago Exited (0) About a minute ago pedantic_shaw
d59b9e356f74 centos:centos7 "/bin/bash" 2 minutes ago Up 2 minutes condescending_margulis
8cd2c35ffd65 centos:centos7 "/bin/bash" 2 minutes ago Up 2 minutes nervous_mclean
[root@centos79 ~]#
3.4. Running container ID
Order:
docker ps -q
[root@centos79 ~]# docker ps -q
d59b9e356f74
8cd2c35ffd65
5fffa9ab7380
800d0759315f
425747b4385b
4ad2db28832b
eba7697b317c
d5dc67cd0596
85374b727101
[root@centos79 ~]#
3.5. Display all container IDs
Order:
docker ps -qa
[root@centos79 ~]# docker ps -aq
15792fdb6bdc
4a8eb7af634f
d59b9e356f74
8cd2c35ffd65
5fffa9ab7380
800d0759315f
8f86869d31a8
425747b4385b
4ad2db28832b
eba7697b317c
d5dc67cd0596
85374b727101
[root@centos79 ~]#
3.6. Display the full form of the container ID
Order:
docker ps -aq --no-trunk
[root@centos79 ~]# docker ps -aq --no-trunc
15792fdb6bdca4e36adba5cf40ce35cfab2621dddd121da8d739b4fb39216a1e
4a8eb7af634f844a302a3a0559b873d8030e7f5fd613818150ee720cec3dded2
d59b9e356f7406f043f5ca071bda6c28240d4e32c0db851cc52ecccfbebc9016
8cd2c35ffd658c50ea2e1880bed7a73679b32fce2910cb7434f98ef461242a95
5fffa9ab7380cef48008f57acc41af14904edf2720bb140e15f0bd3efea6382e
800d0759315f6b3f89129824cb541d00e2491318b88bcc1bacbb2b1f8c6103c8
8f86869d31a8b3cdad8695d9437d5c1e017ab690283f1b3b96d3f20a2a58a0ca
425747b4385b2198f27d70a371dd586967cf105994acd0b9a3eaa2fecb4c7ad0
4ad2db28832b91d67042e3556a0f9bbe9df886782b837833cca6b42a554a5ff2
eba7697b317c0a8be4ccfe2fe825fa37e1d45ec862c6a816af96629734e74843
d5dc67cd0596859522fa0cdd7882e24a6d8466646459a81542875a4bc27767c7
85374b727101b988a20dc7ba0bc84a7d4429e144346bae5c23ec2ff7db11666a
[root@centos79 ~]#
3.7. Display container size
Order:
docker ps -s
[root@centos79 ~]# docker ps -s
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES SIZE
d59b9e356f74 centos:centos7 "/bin/bash" 5 minutes ago Up 5 minutes condescending_margulis 0B (virtual 204MB)
8cd2c35ffd65 centos:centos7 "/bin/bash" 5 minutes ago Up 5 minutes nervous_mclean 0B (virtual 204MB)
5fffa9ab7380 centos:centos7 "/bin/bash" 5 minutes ago Up 5 minutes xenodochial_moore 0B (virtual 204MB)
800d0759315f centos:centos7 "/bin/bash" 5 minutes ago Up 5 minutes gracious_bohr 0B (virtual 204MB)
425747b4385b centos-nginx:1.0 "nginx -g 'daemon of…" 4 hours ago Up 38 minutes 0.0.0.0:80->80/tcp, :::80->80/tcp centos-nginx 1.35kB (virtual 449MB)
4ad2db28832b logstash:7.11.1 "/usr/local/bin/dock…" 3 weeks ago Up 38 minutes 0.0.0.0:5045->5044/tcp, :::5045->5044/tcp, 0.0.0.0:9601->9600/tcp, :::9601->9600/tcp logstash-messages 5.3MB (virtual 969MB)
eba7697b317c logstash:7.11.1 "/usr/local/bin/dock…" 3 weeks ago Up 38 minutes 0.0.0.0:5044->5044/tcp, :::5044->5044/tcp, 0.0.0.0:9600->9600/tcp, :::9600->9600/tcp logstash 5.3MB (virtual 969MB)
d5dc67cd0596 kibana:7.11.1 "/bin/tini -- /usr/l…" 3 weeks ago Up 38 minutes 0.0.0.0:5601->5601/tcp, :::5601->5601/tcp kibana 259B (virtual 1.01GB)
85374b727101 elasticsearch:7.11.1 "/bin/tini -- /usr/l…" 3 weeks ago Up 38 minutes 0.0.0.0:9200->9200/tcp, :::9200->9200/tcp, 0.0.0.0:9300->9300/tcp, :::9300->9300/tcp es 3.78MB (virtual 823MB)
[root@centos79 ~]#
There is an additional column of SIZE in the returned result. SIZE has two values (E.g: 3.78MB (virtual 823MB) - the sample comes from the last line of the output). Among them, 3.78MB is the actual increased size of the container, and virtual 823MB is the virtual size of the entire container. size.
Calculation method of the virtual size of the entire container:
The virtual size of the entire container = the actual increased size of the container + the size of the container image
3.8. Filter containers by conditions
-->Find the container with id 800d
Order:
docker ps --filter id=800d
[root@centos79 ~]# docker ps --filter id=800d
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
800d0759315f centos:centos7 "/bin/bash" 12 minutes ago Up 12 minutes gracious_bohr
[root@centos79 ~]#
-->Find the container with id 800d or 5fff
Order:
docker ps --filter id=800d --filter id=5fff
Note: The relationship between the same conditions is an "or" relationship
[root@centos79 ~]# docker ps --filter id=800d --filter id=5fff
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
5fffa9ab7380 centos:centos7 "/bin/bash" 14 minutes ago Up 14 minutes xenodochial_moore
800d0759315f centos:centos7 "/bin/bash" 14 minutes ago Up 14 minutes gracious_bohr
[root@centos79 ~]#
-->Find the container with id 800d and name gracious_bohr
Order:
docker ps --filter id=800d --filter name=gracious_bohr
Note: The relationship between different conditions is an "AND" relationship
[root@centos79 ~]# docker ps --filter id=800d --filter name=gracious_bohr
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
800d0759315f centos:centos7 "/bin/bash" 15 minutes ago Up 15 minutes gracious_bohr
[root@centos79 ~]#
-->Fuzzy match container
Order:
docker ps --filter name=^/gracious.*
[root@centos79 ~]# docker ps --filter name=^/gracious.*
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
800d0759315f centos:centos7 "/bin/bash" 24 minutes ago Up 24 minutes gracious_bohr
[root@centos79 ~]#