Docker ps: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
No edit summary
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
=External=
* https://docs.docker.com/engine/reference/commandline/ps/
=Internal=
=Internal=


* [[Docker Client Operations#ps|Client Operations]]
* [[Docker_Client_Operations#Container_Lifecycle_Operations|Container Lifecycle Operations]]


=Overview=
=Overview=


List containers.
List running containers. The output contains:
* the container ID and name(s)
* the image the container was created from
* the command
* the container's status
* when long ago was created
* what ports it uses
 
=Options=
 
==-a, --all==
 
Lists all containers (stopped and running).
 
==-q, --quiet==
 
Only display the numeric container IDs.
 
==--no-trunc==
 
==-s==
 
Provide [[#Size|size]] and [[#Virtual_Size|virtual size]] information for a container.
 
====Size====
 
The size represents the amount of data, on disk, that is used for [[Docker_Concepts#Writable_Layer_Size|the writable layer]] of the container.
 
====Virtual Size====
 
The virtual size represents the amount of data used for the read-only image data used by the container '''plus''' the container's [[#Size|writable layer size]].
 
==--filter==
 
--filter "key1=value1" --filter "key2=value2" ...
 
Where the keys are:
 
* id
* name
* status: "created", "restarting", "running", "removing", "paused", "exited", "dead"
 
=Exited Containers=
 
docker ps --filter "status=exited"

Latest revision as of 02:50, 2 January 2021

External

Internal

Overview

List running containers. The output contains:

  • the container ID and name(s)
  • the image the container was created from
  • the command
  • the container's status
  • when long ago was created
  • what ports it uses

Options

-a, --all

Lists all containers (stopped and running).

-q, --quiet

Only display the numeric container IDs.

--no-trunc

-s

Provide size and virtual size information for a container.

Size

The size represents the amount of data, on disk, that is used for the writable layer of the container.

Virtual Size

The virtual size represents the amount of data used for the read-only image data used by the container plus the container's writable layer size.

--filter

--filter "key1=value1" --filter "key2=value2" ...

Where the keys are:

  • id
  • name
  • status: "created", "restarting", "running", "removing", "paused", "exited", "dead"

Exited Containers

docker ps --filter "status=exited"