docker ps¶

説明 ¶

コンテナを一覧表示します。

使い方 ¶

$ docker ps [OPTIONS]

コマンドの使用例は、以下の使用例のセクションをご覧ください。

オプション ¶

名前, 省略形	デフォルト	説明
`--all` , `-a`		全てのコンテナを表示（デフォルトは実行中のコンテナだけ表示）
`--filter` , `-f`		指定した状態に基づき、出力をフィルタ
`--format`		Go テンプレートを使ってコンテナの出力を成形
`--last` , `-n`	`-1`	直近に作成したコンテナを n 個表示（全ての状態を含む）
`--latest` , `-l`		最後に作成したコンテナを表示（全ての状態を含む）
`--no-trunc`		表示を省略しない(truncate)
`--quiet` , `-q`		コンテナ ID のみ表示
`--size` , `-s`		合計ファイル容量を表示

使用例 ¶

出力を省略しない ¶

docker ps --no-trunc を実行すると、リンクされた２つのコンテナを表示します。

$ docker ps
CONTAINER ID        IMAGE                        COMMAND                CREATED              STATUS              PORTS               NAMES
4c01db0b339c        ubuntu:12.04                 bash                   17 seconds ago       Up 16 seconds       3300-3310/tcp       webapp
d7886598dbe2        crosbymichael/redis:latest   /redis-server --dir    33 minutes ago       Up 33 minutes       6379/tcp            redis,webapp/db

実行中・停止中、両方のコンテナを表示 ¶

デフォルトの docker ps は、実行中のコンテナだけ表示します。全てのコンテナを表示するには -a （または --all ）フラグを使います。

$ docker ps -a

docker ps は、可能であれば公開ポートのグループを範囲で表示します。例えば、コンテナが 100、101、102 を公開している場合、 PORT 列に 100-102/tcp と表示します。

コンテナによるディスク使用量を表示 ¶

docker ps -s コマンドは、各コンテナに対し、2つの異なるディスク上の容量を表示します。

$ docker ps -s
CONTAINER ID   IMAGE          COMMAND                  CREATED        STATUS       PORTS   NAMES        SIZE                                                                                      SIZE
e90b8831a4b8   nginx          "/bin/bash -c 'mkdir "   11 weeks ago   Up 4 hours           my_nginx     35.58 kB (virtual 109.2 MB)
00c6131c5e30   telegraf:1.5   "/entrypoint.sh"         11 weeks ago   Up 11 weeks          my_telegraf  0 B (virtual 209.5 MB)

「size」情報は、（ディスク上の）データ容量を表示します。これは、各コンテナの「書き込み可能な」レイヤが使用している容量です。
「virtual size」は、コンテナと書き込み可能なレイヤが使用している、読み込み専用の「イメージ」データの合計ディスク使用量です。

詳しい情報は、ディスク上のコンテナ容量をご覧ください。

フィルタリング ¶

フィルタリング・フラグ（ -f と --filter ）の形式は key=value の組です。複数のフィルタを指定するには、複数のフラグを使います（例： --filter "foo=bar" --filter "bif=baz" ）。

現在、以下のフィルタをサポートします。

フィルタ	説明
`id`	コンテナの ID
`name`	コンテナの名前
`label`	キーまたはキーバリューの組み合わせで表す任意の文字。 `<key>` または `<key>=<value>` で表す
`exited`	コンテナの終了コードを表す整数値。実用的なのは `--all` のみ
`status`	`created` 、 `restarting` 、 `running` 、 `removing` 、 `paused` 、 `exited` 、 `dead` のどれか
`ansestor`	指定したイメージを原型(ancestor) として共有するコンテナをフィルタ。 `<image-name>[:<tag>]` 、 `<image id>` 、 `<image@digest>` として表す。
`before` か `since`	指定したコンテナ ID かコンテナ名で、コンテナが作成前か作成後でフィルタ
`volume`	実行中のコンテナがマウントしているボリューム、または、バインドマウントでフィルタ
`network`	実行中のコンテナが接続しているネットワークでフィルタ
`publish` か `exopse`	コンテナが公開(publish) もしくは露出(expose) しているポートを指定してフィルタ。 `<port>[/<proto>]` か `<startport-endport>/[<proto>]` として表す
`health`	ヘルスチェック状態に基づきコンテナをフィルタ。 `starting` 、 `healthy` 、 `unhealthy` 、 `none` のどれか
`isolation`	Windows デーモンのみ。 `default` 、 `process` 、 `hyperv` のどれか
`is-task`	サービスに対する "task" かどうかでコンテナをフィルタ。ブール値のオプション（ `true` か `false` ）

