podman-*: add page (#8785)

pages/common/podman-ps.md

@@ -0,0 +1,36 @@
+# podman ps
+
+> List Podman containers.
+> More information: <https://docs.podman.io/en/latest/markdown/podman-ps.1.html>.
+
+- List currently running podman containers:
+
+`podman ps`
+
+- List all podman containers (running and stopped):
+
+`podman ps --all`
+
+- Show the latest created container (includes all states):
+
+`podman ps --latest`
+
+- Filter containers that contain a substring in their name:
+
+`podman ps --filter="name={{name}}"`
+
+- Filter containers that share a given image as an ancestor:
+
+`podman ps --filter "ancestor={{image}}:{{tag}}"`
+
+- Filter containers by exit status code:
+
+`podman ps --all --filter="exited={{code}}"`
+
+- Filter containers by status (created, running, removing, paused, exited and dead):
+
+`podman ps --filter="status={{status}}"`
+
+- Filter containers that mount a specific volume or have a volume mounted in a specific path:
+
+`podman ps --filter="volume={{path/to/directory}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"`