From b6b5997b6c4fd9e830a8474a0bbab651ed415e72 Mon Sep 17 00:00:00 2001
From: Axel Navarro <navarroaxel@gmail.com>
Date: Tue, 8 Sep 2020 13:19:52 -0300
Subject: [PATCH] docker-ps: add page (#4306)

---
 pages/common/docker-ps.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 pages/common/docker-ps.md

diff --git a/pages/common/docker-ps.md b/pages/common/docker-ps.md
new file mode 100644
index 0000000000..9e629e1f9d
--- /dev/null
+++ b/pages/common/docker-ps.md
@@ -0,0 +1,36 @@
+# docker ps
+
+> List Docker containers.
+> More information: <https://docs.docker.com/engine/reference/commandline/ps/>.
+
+- List currently running docker containers:
+
+`docker ps`
+
+- List all docker containers (running and stopped):
+
+`docker ps --all`
+
+- Show the latest created container (includes all states):
+
+`docker ps --latest`
+
+- Filter containers that contain a substring in their name:
+
+`docker ps --filter="name={{name}}"`
+
+- Filter containers that share a given image as an ancestor:
+
+`docker ps --filter "ancestor={{image}}:{{tag}}"`
+
+- Filter containers by exit status code:
+
+`docker ps --all --filter="exited={{code}}"`
+
+- Filter containers by status (created, running, removing, paused, exited and dead):
+
+`docker ps --filter="status={{status}}"`
+
+- Filter containers that mount a specific volume or have a volume mounted in a specific path:
+
+`docker ps --filter="volume={{path/to/directory}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"`