label ¶

label フィルタに一致する条件は、コンテナ自身に割り当てられている label か、その label と値です。

次のフィルタは、 color ラベルがどのような値を持っているかに拘わらず、一致するものを表示します。

$ docker ps --filter "label=color"
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
673394ef1d4c        busybox             "top"               47 seconds ago      Up 45 seconds                           nostalgic_shockley
d85756f57265        busybox             "top"               52 seconds ago      Up 51 seconds                           high_albattani

次のフィルタは color ラベルの値が blue に一致するコンテナを表示します。

$ docker ps --filter "label=color=blue"
CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
d85756f57265        busybox             "top"               About a minute ago   Up About a minute                       high_albattani

name ¶

name フィルタはコンテナ名の全て、または一部に一致するコンテナを表示します。

次のフィルタは nostalgic_stallman 文字列を含む名前のコンテナを表示します。

$ docker ps --filter "name=nostalgic_stallman"
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
9b6247364a03        busybox             "top"               2 minutes ago       Up 2 minutes                            nostalgic_stallman

あるいは、一部が一致する場合でも、次のようにフィルタできます。

$ docker ps --filter "name=nostalgic"
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
715ebfcee040        busybox             "top"               3 seconds ago       Up 1 seconds                            i_am_nostalgic
9b6247364a03        busybox             "top"               7 minutes ago       Up 7 minutes                            nostalgic_stallman
673394ef1d4c        busybox             "top"               38 minutes ago      Up 38 minutes                           nostalgic_shockley

exited ¶

exited は、コンテナの終了コードに一致するものでフィルタします。例えば、正常終了したコンテナでフィルタをするには、次のようにします。

$ docker ps -a --filter 'exited=0'
CONTAINER ID        IMAGE             COMMAND                CREATED             STATUS                   PORTS                      NAMES
ea09c3c82f6e        registry:latest   /srv/run.sh            2 weeks ago         Exited (0) 2 weeks ago   127.0.0.1:5000->5000/tcp   desperate_leakey
106ea823fe4e        fedora:latest     /bin/sh -c 'bash -l'   2 weeks ago         Exited (0) 2 weeks ago                              determined_albattani
48ee228c9464        fedora:20         bash                   2 weeks ago         Exited (0) 2 weeks ago                              tender_torvalds

終了シグナルでフィルタ ¶

コンテナの終了ステータスでフィルタできます。例えば、ステータス 137 とは、 SIGKILL(9) による強制停止を意味します。

$ docker ps -a --filter 'exited=137'
CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS                       PORTS               NAMES
b3e1c0ed5bfe        ubuntu:latest       "sleep 1000"           12 seconds ago      Exited (137) 5 seconds ago                       grave_kowalevski
a2eb5558d669        redis:latest        "/entrypoint.sh redi   2 hours ago         Exited (137) 2 hours ago                         sharp_lalande

以下いずれのイベントも、ステータスは 137 です。

コンテナの init プロセスを手動で強制停止
docker kill でコンテナを強制停止
Docker デーモンが全ての実行中コンテナを停止し、再起動

status ¶

status はコンテナの状態が一致するものでフィルタします。フィルタとして使えるのは created 、 restarting 、 running 、 removing 、 paused 、 exited 、 dead です。例えば、 running （実行中）のコンテナでフィルタするには、次のようにします。

$ docker ps --filter status=running
CONTAINER ID        IMAGE                  COMMAND             CREATED             STATUS              PORTS               NAMES
715ebfcee040        busybox                "top"               16 minutes ago      Up 16 minutes                           i_am_nostalgic
d5c976d3c462        busybox                "top"               23 minutes ago      Up 23 minutes                           top
9b6247364a03        busybox                "top"               24 minutes ago      Up 24 minutes                           nostalgic_stallman

paused コンテナでフィルタをするには：

$ docker ps --filter status=paused
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS                      PORTS               NAMES
673394ef1d4c        busybox             "top"               About an hour ago   Up About an hour (Paused)                       nostalgic_shockley

