一覧表示

記事の内容

概要

container lsは、起動中のコンテナ一覧を確認するコマンドになります。

ls
記述

docker container ls [オプション]

$ docker container ls
CONTAINER ID   IMAGE     COMMAND                  CREATED         STATUS          PORTS                 NAMES
711e7a5aba86   nginx     "/docker-entrypoint.…"   1 minutes ago   Up 2 seconds   0.0.0.0:8080->80/tcp   nginx
1dd77986cc2c   ubuntu    "bash"                   1 minutes ago   Up 2 minutes                          ubuntu

【説明】

列名説明
CONTAINER IDコンテナID(ランダム)
IMAGEイメージ
COMMAND実行プロセス
CREATED作成時間
STATUSステータス
PORTS公開ポート
NAMESコンテナ名(指定しなければランダム)

オプション一覧

オプション説明
-a全てのコンテナを表示
-fコンテナをフィルタリング
-qコンテナIDのみ表示
–format出力形式を指定

-a

aオプションは、起動中以外のコンテナも確認できます。

up : 起動中
Exited : 終了済み

ls -a
記述

docker container ls -a
docker container ls –all

$ docker container ls
CONTAINER ID   IMAGE     COMMAND                  CREATED         STATUS         PORTS                 NAMES
38f48f724614   nginx     "/docker-entrypoint.…"   1 minutes ago   Up 2 minutes   0.0.0.0:8080->80/tcp  nginx
1dd77986cc2c   ubuntu    "bash"                   1 minutes ago   Up 2 minutes                         ubuntu

【nginx停止後】

$ docker container ls --all
CONTAINER ID   IMAGE     COMMAND                  CREATED         STATUS                     PORTS  NAMES
38f48f724614   nginx     "/docker-entrypoint.…"   1 seconds ago   Exited (0) 1 minutes ago          nginx
1dd77986cc2c   ubuntu    "bash"                   1 minutes ago   Up 2 minutes                      ubuntu

-f

fオプションは、指定した条件に基づいてコンテナをフィルタリングできます。

ls -f
記述

docker container ls -f “指定条件”
docker container ls –filter “指定条件”

状態に基づくフィルタリング

【稼働中コンテナ一覧】
$ docker container ls -f "status=running"
CONTAINER ID   IMAGE     COMMAND   CREATED         STATUS         PORTS     NAMES
1dd77986cc2c   ubuntu    "bash"    1 minutes ago   Up 2 minutes             ubuntu

【終了済みコンテナ一覧】
$ docker container ls --filter "status=exited"
CONTAINER ID   IMAGE     COMMAND                  CREATED         STATUS                     PORTS  NAMES
38f48f724614   nginx     "/docker-entrypoint.…"   1 seconds ago   Exited (0) 1 minutes ago          nginx

名前に基づくフィルタリング

$ docker container ls -f "name=new_ubuntu"
CONTAINER ID   IMAGE     COMMAND   CREATED         STATUS         PORTS     NAMES
95a3364cc44b   ubuntu    "bash"    1 minutes ago   Up 2 minutes             new_ubuntu

ラベルに基づくフィルタリング

$ docker ps -f 'label=image_type=test'
CONTAINER ID   IMAGE     COMMAND   CREATED         STATUS         PORTS     NAMES
738bc4c12cc4   ubuntu    "bash"    1 minutes ago   Up 2 minutes             test_ubuntu

【Labelチェック】
$ docker container inspect test_ubuntu
=======
 省略
=======
"Labels": {
 "maintainer": "NGINX Docker Maintainers \u003cdocker-maint@nginx.com\u003e",
 "image_type": "test"
},
=======
 省略
=======

イメージに基づくフィルタリング

$ docker container ls -f "ancestor=ubuntu"
CONTAINER ID   IMAGE     COMMAND   CREATED         STATUS         PORTS     NAMES
1dd77986cc2c   ubuntu    "bash"    1 minutes ago   Up 2 minutes             ubuntu

-q

qオプションは、起動中のコンテナIDを確認できます。

ls -q
記述

docker container ls -q
docker container ls –quiet

$ docker container ls -q
1dd77986cc2c
95a3364cc44b
738bc4c12cc4

–format

formatオプションは、出力形式をカスタマイズして表示することができます。

ls –format
記述

docker container ls –format “フォーマット指定”

$ docker container ls --format "ID:{{.ID}}\t Image:{{.Image}}\t Status:{{.Status}}"
ID:738bc4c12cc4	 Image:nginx	 Status:Up 3 minutes
ID:95a3364cc44b	 Image:ubuntu	 Status:Up 2 minutes
ID:1dd77986cc2c	 Image:ubuntu	 Status:Up 1 minutes
記事の内容
閉じる