ancestor ¶

ancestor （原型）フィルタとは、コンテナのベースとなったイメージや、その派生に一致するものです。フィルタは以下の形式で指定できます。

イメージ
イメージ:タグ
イメージ:タグ@digest
ショート ID
フル ID

タグ を指定しなければ、 latest タグが使われます。例えば、最新（latest）の ubuntu イメージでフィルタするには：

$ docker ps --filter ancestor=ubuntu
CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
919e1179bdb8        ubuntu-c1           "top"               About a minute ago   Up About a minute                       admiring_lovelace
5d1e4a540723        ubuntu-c2           "top"               About a minute ago   Up About a minute                       admiring_sammet
82a598284012        ubuntu              "top"               3 minutes ago        Up 3 minutes                            sleepy_bose
bab2a34ba363        ubuntu              "top"               3 minutes ago        Up 3 minutes                            focused_yonath

ubuntu-c1 イメージをベースにするコンテナ、この例では ubuntu の子供に一致するものを表示：

$ docker ps --filter ancestor=ubuntu-c1
CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
919e1179bdb8        ubuntu-c1           "top"               About a minute ago   Up About a minute                       admiring_lovelace

ubuntu バージョン 12.04.5 のイメージをベースとするコンテナをフィルタ：

$ docker ps --filter ancestor=ubuntu:12.04.5
CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
82a598284012        ubuntu:12.04.5      "top"               3 minutes ago        Up 3 minutes                            sleepy_bose

レイヤ d0e008c6cf02 あるいはイメージをベースにしたコンテナでフィルタします。

 $ docker ps --filter ancestor=d0e008c6cf02
CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
82a598284012        ubuntu:12.04.5      "top"               3 minutes ago        Up 3 minutes                            sleepy_bose

作成時間 ¶

before¶

before フィルタは、指定したコンテナ ID か名前よりも前に作成したコンテナのみ表示します。たとえば、３つのコンテナを作成しているとします。

$ docker ps
CONTAINER ID        IMAGE       COMMAND       CREATED              STATUS              PORTS              NAMES
9c3527ed70ce        busybox     "top"         14 seconds ago       Up 15 seconds                          desperate_dubinsky
4aace5031105        busybox     "top"         48 seconds ago       Up 49 seconds                          focused_hamilton
6e63f6ff38b0        busybox     "top"         About a minute ago   Up About a minute                      distracted_fermat

before を指定してフィルタリングします。

$ docker ps -f before=9c3527ed70ce
CONTAINER ID        IMAGE       COMMAND       CREATED              STATUS              PORTS              NAMES
4aace5031105        busybox     "top"         About a minute ago   Up About a minute                      focused_hamilton
6e63f6ff38b0        busybox     "top"         About a minute ago   Up About a minute                      distracted_fermat

since¶

since フィルタは、指定したコンテナ ID か名前よりも後に作成したコンテナのみ表示します。次の例は、 before フィルタの時と同じコンテナを表示します。

$ docker ps -f since=6e63f6ff38b0
CONTAINER ID        IMAGE       COMMAND       CREATED             STATUS              PORTS               NAMES
9c3527ed70ce        busybox     "top"         10 minutes ago      Up 10 minutes                           desperate_dubinsky
4aace5031105        busybox     "top"         10 minutes ago      Up 10 minutes                           focused_hamilton

volume ¶

volume フィルタは特定のボリュームをマウントしているコンテナか、特定のパスをマウントしているコンテナを表示します。

$ docker ps --filter volume=remote-volume --format "table {{.ID}}\t{{.Mounts}}"
CONTAINER ID        MOUNTS
9c3527ed70ce        remote-volume

$ docker ps --filter volume=/data --format "table {{.ID}}\t{{.Mounts}}"
CONTAINER ID        MOUNTS
9c3527ed70ce        remote-volume

network ¶

network フィルタは、指定したネットワーク名か id をエンドポイントとして持っているコンテナのみ表示します。

以下のフィルタは接続しているネットワーク名に net1 を含む、全てのコンテナを表示します。

$ docker run -d --net=net1 --name=test1 ubuntu top
$ docker run -d --net=net2 --name=test2 ubuntu top

$ docker ps --filter network=net1
CONTAINER ID        IMAGE       COMMAND       CREATED             STATUS              PORTS               NAMES
9d4893ed80fe        ubuntu      "top"         10 minutes ago      Up 10 minutes                           test1

ネットワーク・フィルタはネットワーク名または ID にマッチします。次の例は net1 ネットワークにアタッチしている全てのコンテナを表示します。ここではネットワーク ID でフィルタします。

$ docker network inspect --format "{{.ID}}" net1
8c0b4110ae930dbe26b258de9bc34a03f98056ed6f27f991d32919bfe401d7c5

$ docker ps --filter network=8c0b4110ae930dbe26b258de9bc34a03f98056ed6f27f991d32919bfe401d7c5
CONTAINER ID        IMAGE       COMMAND       CREATED             STATUS              PORTS               NAMES
9d4893ed80fe        ubuntu      "top"         10 minutes ago      Up 10 minutes                           test1

publish と expose ¶

publish と expose フィルタは、指定したポート番号、ポート範囲、そしてプロトコルで、公開(publish) もしくは露出(expose) しているコンテナのみフィルタして表示します。プロトコルの指定がなければ、デフォルトは tcp です。

以下のフィルタはポート 80 を公開している(publish) フィルタに一致する、全てのコンテナを表示します。

$ docker run -d --publish=80 busybox top
$ docker run -d --expose=8080 busybox top
$ docker ps -a
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS                   NAMES
9833437217a5        busybox             "top"               5 seconds ago       Up 4 seconds        8080/tcp                dreamy_mccarthy
fc7e477723b7        busybox             "top"               50 seconds ago      Up 50 seconds       0.0.0.0:32768->80/tcp   admiring_roentgen
$ docker ps --filter publish=80
CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS                   NAMES
fc7e477723b7        busybox             "top"               About a minute ago   Up About a minute   0.0.0.0:32768->80/tcp   admiring_roentgen

TCP ポート 8000-8080 の範囲で露出している(expose) フィルタに一致する、全てのコンテナを表示します。

$ docker ps --filter expose=8000-8080/tcp
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
9833437217a5        busybox             "top"               21 seconds ago      Up 19 seconds       8080/tcp            dreamy_mccarthy

UDP ポート 80 を露出している(expose) フィルタに一致する、全てのコンテナを表示します。

$ docker ps --filter publish=80/udp
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES

フォーマット ¶

フォーマットのオプション（ --format ）は Go テンプレートを使いコンテナの出力を整形します。

Go テンプレートで置き換え可能な一覧は、次の通りです：

`.ID`	コンテナ ID
`.Image`	イメージ ID
`.Command`	クォートされたコマンド
`.CreatedAt`	コンテナが作成された時間
`.RunningFor`	コンテナが起動してからの時間
`.Ports`	公開しているポート
`.State`	コンテナの状態（例： `created` 、 `running` 、 `exited`）
`.Status`	稼動期間とヘルス・ステータスに関するコンテナのステータス
`.Size`	コンテナのディスク容量
`.Names`	コンテナ名
`.Labels`	コンテナに割り当てられている全てのラベル
`.Label`	コンテナに割り当てられた特定のラベル。例： `{{.Label "com.docker.swarm.cpu"}}`
`.Mounts`	コンテナ内にマウントしているボリューム名
`.Networks`	コンテナに接続しているネットワーク名

ps コマンドに --format オプションを使えば、テンプレートで指定したデータを出力するだけでなく、 table 命令を使うとカラム（例）ヘッダも同様に表示します。

次の例はヘッダを除くテンプレートを使い、実行中の全てのコンテナに対して、 ID と Command エントリを句切って出力します。

$ docker ps --format "{{.ID}}: {{.Command}}"
a87ecb4f327c: /bin/sh -c #(nop) MA
01946d9d34d8: /bin/sh -c #(nop) MA
c1d3b0166030: /bin/sh -c yum -y up
41d50ecd2f57: /bin/sh -c #(nop) MA

実行中のコンテナのラベルを表形式で出力するには、次のようにします。

$ docker ps --format "table {{.ID}}\t{{.Labels}}"
CONTAINER ID        LABELS
a87ecb4f327c        com.docker.swarm.node=ubuntu,com.docker.swarm.storage=ssd
01946d9d34d8
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

親コマンド ¶

コマンド	説明
docker	Docker CLI の基本コマンド

参考

docker ps: https://docs.docker.com/engine/reference/commandline/ps/